openai-agents-scavio

openai-agents-scavio

Scavio real-time search tools for the OpenAI Agents SDK (TypeScript) — Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram, with one API key. Scavio also covers TikTok Shop, X and LinkedIn; reach those through the hosted MCP server.

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. A third Amazon tool arrived with the move: scavio_amazon_offers lists every seller offering an ASIN -- price, condition, shipping, and which offer holds the buy box. 1 credit, same as the other two.

Install

npm install openai-agents-scavio @openai/agents zod

Setup

Get a Scavio API key from the Scavio Dashboard (new accounts get 50 free credits, no credit card). Set SCAVIO_API_KEY or pass { apiKey }.

Usage

import { Agent, run } from "@openai/agents";
import { buildScavioTools } from "openai-agents-scavio";

const agent = new Agent({
  name: "Search Assistant",
  instructions: "Search the web, shopping sites, and social platforms with Scavio.",
  tools: buildScavioTools(), // reads SCAVIO_API_KEY
});

const result = await run(agent, "Find the top budget laptops on Amazon");
console.log(result.finalOutput);

Expose only the providers you need:

const tools = buildScavioTools({
  enableGoogle: true,
  enableReddit: true,
  enableAmazon: false,
  enableWalmart: false,
  enableYoutube: false,
  enableTiktok: false,
  enableInstagram: false,
});

Pass { all: true } to register every tool regardless of the individual flags.

Tools

buildScavioTools() returns one tool per Scavio endpoint, named scavio_<provider>_<action> (e.g. scavio_google_search, scavio_amazon_product). Each returns the structured Scavio JSON response.

Use every endpoint via MCP

The tools above cover seven platforms. For the full Scavio API — every endpoint across Google, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X and LinkedIn, with no install — point the Agents SDK at the hosted MCP server:

import { Agent, MCPServerStreamableHttp } from "@openai/agents";

const server = new MCPServerStreamableHttp({
  url: "https://mcp.scavio.dev/mcp",
  name: "scavio",
  requestInit: { headers: { "x-api-key": process.env.SCAVIO_API_KEY! } },
});

const agent = new Agent({ name: "Search Assistant", mcpServers: [server] });

Credits

Most calls cost 1 credit, Google and Reddit included. The exceptions:

Tool	Credits
scavio_youtube_search, scavio_youtube_shorts	2
scavio_youtube_streams	3
scavio_youtube_transcript	8
scavio_instagram_user_posts	2
scavio_instagram_post, scavio_instagram_comment_replies	8
every other scavio_instagram_*	10

See scavio.dev/docs.

Links

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