Integracion con n8n

Scavio incluye un nodo comunitario oficial verificado por n8n: n8n-nodes-scavio. Agregalo a cualquier flujo de trabajo de n8n para ejecutar busquedas en tiempo real en Google, Amazon, Walmart, YouTube y Reddit sin escribir nodos HTTP ni mantener encabezados de autenticacion personalizados. El nodo tambien es usableAsTool, lo que permite adjuntarlo directamente a un nodo AI Agent de n8n.

Estado de verificacion

• Paquete en npm: n8n-nodes-scavio
• Aprobado por el equipo de n8n y disponible como nodo comunitario verificado en el proximo lote de lanzamiento de n8n
• Codigo fuente: github.com/scavio-ai/n8n-nodes-scavio
• Licencia: MIT

Requisitos previos

1. n8n version 1.0 o posterior (cloud o autoalojado).
2. Una clave API de Scavio obtenida en dashboard.scavio.dev.

Instalacion (n8n Cloud y autoalojado)

Dentro de n8n, abre Settings → Community Nodes → Install e introduce el nombre del paquete:

n8n-nodes-scavio

Haz clic en Install. n8n descargara la ultima version verificada desde npm y registrara el nodo Scavio en tu editor de flujos. No es necesario reiniciar en n8n Cloud; en autoalojado puede requerirse una recarga.

Instalacion (manual / Docker)

Para instancias autoalojadas que prefieran fijar el paquete directamente:

# Inside your n8n container or host
npm install n8n-nodes-scavio

# Then restart n8n so the node is loaded
n8n start

Para despliegues con Docker, monta un volumen que incluya el paquete instalado o extiende la imagen de n8n y ejecuta npm install n8n-nodes-scavio como parte del build.

Configurar credenciales

1. En n8n, abre Credentials → New y selecciona Scavio API.
2. Pega tu clave API de Scavio en el campo API Key. La clave se almacena cifrada por n8n.
3. Haz clic en Test. La prueba de credenciales llama a GET /api/v1/usage en la API de Scavio (un endpoint gratuito), asi que obtienes retroalimentacion inmediata de que la clave es valida sin consumir creditos.

Usar el nodo Scavio

1. Agrega un nuevo nodo a tu flujo de trabajo y busca Scavio.
2. Elige un Resource:
   • Google — busqueda organica en SERP.
   • Amazon — busqueda de productos y detalle por ASIN en 12 marketplaces.
   • Walmart — busqueda de productos y detalle con filtros de fulfillment y precio.
   • YouTube — busqueda de videos y metadatos.
   • Reddit — busqueda de publicaciones y arbol completo de comentarios por id.
   • Account — consulta el uso de la API y los creditos restantes.
3. Elige una Operation para ese recurso (por ejemplo, Search, Get Product, Get Post).
4. Completa los parametros de la operacion (cadena de busqueda, pais, ASIN, id de publicacion, etc.).
5. Ejecuta el nodo. La salida es JSON estructurado que tus nodos posteriores pueden leer directamente.

Uso como herramienta en nodos AI Agent de n8n

El nodo Scavio esta registrado con usableAsTool: true, por lo que los nodos AI Agent de n8n pueden invocarlo como herramienta durante el razonamiento multi-paso. Conecta el nodo Scavio a la entrada de herramientas del agente y el agente llamara a Scavio: Google Search, Scavio: Amazon Search Products, etc. segun sea necesario durante una ejecucion.

Operaciones disponibles

Flujos de trabajo de ejemplo

Patrones comunes en los que el nodo Scavio encaja perfectamente:

• Calificacion de leads — Webhook entrante → Scavio (Google · site:linkedin.com/company COMPANY) → puntuacion con LLM → escritura en CRM.
• Alertas de caida de precio en Amazon — Cron → Scavio (Amazon · Get Product por ASIN) → comparar con precio anterior → alerta en Slack. Un flujo de ejemplo funcional se incluye en el repositorio como workflows/amazon-price-drop.json.
• Monitoreo de sentimiento en Reddit — Cron → Scavio (Reddit · Search Posts) → resumen con LLM → correo de resumen diario.
• Automatizacion de contenido localizado — Cron diario → Scavio (Google + Reddit) para contexto local en tiempo real → LLM compone publicaciones → Google Sheet para aprobacion del cliente.
• Bots fundamentados para WhatsApp / Slack — Trigger por mensaje → Scavio (Google) para fundamentar respuestas en vivo → LLM compone respuesta → respuesta en el canal.

Actualizar el nodo

n8n monitorea npm en busca de nuevas versiones de nodos verificados y las propaga automaticamente tras una breve re-revision. Para forzar una actualizacion manual en n8n autoalojado:

npm install n8n-nodes-scavio@latest
n8n start

Solucion de problemas

• La prueba de credenciales falla: confirma que la clave API es la clave completa con prefijo sk_live_ obtenida en dashboard.scavio.dev y que tu red puede alcanzar https://api.scavio.dev.
• El nodo no aparece en el editor despues de la instalacion: en autoalojado, reinicia el proceso de n8n para que vuelva a registrar los nodos comunitarios.
• Errores 429 / limite de tasa: consulta la documentacion de limites de tasa y la referencia de errores para orientacion sobre reintentos.

Recursos

• n8n-nodes-scavio en npm
• Codigo fuente en GitHub
• Guia de instalacion de nodos comunitarios de n8n
• Inicio rapido de la API de Scavio
• Referencia de la API de Google Search