Metadata-Version: 2.4
Name: arcade-scavio
Version: 0.1.2
Summary: Scavio real-time search tools (Google, Google News, Reddit, YouTube, Amazon) for Arcade.dev / MCP
Project-URL: Homepage, https://scavio.dev
Project-URL: Repository, https://github.com/scavio-ai/arcade-scavio
Project-URL: Documentation, https://scavio.dev/docs/arcade
Author-email: Scavio <support@scavio.dev>
License: MIT
License-File: LICENSE
Keywords: arcade,arcade-ai,mcp,scavio,search,serp,tavily-alternative,tools
Requires-Python: >=3.10
Requires-Dist: arcade-mcp-server<2.0.0,>=1.17.4
Requires-Dist: scavio>=0.14.0
Provides-Extra: dev
Requires-Dist: arcade-mcp[all]<2.0.0,>=1.11.2; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# arcade-scavio

[Scavio](https://scavio.dev) real-time search tools for [Arcade.dev](https://arcade.dev) and MCP — Google, Google News, Reddit, YouTube, and Amazon, with one API key. A cost-effective [Tavily alternative](https://scavio.dev/docs) and [SerpAPI alternative](https://scavio.dev/docs) for Arcade agents.

## Install

```bash
pip install arcade-scavio
```

## Scope: 9 endpoints, by design

This toolkit is a **curated subset** of the Scavio API, not a wrapper around all of it. It exposes **9** of Scavio's 98 endpoints across **4** of its 10 platforms:

| Tool | Endpoint | Platform | Credits |
|---|---|---|---|
| `search_google` | `POST /api/v2/google` | Google | 1 |
| `search_news` | `POST /api/v2/google/news` | Google | 1 |
| `search_reddit` | `POST /api/v1/reddit/search` | Reddit | 1 |
| `search_youtube` | `POST /api/v1/youtube/search` | YouTube | 2 |
| `get_youtube_video` | `POST /api/v1/youtube/video` | YouTube | 1 |
| `get_youtube_transcript` | `POST /api/v1/youtube/transcript` | YouTube | 8 |
| `list_youtube_comments` | `POST /api/v1/youtube/comments` | YouTube | 1 |
| `get_youtube_channel` | `POST /api/v1/youtube/channel` | YouTube | 1 |
| `search_amazon` | `POST /api/v1/amazon/search` | Amazon | 1 |

Platforms covered here: **Google (2), YouTube (5), Reddit (1), Amazon (1).** Not covered: Walmart, TikTok, TikTok Shop, Instagram, X, LinkedIn, and the other 12 Google v2 verticals (Maps, Shopping, Flights, Hotels, Trends, AI Mode, ...). That is deliberate — a hand-picked toolkit an agent routes correctly beats a hundred near-identical tools — and it stays that way.

Each tool reads the `SCAVIO_API_KEY` secret, which Arcade injects securely at call time (the client and LLM never see the value).

## Credits

**This toolkit is not flat 1 credit.** Seven of the nine tools cost 1, but `search_youtube` costs 2 and `get_youtube_transcript` costs **8**.

| Tool | Credits |
|---|---|
| `search_google`, `search_news`, `search_reddit`, `get_youtube_video`, `list_youtube_comments`, `get_youtube_channel`, `search_amazon` | 1 |
| `search_youtube` | 2 |
| `get_youtube_transcript` | 8 |

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, no credit card.

## Run standalone

```bash
export SCAVIO_API_KEY=sk_live_...   # get one at https://dashboard.scavio.dev
python -m arcade_scavio.server          # stdio
python -m arcade_scavio.server http     # HTTP+SSE
```

## Deploy to Arcade Cloud

```bash
arcade login
arcade deploy
```

Arcade discovers the `SCAVIO_API_KEY` secret and hosts it encrypted; the Arcade Engine fulfils authorized tool calls for your users.

## Every endpoint via MCP

Need Walmart, TikTok, TikTok Shop, Instagram, X, LinkedIn, Maps, Shopping, Flights or Hotels? Scavio runs a hosted MCP server at `https://mcp.scavio.dev/mcp` that exposes **100 tools, one per endpoint**, authenticated with an `x-api-key` header — no install, no toolkit to deploy. See the [MCP docs](https://scavio.dev/docs/mcp).

## About Scavio

[Scavio](https://scavio.dev) 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. 98 live endpoints, one key. A broader, cost-effective [Tavily alternative](https://scavio.dev/docs) and [SerpAPI alternative](https://scavio.dev/docs). See the [Arcade integration docs](https://scavio.dev/docs/arcade).

## Development

```bash
pip install -e ".[dev]"
pytest
```

## Links

- Scavio: https://scavio.dev
- Docs: https://scavio.dev/docs/arcade
- Dashboard: https://dashboard.scavio.dev
