Pular para o conteúdo
Searcherries
EntrarComece grátis

Conectar o n8n à Searcherries

Adicione a Searcherries a um AI Agent no n8n para que um fluxo de trabalho responda a perguntas sobre a sua visibilidade em IA, os seus concorrentes, as citações e os dados conectados do Search Console, do Bing Webmaster Tools e do GA4, ou envie a você um relatório agendado montado com esses dados.

Você precisa de uma conta da Searcherries com um projeto (o plano grátis fornece os dados do Search Console e do GA4; os dados de visibilidade em IA exigem o plano Starter ou Pro e uma primeira verificação concluída) e do n8n Cloud ou de um n8n auto-hospedado com o nó MCP Client Tool. O AI Agent também precisa de uma credencial de modelo de chat, por exemplo da OpenAI, da Anthropic ou do Google Gemini.

Criar um token de acesso

O n8n se conecta à Searcherries com um token de acesso pessoal. O login pelo navegador (OAuth2) não está disponível para o n8n, então a conexão é feita com o token.

  1. Faça login na Searcherries e abra o MCP.
  2. Abra a aba Other clients (Outros clientes) e localize Access tokens (Tokens de acesso).
  3. Digite um nome, como “n8n”, e selecione Create token (Criar token).
  4. Copie o token na hora. Ele aparece uma única vez.

O guia de tokens explica a expiração, a substituição e a revogação.

Adicionar o nó MCP Client Tool

  1. Abra um fluxo de trabalho no n8n, adicione um nó AI Agent e conecte um modelo de chat à entrada Chat Model do nó.
  2. Selecione o + na entrada Tool do agente e adicione MCP Client Tool.
  3. Em Endpoint, coloque a URL do servidor abaixo.
  4. Em Server Transport (transporte do servidor), escolha HTTP Streamable.
  5. Em Authentication (autenticação), escolha Bearer Auth, crie uma nova credencial e cole o token.
  6. Deixe Tools to Include (ferramentas a incluir) em All (todas).
https://app.searcherries.com/mcp/searcherries

Depois que a credencial é salva, o nó carrega as nove ferramentas da Searcherries. Todas são somente leitura: o agente lê dados que a Searcherries já armazenou e não pode alterar projetos nem atualizar relatórios. Saiba mais sobre o acesso a dados pelo MCP e sobre os cronogramas de atualização de dados.

Testar em um chat

Adicione um Chat Trigger antes do AI Agent, abra o chat e pergunte:

Liste meus projetos da Searcherries.

Confira se os projetos pertencem à conta que criou o token. Depois, pergunte sobre um deles pelo nome:

Usando a Searcherries, quais perguntas dos clientes os assistentes de IA respondem sem nos mencionar e quais concorrentes eles mencionam no nosso lugar? Inclua as datas dos relatórios.

Exemplo: relatório semanal de visibilidade em IA

Este fluxo de trabalho envia por e-mail ou publica um relatório curto toda segunda-feira de manhã: Schedule Trigger → AI Agent (modelo de chat + MCP Client Tool da Searcherries) → Send Email ou Slack.

  1. Schedule Trigger: em Trigger Interval (intervalo do gatilho), escolha Weeks (semanas), a cada 1 semana, na segunda-feira às 08:00.
  2. AI Agent: conecte o modelo de chat e o MCP Client Tool da Searcherries. Em Source for Prompt (origem do prompt), escolha Define below (definir abaixo) e cole o prompt que vem a seguir, com o nome da sua marca. Em Options (opções), adicione uma System Message (mensagem de sistema): “Você é um analista de marketing que faz relatórios sobre visibilidade em IA. Use só os dados que as ferramentas da Searcherries devolvem, mantenha as datas dos relatórios e escreva em texto simples, sem títulos em markdown.”
  3. Send Email ou Slack: conecte depois do agente e use {{ $json.output }} como texto, no campo Text do Send Email (com Email Format em Text) ou em Message Text da operação Send a message do Slack.

Prompt para o AI Agent:

Escreva o relatório semanal de visibilidade em IA do projeto da Searcherries “NOME DA MARCA”.

Passos:
1. Chame list-projects e use o projeto cujo nome de marca corresponde.
2. Chame get-project-summary com esse project_id.
3. Chame get-competitors com dataset "ranking".
4. Chame get-ai-answers com prominence_max 1 para listar as perguntas dos clientes em que nossa marca não aparece nas respostas.
5. Chame get-citations com group_by "domain" para ver em quais fontes as plataformas de IA se apoiam.

Depois escreva o relatório em texto simples, com menos de 300 palavras, nestas seções: Visibilidade (pontuação, variação em relação ao período anterior, taxa de menção), Concorrentes (as três marcas que mais subiram e o que as plataformas dizem sobre elas), Lacunas (as três perguntas dos clientes em que não aparecemos e os domínios citados nelas), Próxima semana (três ações concretas, cada uma ligada a uma constatação). Inclua as datas dos relatórios. Use só dados retornados pelas ferramentas da Searcherries e diga quando uma seção não tiver dados.

Se não funcionar

  • 401 Unauthorized quando o nó carrega as ferramentas ou o agente chama uma delas: o token foi revogado ou expirou. Crie um novo token na página do MCP e atualize a credencial Bearer Auth.
  • A lista de projetos está vazia: a conta que criou o token ainda não tem projeto, ou o token pertence a uma conta da Searcherries diferente da que você esperava. Um projeto cuja primeira verificação ainda está em andamento aparece na lista, mas fica sem respostas até a verificação terminar.
  • O nó não consegue carregar a lista de ferramentas: confira a URL completa do servidor, incluindo /mcp/searcherries, e se Server Transport está em HTTP Streamable.

Para qualquer outra questão, fale com o suporte.

Precisa de ajuda? Fale com o suporte