Integração n8n

A Scavio disponibiliza um nó comunitário oficial, verificado pelo n8n: n8n-nodes-scavio. Insira-o em qualquer fluxo de trabalho do n8n para executar buscas em tempo real no Google, Amazon, Walmart, YouTube e Reddit sem escrever nós HTTP ou manter cabeçalhos de autenticação personalizados. O nó também é usableAsTool, então você pode conectá-lo diretamente a um nó de Agente IA do n8n.

Status verificado

• Pacote no npm: n8n-nodes-scavio
• Aprovado pela equipe do n8n e enviado como um nó comunitário verificado na próxima remessa de lançamento do n8n
• Código-fonte: github.com/scavio-ai/n8n-nodes-scavio
• Licença: MIT

Pré-requisitos

1. n8n versão 1.0 ou posterior (nuvem ou auto-hospedado).
2. Uma chave de API do Scavio de dashboard.scavio.dev.

Instalar (n8n Cloud e auto-hospedado)

Dentro do n8n, abra Configurações → Nós Comunitários → Instalar e digite o nome do pacote:

n8n-nodes-scavio

Clique em Instalar. O n8n baixará a versão verificada mais recente do npm e registrará o nó Scavio no seu editor de fluxo de trabalho. Nenhuma reinicialização necessária no n8n Cloud; auto-hospedado pode precisar de um recarregamento.

Instalar (manual / Docker)

Para instâncias auto-hospedadas que preferem fixar o pacote diretamente:

# Dentro do seu container ou host n8n
npm install n8n-nodes-scavio

# Em seguida, reinicie o n8n para que o nó seja carregado
n8n start

Para implantações Docker, monte um volume que inclua o pacote instalado ou estenda a imagem do n8n e execute npm install n8n-nodes-scavio como parte da construção.

Configurar credenciais

1. No n8n, abra Credenciais → Nova e escolha Scavio API.
2. Cole sua chave de API do Scavio no campo API Key. A chave é armazenada criptografada pelo n8n.
3. Clique em Testar. O teste de credencial chama GET /api/v1/usage na API do Scavio (um endpoint gratuito), então você obtém feedback instantâneo de que a chave é válida sem consumir créditos.

Usar o nó Scavio

1. Adicione um novo nó ao seu fluxo de trabalho e procure por Scavio.
2. Escolha um Recurso:
   • Google — busca orgânica de SERP.
   • Amazon — busca de produtos e detalhes do produto por ASIN em 12 marketplaces.
   • Walmart — busca de produtos e detalhes do produto com filtros de fulfillment e preço.
   • YouTube — busca de vídeos e metadados.
   • Reddit — busca de posts e árvore completa de post + comentários por id.
   • Account — verificar uso da API e créditos restantes.
3. Escolha uma Operação para esse recurso (ex.: Search, Get Product, Get Post).
4. Preencha os parâmetros da operação (string de consulta, país, ASIN, id do post, etc.).
5. Execute o nó. A saída é um JSON estruturado que seus nós downstream podem ler diretamente.

Usar como ferramenta dentro de nós Agente IA do n8n

O nó Scavio é registrado com usableAsTool: true, então os nós Agente IA do n8n podem chamá-lo como ferramenta dentro de raciocínio de múltiplas etapas. Conecte o nó Scavio à entrada de ferramenta do agente e o agente chamará Scavio: Google Search, Scavio: Amazon Search Products, etc. conforme necessário durante uma execução.

Operações disponíveis

Exemplos de fluxos de trabalho

Padrões comuns em que o nó Scavio se encaixa perfeitamente:

• Qualificação de leads — Webhook de entrada → Scavio (Google · site:linkedin.com/company COMPANY) → Pontuação LLM → Gravação no CRM.
• Alertas de queda de preço na Amazon — Cron → Scavio (Amazon · Get Product por ASIN) → comparar com preço anterior → Alerta no Slack. Um fluxo de trabalho de exemplo funcional é enviado no repositório como workflows/amazon-price-drop.json.
• Monitoramento de sentimento no Reddit — Cron → Scavio (Reddit · Search Posts) → Resumo LLM → E-mail de resumo diário.
• Automação de conteúdo localizado — Cron diário → Scavio (Google + Reddit) para contexto local ao vivo → LLM compõe posts → Google Sheet para aprovação do cliente.
• Bots de WhatsApp / Slack com base em respostas — Gatilho ao receber mensagem → Scavio (Google) para fundamentar resposta ao vivo → LLM compõe resposta → Resposta no canal.

Atualizar o nó

O n8n monitora o npm por novas versões de nós verificados e as propaga automaticamente após uma rápida reavaliação. Para forçar uma atualização manual no n8n auto-hospedado:

npm install n8n-nodes-scavio@latest
n8n start

Solução de problemas

• Falha no teste de credencial: confirme se a chave de API é a chave completa com prefixo sk_live_ de dashboard.scavio.dev e se sua rede consegue acessar https://api.scavio.dev.
• Nó não aparece no editor após a instalação: em auto-hospedado, reinicie o processo do n8n para que ele re-registre nós comunitários.
• Erros 429 / limite de taxa: consulte a documentação de limites de taxa e a referência de erros para orientação sobre nova tentativa.

Recursos

• n8n-nodes-scavio no npm
• Código-fonte no GitHub
• Guia de instalação de nós comunitários do n8n
• Início rápido da API Scavio
• Referência da API de Busca do Google