arcade-scavio
Scavio real-time search and page-extraction tools for Arcade.dev and MCP — Google, Google News, Reddit, YouTube, Amazon, HEB, Kroger, extract_url (read any web page), and tools to map a site's URLs, crawl a whole site, and batch-extract a URL list, with one API key. A cost-effective Tavily alternative and SerpAPI alternative for Arcade agents.
Install
pip install arcade-scavio
Scope: 15 tools, by design
This toolkit is a curated subset of the Scavio API, not a wrapper around all of it. It exposes 20 tools — 14 endpoints across 6 of Scavio's 33 platforms, plus the core Extract family, which belongs to no platform: extract_url for one page, and map, crawl and batch for whole sites:
| Tool | Endpoint | Platform | Credits |
|---|---|---|---|
extract_url |
POST /api/v1/extract |
(core, not a platform) | 1 / 1 / 2 by mode |
search_google |
POST /api/v2/google |
1 | |
search_news |
POST /api/v2/google/news |
1 | |
search_reddit |
POST /api/v1/reddit/search |
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 | 5 |
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 |
search_heb |
POST /api/v1/heb/search |
HEB | 2 |
get_heb_product |
POST /api/v1/heb/product |
HEB | 2 |
get_heb_stores |
POST /api/v1/heb/stores |
HEB | 2 |
search_kroger |
POST /api/v1/kroger/search |
Kroger | 2 |
get_kroger_product |
POST /api/v1/kroger/product |
Kroger | 2 |
map_website |
POST /api/v1/extract/map |
(Extract) | 1 on normal (up to 2 / 10 on advanced / ultra) |
crawl_website |
POST /api/v1/extract/crawl |
(Extract) | per successful page, 1 / 1 / 2 by mode |
get_crawl_status |
GET /api/v1/extract/crawl/{id} |
(Extract) | free |
batch_extract |
POST /api/v1/extract/batch |
(Extract) | per successful page, 1 / 1 / 2 by mode |
get_batch_status |
GET /api/v1/extract/batch/{id} |
(Extract) | free |
HEB store pricing: search_heb and get_heb_product take an optional store_id (the store_number from get_heb_stores) for that store's prices, stock and aisle location; the store used comes back as store {store_id, name}. With store_id, get_heb_product needs only product_id.
Platforms covered here: Google (2), YouTube (5), Reddit (1), Amazon (1), HEB (3), Kroger (2), plus extract_url, which is tied to no platform — it reads any URL. Not covered: Walmart, TikTok, TikTok Shop, Instagram, X, LinkedIn, eBay, Target, Home Depot, Zillow, Redfin, Booking, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the App Store, Google Play, SEC, Companies House, G2, Capterra, Google Ads, Meta Ad Library, Threads, Kuaishou, 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.
Map, crawl and batch
map_website answers in one call with a site's page URLs, gathered from its sitemaps and start page. crawl_website and batch_extract start a background job, wait up to wait_seconds (default 45, max 300) for it to finish, and return the job's id, status, pages, credits_used, up to limit page results (default 10) and next_cursor. Arcade tools are request/response, so a job that is still queued or running when the wait ends keeps going server-side; read it, and any further pages, with get_crawl_status / get_batch_status and the id. Set wait_seconds=0 to get the id back at once, which suits a platform with a short tool-call timeout.
Crawl and batch bill per successful page at extract's price for the mode (normal and advanced 1 credit, ultra 2); failed and skipped pages are free, and a job stops cleanly with stopped_reason: "insufficient_credits" if the balance runs out. Reading a job is free. Crawl and map obey the site's robots.txt; results are kept for 3 days. Plan limits (pages per crawl / active jobs / URLs per batch): Free 10/1/10, PAYG 100/1/50, Project 500/2/100, Bootstrap 2,000/3/500, Startup 5,000/5/1,000, Growth 10,000/10/1,000. Cancellation, webhooks and idempotency keys exist on the REST API and in the scavio SDK, but are not tools here.
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 core tools cost 1, search_youtube costs 2, get_youtube_transcript costs 5, all HEB and Kroger tools cost 2, and extract_url is priced by the tier you ask for rather than per call.
| Tool | Credits |
|---|---|
search_google, search_news, search_reddit, get_youtube_video, list_youtube_comments, get_youtube_channel, search_amazon |
1 |
search_youtube, search_heb, get_heb_product, get_heb_stores, search_kroger, get_kroger_product |
2 |
get_youtube_transcript |
5 |
extract_url |
1 on mode="normal", 1 on "advanced", 2 on "ultra" |
map_website |
1 on normal; up to 2 on advanced, up to 10 on ultra |
crawl_website, batch_extract |
per successful page: 1 on normal or advanced, 2 on ultra |
get_crawl_status, get_batch_status |
free |
extract_url bills only on a successful read: a dead link, a bot wall or a timeout costs nothing. Start on normal; move to advanced when the page builds its content with JavaScript, and to ultra only for the hardest pages. See the extract docs.
Elsewhere in the API (not exposed here): YouTube streams 3, Instagram 1-2 (up to 10), LinkedIn 1-10 with a job at 30, Kuaishou 1-40 per endpoint, G2 5, Capterra 2, everything else 1. New accounts get 50 one-time signup credits — no monthly refill, no credit card.
Run standalone
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
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, eBay, Zillow, Booking, Indeed, the App Store, SEC filings, Maps, Shopping, Flights or Hotels? Scavio runs a hosted MCP server at https://mcp.scavio.dev/mcp that exposes 191 tools across all 200+ endpoints, authenticated with an x-api-key header — no install, no toolkit to deploy. See the MCP docs.
About Scavio
Scavio is a real-time search API built for AI agents — a unified API over Google, YouTube, Amazon, Walmart, HEB, Kroger, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, eBay, Target, Home Depot, Zillow, Redfin, Booking, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the App Store, Google Play, SEC, Companies House, G2, Capterra, Google Ads, Meta Ad Library, Threads and Kuaishou that returns clean JSON, plus extract to read any URL. 200+ live endpoints across 33 platforms, one key. A broader, cost-effective Tavily alternative and SerpAPI alternative. See the Arcade integration docs.
Development
pip install -e ".[dev]"
pytest
Links
- Scavio: https://scavio.dev
- Docs: https://scavio.dev/docs/arcade
- Dashboard: https://dashboard.scavio.dev
Metadata
Release files for arcade-scavio 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| arcade_scavio-0.4.1.tar.gz | 14.9 kB | Without provenance | Details for arcade_scavio-0.4.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| arcade_scavio-0.4.1-py3-none-any.whl | Python 3 | none | any | Details for arcade_scavio-0.4.1-py3-none-any.whl |
Total release size: 26.2 kB
Release files / arcade_scavio-0.4.1.tar.gz
| Download URL | arcade_scavio-0.4.1.tar.gz |
|---|---|
| Size | 14.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ca8d0605bcf49e47ca921a7cbb99975bb671adb778b8afb0d8678d5dd4f878c5
|
|
BLAKE2b-256 checksum How to use checksums |
0613922bc2472e92e29ff1e6e037ed6baa58634090c87ac258c9ba94b4e382ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / arcade_scavio-0.4.1-py3-none-any.whl
| Download URL | arcade_scavio-0.4.1-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6e4a6e2781cef875891c612682bb9485c7b1521c888bbbe6a8252e738711b1ee
|
|
BLAKE2b-256 checksum How to use checksums |
7397f7498effb1afd2b1de43441ff2e8164a2f1fb18a920ba9c612bf2df9fa67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Security for arcade-scavio 0.4.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.