Saltar al contenido
Searcherries
Iniciar sesiónPruébalo gratis

Conectar n8n a Searcherries

Añade Searcherries a un AI Agent de n8n para que un flujo de trabajo responda preguntas sobre tu visibilidad en IA, tus competidores, las citas y los datos conectados de Search Console, Bing Webmaster Tools y GA4, o te envíe un informe programado construido con esos datos.

Necesitas acceso a un plan de pago en Searcherries (un periodo de prueba activo cuenta) con un proyecto que haya terminado su primera comprobación, y n8n Cloud o un n8n autoalojado con el nodo MCP Client Tool. El AI Agent también necesita una credencial de modelo de chat, por ejemplo OpenAI, Anthropic o Google Gemini.

Crear un token de acceso

n8n se conecta a Searcherries con un token de acceso personal. El inicio de sesión en el navegador (OAuth2) no está disponible para n8n; el token es la forma de conectar.

  1. Inicia sesión en Searcherries y abre MCP.
  2. Abre la pestaña Other clients (Otros clientes) y busca Access tokens (Tokens de acceso).
  3. Escribe un nombre como «n8n» y selecciona Create token (Crear token).
  4. Copia el token de inmediato. Se muestra una sola vez.

La guía de tokens explica la caducidad, el reemplazo y la revocación.

Añadir el nodo MCP Client Tool

  1. Abre un flujo de trabajo en n8n, añade un nodo AI Agent y conecta un modelo de chat a su entrada Chat Model.
  2. Selecciona el + de la entrada Tool del agente y añade MCP Client Tool.
  3. En Endpoint, pega la URL del servidor de abajo.
  4. En Server Transport, elige HTTP Streamable.
  5. En Authentication, elige Bearer Auth, crea una credencial nueva y pega el token.
  6. Deja Tools to Include en All.
https://app.searcherries.com/mcp/searcherries

Una vez guardada la credencial, el nodo carga las nueve herramientas de Searcherries. Todas son de solo lectura: el agente lee datos que Searcherries ya ha guardado y no puede cambiar proyectos ni actualizar informes. Más información sobre el acceso a datos por MCP y los calendarios de actualización de datos.

Probarlo en un chat

Añade un Chat Trigger delante del AI Agent, abre el chat y pregunta:

Lista mis proyectos de Searcherries.

Comprueba que los proyectos pertenecen a la cuenta que creó el token. Después pregunta por uno de ellos por su nombre:

Con Searcherries, ¿qué preguntas de clientes responden los asistentes de IA sin nombrarnos y qué competidores nombran en su lugar? Incluye las fechas de los informes.

Ejemplo: informe semanal de visibilidad en IA

Este flujo de trabajo envía por correo o publica un informe breve cada lunes por la mañana: Schedule Trigger → AI Agent (modelo de chat + MCP Client Tool de Searcherries) → Send Email o Slack.

  1. Schedule Trigger: pon Trigger Interval en Weeks, cada 1 semana, el lunes a las 08:00.
  2. AI Agent: conecta el modelo de chat y el MCP Client Tool de Searcherries. En Source for Prompt elige Define below y pega el prompt de la sección siguiente con el nombre de tu marca. En Options, añade un System Message: «Eres un analista de marketing que informa sobre visibilidad en IA. Usa solo los datos que devuelven las herramientas de Searcherries, conserva las fechas de los informes y escribe texto plano sin encabezados markdown».
  3. Send Email o Slack: conéctalo después del agente y usa {{ $json.output }} como texto: el campo Text de Send Email (con Email Format en Text) o Message Text de la operación Send a message de Slack.

Prompt para el AI Agent:

Escribe el informe semanal de visibilidad en IA del proyecto de Searcherries «NOMBRE DE LA MARCA».

Pasos:
1. Llama a list-projects y usa el proyecto cuyo nombre de marca coincida.
2. Llama a get-project-summary con ese project_id.
3. Llama a get-competitors con dataset "ranking".
4. Llama a get-ai-answers con prominence_max 1 para listar las preguntas de clientes en las que nuestra marca falta en las respuestas.
5. Llama a get-citations con group_by "domain" para ver en qué fuentes se apoyan las plataformas de IA.

Después escribe el informe en texto plano, en menos de 300 palabras, con estas secciones: Visibilidad (puntuación, cambio respecto al periodo anterior, cuota nombrada), Competidores (las tres marcas que más han subido y qué dicen de ellas las plataformas), Huecos (las tres preguntas de clientes en las que faltamos y los dominios citados para ellas), Próxima semana (tres acciones concretas, cada una ligada a un hallazgo). Incluye las fechas de los informes. Usa solo datos devueltos por las herramientas de Searcherries e indícalo cuando una sección no tenga datos.

Si no funciona

  • 401 Unauthorized cuando el nodo carga las herramientas o el agente llama a una: el token se revocó o ha caducado. Crea un token nuevo en la página de MCP y actualiza la credencial Bearer Auth.
  • La lista de proyectos está vacía: la cuenta que creó el token aún no tiene ningún proyecto, o el token pertenece a otra cuenta de Searcherries distinta de la que esperabas. Un proyecto cuya primera comprobación sigue en marcha aparece en la lista, pero no tiene respuestas hasta que termina.
  • El nodo no puede cargar la lista de herramientas: revisa la URL completa del servidor, incluido /mcp/searcherries, y que Server Transport esté en HTTP Streamable.

Para cualquier otra cosa, contacta con soporte.

¿Necesitas ayuda? Contactar con soporte