composio-scavio

Scavio real-time search tools for Composio.

Scavio is a single Search API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram. This package exposes those endpoints as a Composio custom toolkit so your agents can pull structured, up-to-date results across any Composio-supported framework (OpenAI, Anthropic, LangChain, CrewAI, and more).

Install

pip install composio-scavio

Setup

Get a Scavio API key from the Scavio Dashboard (new accounts get 50 free credits to start, no credit card). Set it as an environment variable or pass it directly.

export SCAVIO_API_KEY=sk_...
export COMPOSIO_API_KEY=...   # from https://app.composio.dev

Usage

from composio import Composio
from composio_scavio import build_scavio_toolkit

composio = Composio()

# Build the toolkit; expose only the providers you need.
scavio = build_scavio_toolkit(
    api_key="sk_...",        # or rely on SCAVIO_API_KEY
    enable_google=True,
    enable_amazon=True,
    enable_tiktok=False,
)

session = composio.create(
    user_id="user_1",
    experimental={"custom_toolkits": [scavio]},
)

result = session.tools.execute(
    "SCAVIO_GOOGLE_SEARCH",
    arguments={"query": "best search API for AI agents", "country_code": "us"},
)
print(result)

Pass all=True to register every tool regardless of the individual flags.

Tools

All tools are namespaced under the SCAVIO toolkit. Each provider is gated by an enable_* flag.

Credits

Most endpoints cost 1 credit, including Google. Reddit and Instagram cost 2 credits each. See scavio.dev/docs.

Links

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