Skip to main content

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 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 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

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)

Source distribution for arcade-scavio 0.4.1
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)

Table of built distributions (wheels) for arcade-scavio 0.4.1
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page