Integracion con CrewAI

Scavio se distribuye como un paquete de herramientas listo para usar con CrewAI, el framework para orquestar agentes autonomos con roles. Instala crewai-scavio y entrega cualquier herramienta a un Agent de CrewAI para darle busqueda en tiempo real en Google, Amazon, Walmart, YouTube, Reddit, TikTok e Instagram — un paquete, una clave API, sin codigo HTTP personalizado.

Requisitos previos

1. Python 3.10 o posterior.
2. Una clave API de Scavio obtenida en dashboard.scavio.dev.

Instalacion

pip install crewai-scavio

El framework crewai y el SDK de Python scavio se incluyen como dependencias.

Configura tu clave API

export SCAVIO_API_KEY=sk_live_your_key

Cada herramienta lee SCAVIO_API_KEY del entorno. Tambien puedes pasarla de forma explicita: ScavioSearchTool(api_key="sk_live_...").

Inicio rapido

from crewai import Agent, Crew, Task
from crewai_scavio import ScavioSearchTool

researcher = Agent(
    role="Research Analyst",
    goal="Find accurate, up-to-date information on any topic",
    backstory="An expert researcher who finds reliable sources.",
    tools=[ScavioSearchTool()],
    verbose=True,
)

task = Task(
    description="Research the top 3 trends in AI agents for 2026.",
    expected_output="A summary of the top 3 trends with sources.",
    agent=researcher,
)

crew = Crew(agents=[researcher], tasks=[task], verbose=True)
print(crew.kickoff())

Usar mas proveedores

Importa solo las herramientas que un agente necesita — cada proveedor es su propia clase de herramienta:

from crewai_scavio import (
    ScavioSearchTool,          # Google web search
    ScavioAmazonSearchTool,    # Amazon product search
    ScavioYouTubeSearchTool,   # YouTube video search
    ScavioRedditSearchTool,    # Reddit post search
)

agent = Agent(
    role="Market Researcher",
    goal="Compare products and gather public sentiment",
    tools=[ScavioAmazonSearchTool(), ScavioRedditSearchTool()],
)

Herramientas disponibles

32 herramientas en 7 proveedores. Todas siguen la convencion de nombres Scavio<Provider><Action>Tool.

Como funciona

Cada herramienta es un BaseTool de CrewAI con un esquema de argumentos tipado, por lo que el agente obtiene sugerencias de argumentos precisas y CrewAI valida las llamadas antes de ejecutarlas. Las llamadas pasan por el SDK de Python scavio, que se encarga de la autenticacion, el limite de tasa y el formato de las solicitudes. Los resultados se devuelven al agente como datos estructurados.

Costos en creditos

La mayoria de las llamadas cuestan 1 credito. Reddit cuesta 2 creditos, y Google cuesta 2 cuando light_request=false. Consulta la referencia de limites de tasa para los limites por plan y la referencia de errores para orientacion sobre reintentos.

Recursos

• crewai-scavio en PyPI
• crewai-scavio en GitHub
• Documentacion de CrewAI
• Inicio rapido de la API de Scavio
• Referencia de la API de Google Search