Scavio Tools
Gate ScavioTools providers with enable_* flags to build web-only, commerce-only, and all-provider search agents over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram.
Demonstrates the Scavio toolkit: a unified Search API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram.
"""
Scavio Tools
=============================
Demonstrates the Scavio toolkit: a unified Search API over Google, YouTube, Amazon,
Walmart, Reddit, TikTok, and Instagram.
Setup:
pip install -U "agno[scavio]" # requires scavio>=0.4.0 (Google Search uses the v2 API)
export SCAVIO_API_KEY=*** # get a key at https://dashboard.scavio.dev
"""
from agno.agent import Agent
from agno.tools.scavio import ScavioTools
# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------
# Example 1: default ScavioTools (every provider enabled)
agent = Agent(tools=[ScavioTools()])
# Example 2: only the web providers (Google, YouTube, Reddit)
web_agent = Agent(
tools=[
ScavioTools(
enable_google=True,
enable_youtube=True,
enable_reddit=True,
enable_amazon=False,
enable_walmart=False,
enable_tiktok=False,
enable_instagram=False,
)
]
)
# Example 3: only the commerce providers (Amazon, Walmart)
commerce_agent = Agent(
tools=[
ScavioTools(
enable_google=False,
enable_youtube=False,
enable_reddit=False,
enable_amazon=True,
enable_walmart=True,
enable_tiktok=False,
enable_instagram=False,
)
]
)
# Example 4: enable every tool explicitly
all_agent = Agent(tools=[ScavioTools(all=True)])
# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
web_agent.print_response(
"Search Google for the latest news on AI agent frameworks",
markdown=True,
stream=True,
)
web_agent.print_response(
"What are people on Reddit saying about the Agno framework?",
markdown=True,
stream=True,
)
commerce_agent.print_response(
"Compare prices for a 'mechanical keyboard' on Amazon and Walmart",
markdown=True,
stream=True,
)Run the Example
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activateInstall dependencies
uv pip install -U agno openai "scavio>=0.4.0"Export your API keys
export OPENAI_API_KEY="your_openai_api_key_here"
export SCAVIO_API_KEY="your_scavio_api_key_here"Run the example
Save the code above as scavio_tools.py, then run:
python scavio_tools.pyFull source: cookbook/91_tools/scavio_tools.py