Pesquisa web em agentes de IA do n8n com a API de SERP da SerpCrypto

Por que usar o nó HTTP Request e não um nó personalizado?

A documentação do n8n diz que o nó HTTP Request pode ser executado como um nó comum ou anexado a um AI agent para ser usado como ferramenta. Isso cobre uma API REST como a SerpCrypto, que recebe uma requisição GET com um header e alguns query parameters. Não há nenhum nó da comunidade nosso para instalar ou manter atualizado, e a credencial fica no armazenamento de credenciais criptografado do n8n.

O nó AI Agent precisa de um chat model e de pelo menos um subnó de ferramenta. Desde o n8n 1.82.0, todo AI Agent funciona como Tools Agent, então o agente decide sozinho quando chamar a ferramenta de pesquisa.

Como armazeno a chave de API?

Crie uma credencial Header Auth. A documentação de credenciais do n8n descreve dois campos, o Name do header e o Value, e observa que um bearer token é header auth com o nome Authorization e o valor Bearer <token>. Coloque Authorization em Name e Bearer mais a sua chave SerpCrypto em Value.

O n8n também lista um tipo genérico de autenticação Bearer; qualquer um dos dois envia o mesmo header. Dê ao n8n a sua própria chave de API, para que você veja o uso dele separado dos seus outros scripts e possa revogá-la sozinha se precisar. Chaves de API que você pode criar e revogar a qualquer momento no seu painel.

Como o modelo preenche a consulta de pesquisa?

Deixe o modelo definir q. Ao lado de um campo de parâmetro elegível, o n8n mostra um botão de estrela que entrega o valor ao modelo. Você também pode digitar a expressão $fromAI() você mesmo, que recebe uma key, uma description, um type e um default value; a description diz ao modelo o que colocar ali. O n8n documenta que $fromAI() funciona apenas com ferramentas conectadas ao nó AI Agent.

Mantenha gl e hl fixos se o seu agente atende a um único mercado. Deixe o modelo defini-los também se os usuários perguntarem sobre países diferentes, e descreva os códigos esperados, como gb ou de.

{{ $fromAI("query", "The search query, as a person would type it", "string") }}

Por que ativar o Optimize Response?

Uma página de resultados completa em JSON é longa, e tudo o que a ferramenta retorna vai para o contexto do modelo. O Optimize Response é uma opção exclusiva de ferramenta do nó HTTP Request que reduz os dados passados ao modelo; o n8n observa que ela pode reduzir custos. Com o tipo de resposta JSON, defina Field Containing Data como organic_results e selecione apenas title, link e snippet.

O agente então lê cerca de dez entradas curtas por pesquisa em vez de todos os blocos da página. Se o seu agente responde a perguntas locais, aponte Field Containing Data para local_results em uma segunda ferramenta.

Como uso a mesma API em um workflow normal?

Sem o agente, use o nó HTTP Request como um nó comum com um q fixo, por exemplo em um workflow de Schedule Trigger que verifica uma palavra-chave todas as manhãs. Depois adicione um nó Split Out com Field to Split Out definido como organic_results: ele transforma a lista em um item por resultado, pronto para um nó de planilha ou de banco de dados.

Cada execução é uma pesquisa por palavra-chave, então 50 palavras-chave por dia usam cerca de 1.500 créditos por mês. O pack 25.000 pesquisas (US$ 18,75) cobre isso mais de dez vezes, e Os créditos de pesquisa pré-pagos nunca expiram: as pesquisas não utilizadas ficam na sua conta até você usá-las.

Como testo a requisição fora do n8n?

Execute a mesma requisição em um terminal. Se funcionar ali, qualquer problema no n8n vem das configurações do nó; se falhar, o corpo do erro indica a causa, conforme listado na página de erros. Erros nunca são cobrados.

# The request the HTTP Request node sends, for a test in a terminal
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=n8n self-hosted vs cloud" -d gl=us -d hl=en \
  | jq '.organic_results[]? | {title, link, snippet}'