Referencia de herramientas MCP

Esta referencia está pensada para usuarios que configuran un cliente MCP o revisan qué datos de Searcherries recupera su asistente. El servidor expone dos herramientas de solo lectura: list-projects y get-project-data.

Conéctate a https://app.searcherries.com/mcp/searcherries con OAuth autorizado o con un token de acceso personal. Consulta las opciones de conexión.

list-projects

Lista los proyectos que pertenecen a la cuenta autenticada, sus fuentes conectadas e indicadores de los datos almacenados disponibles.

Esta herramienta no recibe argumentos de selección de proyecto. Llámala primero para obtener un ID de proyecto y confirmar que la marca solicitada está disponible.

Que un proyecto aparezca en la respuesta no significa que tenga datos en todas las secciones. Un proyecto nuevo puede no tener comprobaciones completadas, y una fuente de analítica sin conectar no puede ofrecer una instantánea de rendimiento.

get-project-data

Devuelve los conjuntos de datos seleccionados de un proyecto.

Argumento	Obligatorio	Significado
`project_id`	Sí	ID entero positivo obtenido de `list-projects`.
`sections`	No	Array de identificadores de conjuntos de datos. Omítelo para solicitar todas las secciones disponibles.
`limit`	No	Filas o instantáneas por sección paginada, de 1 a 100. Por defecto: 25.
`offset`	No	Filas que se omiten en cada sección paginada solicitada, de 0 a 100.000. Por defecto: 0.

Ejemplo de argumentos de la herramienta:

{
  "project_id": 123,
  "sections": [
    "ai_visibility.metrics",
    "competitors",
    "citations.urls"
  ],
  "limit": 25,
  "offset": 0
}

Sustituye 123 por un ID devuelto para tu cuenta. Es un valor ilustrativo, no un proyecto de demostración compartido.

Identificadores de conjuntos de datos

Identificador	Contenido
`ai_visibility.metrics`	Métricas de visibilidad del proyecto almacenadas.
`ai_visibility.topics`	Registros de temas almacenados, cuando el proyecto los tiene.
`ai_visibility.prompts`	Preguntas de clientes y su información de seguimiento.
`ai_visibility.mentions`	Registros recopilados de respuestas de IA y menciones.
`citations.top_sites`	Instantáneas almacenadas de las fuentes o dominios principales.
`citations.urls`	URL de fuentes individuales registradas y sus metadatos asociados.
`competitors`	Instantáneas de competidores y métricas por plataforma almacenadas.
`recommendations`	Registros de recomendaciones almacenados, cuando existen.
`trust_mentions`	Menciones de marca históricas encontradas en plataformas de reseñas y comunidades. Estos datos ya no se recopilan, así que los proyectos más recientes devuelven un conjunto vacío.
`ga4.ai_traffic`	Instantáneas almacenadas de tráfico de IA de GA4.
`google_search_console.performance`	Instantáneas almacenadas del rendimiento en la búsqueda de Google.
`bing_webmaster_tools.performance`	Instantáneas almacenadas del rendimiento en la búsqueda de Bing.

Algunos identificadores conservan el acceso a datos históricos y no tienen una página equivalente en la aplicación. Los registros de recomendaciones almacenados no son lo mismo que tu historial de sesiones de Wizard.

Paginación

Las secciones paginadas devuelven offset, limit, returned, total y has_more. Cuando has_more es true, solicita la página siguiente con un offset mayor. Solicitar una sola sección facilita la paginación cuando los distintos conjuntos de datos tienen longitudes diferentes.

En las instantáneas de analítica, el límite cuenta instantáneas, no necesariamente las filas individuales de consultas o páginas anidadas dentro de cada una. Revisa las fechas y la forma de la respuesta antes de combinar resultados.

Frescura y errores

La respuesta identifica los datos como datos almacenados de solo lectura. Comprueba la hora de actualización y el periodo de cada conjunto de datos en lugar de suponer que todas las secciones cubren las mismas fechas.

Un error de autenticación requiere volver a conectar. Un error de proyecto no encontrado puede significar un ID incorrecto o un proyecto no disponible para la cuenta autorizada. Los nombres de sección desconocidos y los valores de paginación fuera de rango se rechazan.

Estas herramientas no actualizan servicios externos ni modifican proyectos. Más información sobre las actualizaciones de datos.