Documentación para desarrolladores
Servidor MCP
MonoRanks habla el Model Context Protocol. Apunta un asistente a una URL y podrá leer tus auditorías y actuar sobre ellas.
Endpoint
https://app.monoranks.com/api/mcp
Streamable HTTP sobre POST, respuestas JSON, sin sesión que mantener. Envía una clave como Authorization: Bearer mr_ws_… (una clave de sitio web mr_site_… también funciona), o deja que el cliente inicie sesión con OAuth 2.1 (abajo). Los permisos, el límite por hora (1.200 llamadas por clave) y el acceso del dueño de la clave se comprueban en cada llamada a una herramienta, igual que en la API REST.
Conectar
Claude Code
claude mcp add --transport http monoranks https://app.monoranks.com/api/mcp \
--header "Authorization: Bearer mr_ws_…"
Claude.ai y Claude Desktop: añade la URL de arriba como conector personalizado (sin verificar: los nombres de los menús de esas apps cambian a menudo). Si el cliente te deja poner una cabecera, envía la clave como cabecera bearer; si no, te pedirá iniciar sesión con OAuth.
ChatGPT y otros clientes OAuth: añade https://app.monoranks.com/api/mcp como servidor MCP. Sin clave, el endpoint responde 401 y remite al cliente a /.well-known/oauth-protected-resource. El cliente se registra (/api/oauth/register), te envía a iniciar sesión y aprobar el acceso (/oauth/authorize, con PKCE) y obtiene su token en /api/oauth/token. Solo puede pedir los permisos de lectura e issues:recheck; audits:run y actions:apply nunca se conceden de esta forma, así que start_audit, las herramientas apply y update_outreach_target necesitan una clave. Consulta Claves de API y permisos.
Herramientas
Leer
| Herramienta | Qué hace | Permiso |
|---|---|---|
list_sites |
Los sitios web que cubre la clave, con sus ids | sites:read |
portfolio |
Todos los sitios web en una llamada: puntuaciones y su cambio, problemas, acciones, última y próxima auditoría, y clics de Search Console (con search:read) |
sites:read |
site_summary |
Puntuaciones, última auditoría, problemas abiertos, acceso a WordPress y lo recientes que son los datos de cada conexión | sites:read |
speed_results |
Velocidad por página probada: prueba de laboratorio y datos de visitantes reales | sites:read |
audit_status |
Las últimas auditorías, o una auditoría por audit_id, con las páginas rastreadas y el presupuesto de páginas |
sites:read |
list_issues |
Problemas, la misma lista que la pantalla Issues | issues:read |
issue_detail |
Un problema con páginas, evidencia, explicación y nuevos valores sugeridos (de 100 en 100, suggestions_offset para más) |
issues:read |
list_actions |
Acciones priorizadas con la ganancia estimada y cuánto tiempo lleva abierta cada una | issues:read |
page_findings |
Hallazgos de una página, por id o dirección | pages:read |
page_history |
Qué cambió en una página de una auditoría o revisión a la siguiente, por id o dirección | pages:read |
search_summary |
Totales de Search Console, páginas y consultas principales | search:read |
search_rows |
Filas de Search Console de un rango de fechas, por consulta, página, consulta y página, o día (vuelve a enviar nextCursor como cursor; la exportación CSV solo está en la API REST) |
search:read |
near_page_one |
Tus pares de consulta y página que están justo detrás de la primera página (posiciones 8 a 20 por defecto), con más impresiones primero, y los clics extra que podría dar una posición top 3 | search:read |
topics |
Las páginas del sitio web agrupadas en temas, con clics, consultas principales y si cada tema es fuerte, débil o no recibe clics | search:read |
analytics_pages |
Conversiones e ingresos por página de destino de Google Analytics (GA4), junto a los clics de Search Console | analytics:read |
keywords |
Las palabras clave tal como las lista la pantalla Keywords, con demanda, posición, oportunidad y la revisión de relevancia; sin las sugerencias fuera de tema | search:read |
competitors |
El conjunto de competidores con su puntuación de coincidencia, la revisión con IA de cada sugerencia, cuáles marcan las brechas, palabras clave compartidas, palabras clave en las que están por encima de ti, fuerza y visibilidad | search:read |
competitor_gaps |
La posición de cada competidor y la tuya por palabra clave (gaps, content, lost, lead). Cada fila también indica la página en la que posiciona cada competidor. | search:read |
content_ideas |
Las brechas de palabras clave agrupadas en temas, con la mayor oportunidad primero: si conviene crear una página nueva o ampliar una, tus páginas que ya están en el tema, las páginas de competidores que posicionan y las palabras clave principales | search:read |
backlinks |
El resumen de backlinks y los dominios de referencia de una vista (all, new, lost, review, strong) | search:read |
list_outreach_targets |
Páginas y sitios a los que vale la pena pedir un enlace o una mención, ordenados, con el motivo y su estado | search:read |
ai_visibility |
Lo que respondieron los asistentes de IA a tus preguntas seguidas, por semana, con las páginas que cita cada respuesta | ai:read |
answer_gaps |
Preguntas en las que las respuestas de IA nombran otros sitios web pero no el tuyo | ai:read |
geo_access |
Acceso de los rastreadores de IA, llms.txt y señales de entidad y preparación para agentes de la última auditoría | ai:read |
llms_txt |
El llms.txt publicado y un borrador listo para publicar | ai:read |
ai_crawler_rules |
Lo que robots.txt dice ahora a cada rastreador de IA | ai:read |
agentic_results |
Resultados de navegación por agentes con lo que hay que corregir, o una nueva ejecución por job_id |
ai:read |
Actuar
| Herramienta | Qué hace | Permiso |
|---|---|---|
recheck |
Pone en cola una revisión de un problema | issues:recheck |
run_agentic_check |
Vuelve a ejecutar la prueba de navegación por agentes para una página | issues:recheck |
start_audit |
Inicia ahora una auditoría completa, con un presupuesto de páginas opcional | audits:run |
apply |
Aprueba los nuevos títulos SEO, descripciones, canónicas o noindex de una acción y los escribe en WordPress | actions:apply |
apply_llms_txt |
Aprueba un nuevo llms.txt y lo escribe en WordPress | actions:apply |
apply_ai_crawler_rules |
Aprueba reglas de permitir o bloquear para rastreadores de IA y las escribe en robots.txt | actions:apply |
update_competitors |
Elige, descarta o añade un competidor; elegir o añadir consulta sus brechas de palabras clave dentro de tu límite de datos | actions:apply |
update_outreach_target |
Cambia el estado (por contactar, contactado, añadido, rechazado) y la nota de un objetivo de outreach | actions:apply |
Ejemplo de conversación
“¿Cuál de mis sitios web perdió más clics este mes y cuál es su acción principal?”
El asistente llama a portfolio una vez, elige el sitio web con la mayor caída, luego llama a list_actions para ese sitio y responde con la acción y su ganancia estimada. Si dices “aplícala”, lee los valores sugeridos con issue_detail, llama a apply, y el cambio aparece en la actividad de la app con Undo.
Preguntas frecuentes
¿Qué clientes funcionan?
Cualquiera que admita MCP sobre Streamable HTTP: Claude Code, Claude.ai, Claude Desktop, ChatGPT (conectores en modo desarrollador), Cursor, Windsurf y otros.
¿Puede el asistente romper mi sitio?
Solo tres herramientas cambian tu sitio web: apply, apply_llms_txt y apply_ai_crawler_rules. Siguen las mismas reglas que los botones de la app: solo sitios de WordPress conectados, el dueño de la clave queda registrado como quien aprueba, una comprobación después y Undo en la app durante 30 días. recheck, run_agentic_check y start_audit solo vuelven a leer tu sitio web. update_outreach_target y update_competitors solo cambian datos dentro de MonoRanks: el estado y la nota de un objetivo, o qué competidores sigues.
¿Por qué ChatGPT no necesita una clave?
Los clientes que descubren el inicio de sesión por sí mismos usan OAuth 2.1: te envían a iniciar sesión y aprobar el acceso una vez, y preguntan dónde conectar si puedes abrir más que tus propios sitios web. El token que reciben equivale a una clave de espacio de trabajo con los permisos de lectura y las revisiones que aprobaste, nunca auditorías ni escrituras. Aparece en Settings → Developer access y se puede revocar allí.