llama-index-tools-scavio

Scavio real-time search tools for LlamaIndex — Google, Google News, Reddit, YouTube, and Amazon as clean Documents, with one API key. A drop-in Tavily alternative and SerpAPI alternative for LlamaIndex RAG pipelines and agents.

Install

pip install llama-index-tools-scavio

Setup

Get a Scavio API key from the Scavio Dashboard (new accounts get 50 free signup credits, one-time, no credit card). Set SCAVIO_API_KEY or pass api_key= to the tool spec.

Usage

from llama_index.tools.scavio import ScavioToolSpec

tool_spec = ScavioToolSpec()  # reads SCAVIO_API_KEY

# Direct call — returns a list of llama_index Document objects
docs = tool_spec.search("best real-time search API for AI agents", max_results=5)
for doc in docs:
    print(doc.text, doc.metadata["url"])

Hand the tools to an agent:

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

agent = FunctionAgent(
    tools=ScavioToolSpec().to_tool_list(),
    llm=OpenAI(model="gpt-5.5"),
    system_prompt="You are a research assistant. Use Scavio for fresh web data.",
)
response = await agent.run("What are people on Reddit saying about Tavily alternatives?")

Scope: 8 endpoints, by design

ScavioToolSpec is a curated subset of the Scavio API, not a wrapper around all of it. It exposes 8 of Scavio's 98 endpoints across 4 of its 10 platforms — the ones that map cleanly onto RAG Documents (every function returns List[Document]):

Platforms covered here: Google (2), YouTube (4), Reddit (1), Amazon (1). Not covered: Walmart, TikTok, TikTok Shop, Instagram, X, LinkedIn, and the other 10 Google v2 verticals (Maps, Shopping, Flights, Hotels, Trends, AI Mode, ...). That is deliberate — this is a document-retrieval tool spec, not an API client — and it stays that way.

Reaching the rest of the API

For full coverage — all 98 endpoints across Google, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X, and LinkedIn — point a LlamaIndex agent at the hosted MCP server at https://mcp.scavio.dev/mcp, which exposes 100 tools (one per endpoint) with no install required:

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

scavio_mcp = McpToolSpec(
    client=BasicMCPClient(
        "https://mcp.scavio.dev/mcp",
        headers={"x-api-key": "sk_live_..."},
    )
)
tools = await scavio_mcp.to_tool_list_async()

See the MCP docs. Or call the scavio SDK directly — it is already a dependency here — and wrap whichever endpoints you need.

Scavio vs Tavily vs SerpAPI

These rows compare the APIs, not this tool spec. Rows marked below the table are the ones ScavioToolSpec itself exposes; the rest are reachable via MCP or the scavio SDK.

In ScavioToolSpec: Google SERP, Google News, Reddit, YouTube, Amazon search. Everything else in the Scavio column comes from MCP or the SDK.

Migrating from Tavily

- from llama_index.tools.tavily_research import TavilyToolSpec
- tool_spec = TavilyToolSpec(api_key="tvly-...")
+ from llama_index.tools.scavio import ScavioToolSpec
+ tool_spec = ScavioToolSpec(api_key="sk_live_...")

  docs = tool_spec.search("your query")

Credits

This package is not flat 1 credit. Six of the eight tools cost 1, but youtube_search costs 2 and youtube_transcript costs 8 — budget for it if you are bulk-ingesting transcripts into an index.

Elsewhere in the API (not exposed here): YouTube streams 3, Instagram 2-10, LinkedIn 1-10 with a job at 30, everything else 1. New accounts get 50 one-time signup credits — no monthly refill. See scavio.dev/docs.

About Scavio

Scavio is a real-time search API built for AI agents — a unified API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X, and LinkedIn that returns clean JSON. It is a cost-effective Tavily alternative and SerpAPI alternative with broader platform coverage. Learn more in the LlamaIndex integration docs.

Links

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