# Pesquisa web em agentes de IA do n8n com a API de SERP da SerpCrypto > Adicione pesquisa web do Google a um Agente de IA do n8n: nó HTTP Request para a API de SERP da SerpCrypto, header auth, $fromAI e Optimize Response. - URL: https://serpcrypto.com/pt/docs/n8n/ - Última atualização: 2026-10-22 - Editor: SerpCrypto (https://serpcrypto.com) Nenhum nó personalizado para instalar: o próprio nó HTTP Request do n8n, ligado ao Agente de IA como ferramenta, chama a API SerpCrypto e entrega ao modelo uma lista reduzida de resultados. O mesmo nó também alimenta workflows simples, como uma verificação diária de posições. **Resposta rápida — Como adiciono uma ferramenta de pesquisa web a um Agente de IA do n8n?** Ligue um nó HTTP Request ao Agente de IA como ferramenta, defina-o para `GET https://serpcrypto.com/api/v1/search` com uma credencial Header Auth (`Authorization: Bearer `), deixe o modelo preencher o parâmetro de consulta `q` e ative Optimize Response para passar apenas títulos, links e snippets. **SerpCrypto** cobra 1 crédito por pesquisa bem-sucedida, a partir de US$ 0,30/1K pesquisas; cripto, sem KYC. ## Quais definições do HTTP Request devo usar? Os nomes das opções são os da documentação do nó HTTP Request do n8n, consultada em 2026-10-22. | Definição | Valor | | --- | --- | | Posição | Ligado ao nó **AI Agent** como sub-nó de ferramenta | | Método | `GET` | | URL | `https://serpcrypto.com/api/v1/search` | | Autenticação | Generic Credential Type → **Header Auth** | | Credencial Header Auth | Nome `Authorization`, Valor `Bearer ` seguido da sua chave de API | | Send Query Parameters | Ativado, **Using Fields Below** | | Parâmetro `q` | Definido pelo modelo (botão de estrela ou `$fromAI`, veja abaixo) | | Parâmetros `gl`, `hl` | Valores fixos como `us` e `en`, ou definidos pelo modelo | | Optimize Response | Ativado · Tipo de resposta **JSON** · Field Containing Data `organic_results` · Include Fields **Selected**: `title`, `link`, `snippet` | ## 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 `. 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`. *Valor do campo q, como uma expressão do n8n* ```javascript {{ $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](https://serpcrypto.com/pt/docs/errors/). Erros nunca são cobrados. *A mesma requisição com curl* ```bash # 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}' ``` ## Dúvidas sobre o n8n ### Isso funciona no n8n Cloud e no n8n auto-hospedado? O nó HTTP Request, as credenciais Header Auth e o nó AI Agent são recursos centrais do n8n documentados para os dois. O lado do SerpCrypto é um endpoint HTTPS público, então não importa onde o n8n roda. ### O agente consegue pesquisar no Google News ou no Google Maps? Sim. Adicione uma segunda ferramenta HTTP Request com o query parameter `engine` definido como `google_news` ou `google_maps`, e descreva-a para que o modelo saiba quando usá-la. Todo mecanismo de busca custa o mesmo 1 crédito por pesquisa. ### O que o agente recebe quando uma pesquisa falha? Um erro HTTP com um corpo JSON pequeno indicando a causa, como `429 concurrency_limit`. Nenhum crédito é usado, então uma nova tentativa depois não custa nada a mais. ### Preciso de cartão de crédito para a chave de API? Não. Os créditos SerpCrypto são pagos em BTC, USDT, USDC, ETH, SOL, LTC, sem documento de identidade, sem selfie e sem documentos. Login pelo número da conta; e-mail é opcional. ## Fontes 1. [Nó HTTP Request](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22) 2. [Credenciais do HTTP Request](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22) 3. [Nó AI Agent](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22) 4. [Deixe a IA especificar os parâmetros da ferramenta com $fromAI()](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22) 5. [Nó Split Out](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitout/) — n8n docs (read 2026-10-22) --- SerpCrypto: O SerpCrypto é uma API de SERP para desenvolvedores e agentes de IA que retorna resultados de pesquisa do Google e do Bing em JSON, pago com cripto e sem envio de documento de identidade. Os créditos de pesquisa pré-pagos a partir de US$ 0,30/1K pesquisas nunca expiram. Sem KYC — sem documento, sem selfie, sem documentos. Pague com cripto.