SEO Perception

Consola de búsqueda, rastreo y tareas pendientes de SEO, solo lectura dentro de Cursor y Claude.

Servidor MCP alojado

npx add-mcp 'https://seoperception.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

SEO Perception

Search Console, rastreo y tus tareas SEO pendientes — dentro de Cursor y Claude.

SEO Perception ya almacena datos semanales de Search Console, el rastreo y Possibilities — una lista priorizada de tareas para cada URL. MCP permite que Cursor y Claude lean ese mismo espacio de trabajo y redacten la siguiente edición. Las herramientas son de solo lectura y nunca llaman a Google.

Endpoint alojado

npx add-mcp 'https://seoperception.com/mcp'

URL: https://seoperception.com/mcp
Autorización: Bearer <your MCP token>
Planes: Starter, Pro, Business o Enterprise. Crea un token después de iniciar sesión.

Cursor y Claude pueden usar OAuth (consentimiento del navegador) cuando el cliente sea compatible con Connect. También puedes crear un token de acceso personal en Cuenta → MCP. Cada secreto se muestra una sola vez. Guárdalo como SEOPERCEPTION_MCP_TOKEN.

Cursor

Añade esto a ~/.cursor/mcp.json o al .cursor/mcp.json del proyecto:

{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SEOPERCEPTION_MCP_TOKEN}"
      }
    }
  }
}

Otros clientes MCP

Claude Desktop, Claude Code, VS Code y otros usan el mismo endpoint remoto. Si un cliente solo admite MCP local, usa la opción remota o de proxy de ese cliente con la URL y el token indicados arriba.

Lo que el editor está leyendo

MCP no es una herramienta SEO simplificada. Es el producto que ya usas, abierto desde Cursor o Claude.

Los datos

Datos semanales de Search Console, el rastreo y el historial de páginas. Las consultas permanecen vinculadas a la URL. MCP lee lo que ya está almacenado. No llama a Google.

El espacio de trabajo

Las mismas páginas, consultas y evidencia que revisas en SEO Perception, incluso en la página en vivo con la superposición del sitio.

La lista de tareas

Possibilities es la lista priorizada: qué hacer, en qué URL y por qué. MCP devuelve esa lista para que el editor pueda redactar el cambio.

Límite de datos

MCP nunca vuelve a consultar Google Search Console ni URL Inspection.
Las respuestas usan datos que SEO Perception ya ha recopilado para tus sitios.
Tu cliente MCP puede enviar la evidencia devuelta a su proveedor de modelos. Trata los resultados como análisis sensibles del sitio.
Solo planes de pago (Starter, Pro, Business, Enterprise).

Herramientas

Solo las herramientas Disponibles aparecen en tools/list.

Disponibles

Herramienta	Nombre	Estado	Qué hace
`seoperception_list_sites`	Listar sitios	Disponible	Lista los sitios propios con frescura almacenada de GSC y rastreo.
`seoperception_get_site_overview`	Resumen del sitio	Disponible	Resume el rendimiento de búsqueda almacenado, páginas principales, consultas y impulso de posiciones.
`seoperception_search_queries`	Consultas de búsqueda	Disponible	Busca y filtra evidencia almacenada de consultas por coincidencia de contenido, banda de posición, impresiones, página de destino, CTR e intención. Los filtros de contenido usan solo filas de coincidencia almacenadas.
`seoperception_list_opportunities`	Oportunidades SEO	Disponible	Lista posibilidades de rastreo y Search Console acotadas y respaldadas por evidencia.
`seoperception_find_cannibalization`	Canibalización de palabras clave	Disponible	Encuentra conflictos de consultas almacenados y la página preferida determinista.
`seoperception_find_content_gaps`	Brechas de contenido y snippets	Disponible	Encuentra oportunidades almacenadas de bajo CTR, consultas faltantes, título/snippet, preguntas y actualización.
`seoperception_suggest_internal_links`	Sugerencias de enlaces internos	Disponible	Devuelve oportunidades almacenadas de destino y texto de anclaje sin rastrear ni probar URLs.
`seoperception_get_page_diagnostics`	Diagnóstico de página	Disponible	Combina metadatos de rastreo de una página, tendencias GSC almacenadas, consultas principales y posibilidades.
`seoperception_find_content_decay`	Decaimiento de contenido	Disponible	Detecta descensos sostenidos almacenados de clics y posiciones en filas abiertas candidatas a actualización. Un resultado vacío significa que aún no hay ninguna almacenada.

Planificadas

Herramienta	Nombre	Estado	Qué hace
`seoperception_compare_periods`	Comparación de períodos	Planificada	Compara períodos semanales almacenados explícitos con deltas deterministas.
`seoperception_get_geo_breakdown`	Desglose por país y dispositivo	Planificada	Lee datos almacenados de país/dispositivo para sitios Business y Enterprise.
`seoperception_generate_report`	Informe alojado	Planificada	Crea un artefacto de análisis acotado y compartible.

Excluidas permanentemente

Herramienta	Nombre	Estado	Qué hace
`live_gsc_query_or_inspection`	Llamadas en vivo a Google	Excluida	Las consultas directas a GSC, URL Inspection, recopilación y OAuth de Google están excluidas permanentemente.
`mutations_and_refreshes`	Mutaciones y actualizaciones	Excluidas	Recrawls, escrituras de indexación, actualizaciones de problemas, actualizaciones de PSI y generación con LLM están excluidas.

Ejemplos de prompts

Prefiere la evidencia observada de los resultados de las herramientas antes que recomendaciones inventadas.

Listar sitios. «Lista mis sitios de SEO Perception y dime qué datos son los más recientes.»
Resumen del sitio. «Resume las mayores ganancias y pérdidas de mi sitio usando datos almacenados.»
Consultas de búsqueda. «Encuentra consultas sin marca en posiciones 5–20 con al menos 50 impresiones que falten en su página de destino.»
Oportunidades SEO. «Muestra las oportunidades SEO abiertas de mayor prioridad y explica la evidencia.»
Canibalización de palabras clave. «Encuentra canibalización de palabras clave y recomienda qué página debería ser la preferida.»
Brechas de contenido y snippets. «Encuentra las mayores brechas de contenido y snippets, y sugiere reescrituras que coincidan con las palabras clave perdedoras.»
Sugerencias de enlaces internos. «Sugiere enlaces internos y texto de anclaje natural para páginas con potencial de posicionamiento.»
Diagnóstico de página. «Diagnostica /page1/ desde el estado de rastreo, consultas principales y oportunidades, y dime qué reescribir primero.»
Decaimiento de contenido. «¿Qué páginas muestran un decaimiento de contenido significativo?»

Límites de velocidad

POST /mcp: 60/min por IP antes de la autenticación, 120/min por token después.
Llamadas a herramientas: 30/min por combinación de usuario, token y sitio.
Creación de tokens: 5 intentos por usuario por hora.

Seguridad

Nunca pongas tu contraseña de inicio de sesión o cookie de sesión en una configuración de cliente MCP. Gestiona los tokens en Cuenta → MCP.

Solución de problemas

401: crea un nuevo token en Cuenta → MCP y actualiza la variable de entorno.
403 paid_plan_required: actualiza el plan y luego crea un token.
429: espera el tiempo de reintento indicado en la respuesta.
406: envía Accept: application/json, text/event-stream.
Las listas vacías suelen significar que aún no hay datos almacenados para ese sitio.

Preguntas frecuentes

¿Qué es un servidor MCP de SEO?

Un servidor MCP de SEO permite que Cursor o Claude lean tus datos almacenados de Search Console, el rastreo y las Possibilities abiertas, y luego redacten la siguiente edición en una URL.

¿MCP es un conjunto de datos separado?

No. MCP lee los mismos datos semanales de Search Console, el rastreo y la lista de Possibilities que ya usas en SEO Perception. No existe una segunda copia de tu sitio.

¿SEO Perception MCP llama a Google Search Console en vivo?

No. Las herramientas MCP leen datos semanales almacenados de Search Console y evidencia de rastreo ya recopilada en SEO Perception. La recopilación ocurre en la sincronización del producto, no dentro de la llamada a la herramienta MCP.

¿Qué clientes MCP son compatibles?

Cualquier cliente MCP que pueda llamar a un endpoint HTTP remoto con un token Bearer funciona, incluidos Cursor, Claude Desktop, Claude Code y VS Code con una extensión MCP.

¿Necesito un plan de pago?

Sí. Los tokens de acceso personal de MCP y el endpoint POST /mcp requieren Starter, Pro, Business o Enterprise. Crea tokens en Cuenta → MCP después de actualizar el plan.

Guías

Esta página cubre configuración, tokens y el catálogo de herramientas. Las publicaciones a continuación explican flujos de trabajo, comparaciones y cómo ejecutar SEO desde Cursor con evidencia almacenada.

Siguiente paso

MCP está incluido en todos los planes de pago. Crea un token personal en Cuenta → MCP, añade la configuración anterior y pega uno de los prompts de ejemplo.