Documentación para desarrolladores

Claves de API y permisos

Una clave es el acceso de una persona, limitado a ciertos sitios web y permisos. Hazla tan pequeña como pida el trabajo.

Dos tipos de claves

Clave Dónde se crea Cubre Prefijo
Clave de espacio de trabajo Settings → Developer access → New key todos los sitios web, o los que marques mr_ws_…
Clave de sitio web se crea cuando se conecta el plugin de WordPress un sitio web mr_site_…

Settings es para tus propios sitios web. Para un espacio de trabajo que alguien comparte contigo, abre sus ajustes desde ⋯ en su grupo de la lista Sitios web (solo si puedes cambiarlos). Usa una clave de espacio de trabajo para tus propios scripts y asistentes, y marca solo los sitios web que necesite. Los dos tipos aparecen en Settings → Developer access con su último uso, para que veas cuáles no se usan. Cada clave se muestra una sola vez y tiene un límite de 1.200 solicitudes por hora.

Permisos

Cuando creas o editas una clave, la app muestra los permisos en What it may do, con la etiqueta que aparece aquí.

Permiso Etiqueta en la app Permite
sites:read Read website details and scores resumen del sitio web, puntuaciones e historial, resultados de velocidad, el portafolio de todos los sitios web de la clave, auditorías
pages:read Read pages and findings páginas rastreadas, hallazgos por página e historial de la página
issues:read Read issues and actions problemas con evidencia, explicaciones de IA, valores sugeridos, acciones priorizadas
search:read Read search performance resumen y filas de Search Console, temas, palabras clave, competidores y huecos de palabras clave, backlinks y objetivos de outreach
analytics:read Read Google Analytics conversions and revenue conversiones e ingresos por página de destino de Google Analytics (GA4) del sitio web
ai:read Read AI visibility and AI readiness visibilidad en IA, brechas de respuesta, acceso de los rastreadores de IA, llms.txt y resultados de navegación por agentes
content:write Send content and change alerts lo usa el plugin de WordPress para enviar contenido; no es para tus propios scripts
issues:recheck Start rechecks poner en cola una revisión, o volver a ejecutar la prueba de navegación por agentes para una página
audits:run Start audits iniciar una auditoría completa (leer las auditorías necesita sites:read)
actions:apply Apply approved fixes to the website aprobar cambios de título SEO, descripción, canónica o noindex, llms.txt y reglas para rastreadores de IA, escritos mediante el conector de WordPress; cambiar el estado y la nota de un objetivo de outreach; elegir, descartar o añadir competidores

La clave que usa el plugin de WordPress lleva content:write más sites:read y pages:read, para que también pueda leer las puntuaciones de este sitio web en sus propias pantallas.

Cambiar una clave

Edit en una clave cambia su nombre, sus permisos y, en una clave de espacio de trabajo, sus sitios web. La clave en sí sigue igual, así que no hace falta una copia nueva. Una clave de sitio web se queda en su sitio web. Una clave que usa el plugin de WordPress conserva su nombre y los permisos que necesita. Las claves creadas antes de que existiera un permiso (por ejemplo ai:read, audits:run o analytics:read) no lo tienen: añádelo con Edit.

Tokens OAuth

Cuando un cliente MCP te pide iniciar sesión en lugar de usar una clave (ChatGPT, por ejemplo), apruebas su acceso una vez. Solo puede pedir estos permisos: sites:read, pages:read, issues:read, search:read, analytics:read, ai:read e issues:recheck. Así puede leer y poner revisiones en cola, pero nunca iniciar auditorías, escribir cambios en tu sitio web, actualizar objetivos de outreach ni cambiar competidores (audits:run, actions:apply y content:write nunca se conceden de esta forma).

Detrás del token hay una clave de espacio de trabajo con el nombre del cliente, por ejemplo “ChatGPT (OAuth)”. Aparece en la misma lista de Settings → Developer access y se revoca de la misma forma. Los tokens de acceso duran una hora y el cliente los renueva; si no usas el cliente durante 30 días, te pide iniciar sesión de nuevo. Una conexión hecha antes de que existiera analytics:read no lo tiene: vuelve a conectar el cliente para añadirlo.

Revocar

Settings → Developer access → Revoke en la clave. Desde ese momento, las solicitudes con ella fallan con 401. La clave del plugin de WordPress también se puede revocar allí; el plugin muestra entonces “desconectado” y deja de enviar.

Preguntas frecuentes

Perdí una clave. ¿Puedo volver a verla?

No. MonoRanks solo guarda una huella. Revócala y crea una nueva.

¿Puedo dar más acceso a una clave que ya existe?

Sí. Edit en la clave cambia su nombre, sus permisos y sus sitios web. La clave en sí sigue igual, así que nada de lo que la usa necesita una copia nueva.

¿Quién puede crear claves?

Todos, para sus propios sitios web. En un espacio de trabajo compartido, solo el dueño y los miembros que ven todos los sitios. Una clave nunca llega más allá de lo que ve quien la creó, y deja de funcionar si esa persona pasa a ser lector de cliente o deja el espacio de trabajo.