google-adk-scavio

Scavio real-time search tools for Google ADK (Agent Development Kit) — Google, YouTube, Amazon, Walmart, and Reddit, with one API key.

Amazon changed (breaking). The upstream provider moved in 2026-07: domain is replaced by country, a two-letter marketplace code (us, gb -- the UK is gb, not uk -- de, jp, ...), and sort_by, pages, category_id, merchant_id, language, currency, device, zip_code and autoselect_variant are gone. The marketplace ignores all of them (sort_by returns the identical unordered set for every value), so they are removed rather than kept as silent no-ops. Rank and filter results yourself.

Install

pip install google-adk-scavio

Setup

Get a Scavio API key from the Scavio Dashboard (new accounts get 50 free signup credits, no credit card). Set SCAVIO_API_KEY or pass api_key= to the factory.

Usage

from google.adk.agents import Agent
from google_adk_scavio import create_scavio_tools

root_agent = Agent(
    name="search_assistant",
    model="gemini-2.5-flash",
    instruction="Search the web, news, shopping sites, and Reddit with the Scavio tools.",
    tools=create_scavio_tools(),  # reads SCAVIO_API_KEY
)

Expose only the providers you need:

tools = create_scavio_tools(
    enable_google=True,
    enable_reddit=True,
    enable_youtube=False,
    enable_amazon=False,
    enable_walmart=False,
)

Tools

create_scavio_tools() returns plain typed Python functions; ADK wraps each one in a FunctionTool automatically. Each returns the structured Scavio JSON response as a dict; errors come back as {"error": "..."} rather than raising, so a failed call never crashes the run.

Use every endpoint via MCP

For the full Scavio API (TikTok, Instagram, Google Maps, Shopping, Trends, and more), point ADK at the hosted MCP server. Requires ADK's MCP extra: pip install "google-adk[mcp]".

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams

scavio = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://mcp.scavio.dev/mcp",
        headers={"x-api-key": "sk_live_..."},
    )
)

root_agent = Agent(name="search_assistant", model="gemini-2.5-flash", tools=[scavio])

Links

• Scavio: https://scavio.dev
• Docs: https://scavio.dev/docs/google-adk
• Dashboard: https://dashboard.scavio.dev

License

MIT