OpenAI Agents SDK Integration
Scavio ships as a tool package for the OpenAI Agents SDK in both Python and TypeScript. Install openai-agents-scavio, hand the tools to an Agent, and it gets real-time search across Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram from one package and one API key — a cost-effective Tavily and SerpAPI alternative with broader platform coverage.
One package, every platform
openai-agents-scavio registers 32 native Agents SDK tools, one per Scavio endpoint, so your agent can search the web, shopping sites, and social platforms without writing a single HTTP call.Introduction
The openai-agents-scavio package plugs Scavio into the OpenAI Agents SDK as a set of function tools. Each tool wraps one Scavio endpoint and returns the structured Scavio JSON response, ready for the model to reason over. Before you start you need:
- The OpenAI Agents SDK:
openai-agents(Python 3.10+) or@openai/agents(Node 22+). - A Scavio API key from dashboard.scavio.dev (new accounts get free credits, no credit card).
Step-by-Step Integration Guide
Step 1: Install
Add the tool package. The TypeScript package pulls in the Agents SDK and zod alongside it:
pip install openai-agents-scavioStep 2: Set your API key
export SCAVIO_API_KEY=sk_live_your_keyThe tools read SCAVIO_API_KEY from the environment, or you can pass api_key / { apiKey } to the factory.
Step 3: Basic usage
Register the tools on an agent and let the model call them as needed:
from agents import Agent, Runner
from openai_agents_scavio import get_scavio_tools
agent = Agent(
name="Search Assistant",
instructions="Search the web, shopping sites, and social platforms with Scavio.",
tools=get_scavio_tools(), # reads SCAVIO_API_KEY
)
result = Runner.run_sync(agent, "Find the top budget laptops on Amazon")
print(result.final_output)Available Tools
Both packages expose 97 tools, one per Scavio endpoint, named scavio_<provider>_<action> (for example scavio_google_search, scavio_amazon_product, scavio_reddit_post). Each returns the structured Scavio JSON response.
| Provider | Tools |
|---|---|
scavio_google_search, scavio_google_ai_mode, scavio_google_maps_search, scavio_google_maps_place, scavio_google_maps_reviews, scavio_google_shopping, scavio_google_shopping_product, scavio_google_shopping_stores, scavio_google_flights, scavio_google_hotels, scavio_google_hotels_detail, scavio_google_news, scavio_google_trends, scavio_google_trending | |
| YouTube | scavio_youtube_search, scavio_youtube_shorts, scavio_youtube_suggestions, scavio_youtube_video, scavio_youtube_comments, scavio_youtube_comment_replies, scavio_youtube_transcript, scavio_youtube_related, scavio_youtube_channel_search, scavio_youtube_channel, scavio_youtube_channel_videos, scavio_youtube_channel_shorts, scavio_youtube_channel_community, scavio_youtube_channel_resolve, scavio_youtube_streams |
| Amazon | scavio_amazon_search, scavio_amazon_product, scavio_amazon_offers |
| Walmart | scavio_walmart_search, scavio_walmart_product |
scavio_reddit_search, scavio_reddit_search_suggestions, scavio_reddit_post, scavio_reddit_post_comments, scavio_reddit_comment_replies, scavio_reddit_subreddit, scavio_reddit_subreddit_posts, scavio_reddit_user, scavio_reddit_user_posts, scavio_reddit_user_comments, scavio_reddit_popular, scavio_reddit_trending | |
| TikTok Shop | scavio_tiktok_shop_search, scavio_tiktok_shop_search_suggestions, scavio_tiktok_shop_product, scavio_tiktok_shop_product_reviews, scavio_tiktok_shop_categories, scavio_tiktok_shop_category_products, scavio_tiktok_shop_shop_products, scavio_tiktok_shop_resolve |
| TikTok | scavio_tiktok_profile, scavio_tiktok_user_posts, scavio_tiktok_video, scavio_tiktok_video_comments, scavio_tiktok_comment_replies, scavio_tiktok_search_videos, scavio_tiktok_search_users, scavio_tiktok_hashtag, scavio_tiktok_hashtag_videos, scavio_tiktok_user_followers, scavio_tiktok_user_followings |
scavio_instagram_profile, scavio_instagram_user_posts, scavio_instagram_user_reels, scavio_instagram_user_tagged, scavio_instagram_user_stories, scavio_instagram_post, scavio_instagram_post_comments, scavio_instagram_comment_replies, scavio_instagram_search_users, scavio_instagram_search_hashtags, scavio_instagram_user_followers, scavio_instagram_user_followings | |
| X | scavio_x_search, scavio_x_tweet, scavio_x_tweet_comments, scavio_x_tweet_retweeters, scavio_x_user, scavio_x_user_tweets, scavio_x_user_replies, scavio_x_user_media, scavio_x_user_followers, scavio_x_user_followings, scavio_x_trending |
scavio_linkedin_person, scavio_linkedin_person_about, scavio_linkedin_person_posts, scavio_linkedin_company, scavio_linkedin_company_posts, scavio_linkedin_search_jobs, scavio_linkedin_job, scavio_linkedin_post, scavio_linkedin_post_comments |
Most calls cost 1 credit, and Instagram costs 8-10 credits (2 for user posts). See the rate limits reference for plan limits and the errors reference for retry guidance.
Advanced Example
Register only the providers a given agent needs to keep its tool list tight. Pass all=True (Python) or { all: true } (TypeScript) to register every tool regardless of the individual flags.
tools = get_scavio_tools(
enable_google=True,
enable_reddit=True,
enable_amazon=False,
enable_walmart=False,
enable_youtube=False,
enable_tiktok=False,
enable_instagram=False,
)Use every endpoint via MCP
For the full Scavio API with no install, point the Agents SDK at the hosted MCP server:
from agents import Agent
from agents.mcp.server import MCPServerStreamableHttp
server = MCPServerStreamableHttp(
name="scavio",
params={"url": "https://mcp.scavio.dev/mcp", "headers": {"x-api-key": "sk_live_..."}},
)
agent = Agent(name="Search Assistant", mcp_servers=[server])Benefits of Scavio + OpenAI Agents SDK
- Native tools: real Agents SDK function tools the model calls automatically.
- Dual language: the same package and API in Python and TypeScript.
- Multi-platform: web, shopping, and social in one API key.
- Cost-effective: most calls cost a single credit.