@scavio/ai-sdk

@scavio/ai-sdk

Scavio search tools for the Vercel AI SDK. Give any AI SDK agent real-time search across Google, YouTube, Reddit, Amazon, Walmart, TikTok, and Instagram via the Scavio API.

Install

npm install @scavio/ai-sdk ai zod
export SCAVIO_API_KEY=sk_live_your_key

ai and zod are peer dependencies; scavio (the JS SDK) is bundled.

Usage

import { generateText, stepCountIs } from "ai";
import { openai } from "@ai-sdk/openai";
import { scavioSearch, scavioTools } from "@scavio/ai-sdk";

// A single tool:
const res = await generateText({
  model: openai("gpt-4o-mini"),
  tools: { scavio_search: scavioSearch({ maxResults: 5 }) },
  stopWhen: stepCountIs(3),
  prompt: "Find the official GitHub repo of the Agno framework",
});

// Or all tools at once:
const res2 = await generateText({
  model: openai("gpt-4o-mini"),
  tools: scavioTools(),
  stopWhen: stepCountIs(3),
  prompt: "Compare prices for a mechanical keyboard on Amazon and Walmart",
});

Tools

Factory	Tool name	Provider
scavioSearch	scavio_search	Google web search
scavioYoutubeSearch	scavio_youtube_search	YouTube video search
scavioRedditSearch	scavio_reddit_search	Reddit (2 credits)
scavioAmazonSearch	scavio_amazon_search	Amazon products
scavioWalmartSearch	scavio_walmart_search	Walmart products
scavioTiktokSearch	scavio_tiktok_search	TikTok videos
scavioInstagramSearch	scavio_instagram_search	Instagram users
scavioTools	all of the above	bundle for tools:

Each factory accepts { apiKey?, maxResults?, ...ScavioConfig }. The key falls back to SCAVIO_API_KEY. Get a key at dashboard.scavio.dev.

License

MIT