Agno Integration
Scavio ships as a native toolkit inside Agno, the high-performance Python framework for building agents. Import ScavioTools and hand it to any Agno Agent to give it real-time search across Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram — one toolkit, one API key, no custom HTTP code.
Prerequisites
- Python 3.9 or later.
- A Scavio API key from dashboard.scavio.dev.
Install
pip install agno scavioThe toolkit lives in the agno package itself; the scavio package is the official Python SDK it calls under the hood.
Set your API key
export SCAVIO_API_KEY=sk_live_your_keyScavioTools reads SCAVIO_API_KEY from the environment. You can also pass it explicitly: ScavioTools(api_key="sk_live_...").
Quickstart
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.scavio import ScavioTools
agent = Agent(
model=OpenAIChat(id="gpt-4o-mini"),
tools=[ScavioTools()],
markdown=True,
)
agent.print_response("Find the GitHub repo for the Agno framework and summarize it")Enable only the providers you need
Every provider is enabled by default. Each is gated by an enable_* flag, so you can expose a lean tool list to the model:
# Web-only agent: Google, YouTube, Reddit
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,
)
],
)
# Or register every tool explicitly
agent = Agent(tools=[ScavioTools(all=True)])Available tools
Each Scavio endpoint is exposed as a provider-prefixed tool. Tool names match the method names below.
| Provider | Flag | Tools |
|---|---|---|
enable_google | google_search | |
| Amazon | enable_amazon | amazon_search, amazon_product |
| Walmart | enable_walmart | walmart_search, walmart_product |
| YouTube | enable_youtube | youtube_search, youtube_metadata |
enable_reddit | reddit_search, reddit_post | |
| TikTok | enable_tiktok | tiktok_profile, tiktok_user_posts, tiktok_video, tiktok_video_comments, tiktok_comment_replies, tiktok_search_videos, tiktok_search_users, tiktok_hashtag, tiktok_hashtag_videos, tiktok_user_followers, tiktok_user_followings |
enable_instagram | instagram_profile, instagram_user_posts, instagram_user_reels, instagram_user_tagged, instagram_user_stories, instagram_post, instagram_post_comments, instagram_comment_replies, instagram_search_users, instagram_search_hashtags, instagram_user_followers, instagram_user_followings |
How it works
Every tool returns the Scavio response as a JSON string the model can read directly. Errors are caught and returned as {"error": "..."} rather than raised, so a failed call never crashes the agent run. Calls go through the scavio SDK, which handles auth, rate limiting, and request formatting.
Credit costs
Most calls cost 1 credit. Reddit costs 2 credits, and Google costs 2 when light_request=false. See the rate limits reference for plan limits and the errors reference for retry guidance.