Usar la herramienta de línea de comandos

El comando searcherries lee tus datos de Searcherries en un terminal: visibilidad en IA, respuestas de IA almacenadas con sus valoraciones, competidores, URL y dominios citados, datos de Google Search Console y Bing Webmaster Tools, tráfico de IA de GA4 y el plan de acción. Imprime tablas para que las leas tú, o JSON para scripts y para agentes de programación con IA como Claude Code y Codex.

La herramienta es de solo lectura. Llama a la API REST, así que devuelve los mismos datos almacenados y sigue las mismas reglas de plan: el plan gratuito lee los proyectos, el resumen, el rendimiento de búsqueda, el tráfico de IA y el plan de acción; las respuestas de IA, los competidores y las citas requieren Starter o Pro, y un periodo de prueba activo cuenta.

Instalar

Necesitas Node.js 20 o posterior. Instala la herramienta una vez:

npm install -g searcherries

Para usarla sin instalarla, escribe npx delante de cada comando, por ejemplo npx searcherries projects.

Iniciar sesión

Abre MCP en Searcherries, ve a la pestaña Other clients (Otros clientes) y crea un token de acceso. Cópialo en ese momento; solo se muestra una vez.
Ejecuta searcherries login y pega el token cuando te lo pida. El token no se ve mientras lo pegas.
Ejecuta searcherries projects. Aparecen tus proyectos con su estado y sus fuentes conectadas.

La herramienta comprueba el token antes de guardarlo, en un archivo que solo puede leer tu usuario. searcherries logout borra ese archivo; el token sigue funcionando hasta que lo revoques en la página de MCP. En una tarea programada o en CI, define la variable de entorno SEARCHERRIES_TOKEN en lugar de iniciar sesión.

Comandos

Comando	Devuelve
`projects`	Tus proyectos con estado, plan, última comprobación y fuentes conectadas.
`summary`	Un resumen compacto de un proyecto: visibilidad en IA, preguntas, competidores, dominios citados, búsqueda, tráfico de IA y conexiones.
`answers`	Respuestas de IA almacenadas con la prominencia con que nombran la marca, el sentimiento, las alertas y las URL citadas.
`search`	Datos de Google Search Console o Bing Webmaster Tools: totales, principales consultas y páginas, oportunidades, tendencias, consultas en forma de pregunta, cifras diarias y mensuales.
`competitors`	Las marcas que nombran las plataformas de IA: la clasificación, una marca en detalle o el historial mensual.
`citations`	Las URL o los dominios que citan las respuestas de IA.
`traffic`	Tráfico de GA4 desde asistentes de IA y AI Overviews: fuentes, páginas de destino, cifras diarias y mensuales.
`plan`	Próximos pasos priorizados con evidencia fechada, para el responsable del negocio, marketing o SEO.
`api`	Cualquier endpoint de la API REST, impreso como JSON.
`status`	Qué token está en uso y cuántas peticiones quedan en este minuto.

Los comandos que leen un proyecto lo reciben como primer argumento: el id numérico, el nombre de la marca, el dominio o parte de ellos, como acme, acme.com o 123. Omítelo cuando tu cuenta tenga un solo proyecto. Pon entre comillas un nombre que contenga espacios.

searcherries <comando> --help muestra las opciones de un comando y sus valores admitidos. Coinciden con los parámetros de la referencia de endpoints, escritos con guiones: --prominence-max envía prominence_max.

Ejemplos

Encuentra las preguntas en las que las respuestas de IA no mencionan tu marca:

searcherries answers acme --prominence-max 1

Lee las respuestas negativas y las que señalan desventajas, con el texto de la respuesta y la frase que respalda cada alerta:

searcherries answers acme --only-flagged --include-answer-text

Mira cómo aparece un competidor y después la clasificación mensual:

searcherries competitors acme --competitor rival
searcherries competitors acme --dataset history

Lista las consultas de Google con muchas impresiones y pocos clics en 90 días:

searcherries search acme --dataset opportunities --period 90d

Obtén el plan de acción para un perfil SEO en JSON:

searcherries plan acme --audience seo --json

Scripts y agentes de IA

--json imprime la respuesta de la API sin cambios. Los errores van a la salida de errores (stderr), así que un script que lee JSON de la salida estándar nunca recibe un mensaje de error en su lugar. --all lee todas las páginas de una lista e imprime las filas como una sola respuesta.

Cuando se alcanza el límite de peticiones, la herramienta espera y vuelve a intentarlo si la espera es de un minuto o menos. Su código de salida indica a un script qué ha pasado:

Código	Significado
`0`	El comando ha funcionado.
`1`	Ha fallado la API o la red, no se ha encontrado el proyecto o se ha rechazado un parámetro.
`2`	El comando o una opción están mal escritos.
`3`	No hay ninguna sesión iniciada o se ha rechazado el token.
`4`	El comando requiere un plan Starter o Pro.

Los agentes de programación con IA pueden ejecutar la herramienta en el terminal que ya usan. Pide al agente que ejecute searcherries <comando> --json y lea la salida, o conecta el servidor MCP si tu asistente admite MCP; los dos leen los mismos datos.

Privacidad

El token lee los datos de la cuenta de Searcherries que lo creó. La herramienta solo lo envía a app.searcherries.com, por HTTPS. Revoca el token en la página de MCP si pierdes el ordenador o compartes el archivo por error.

El código fuente es público en GitHub.