# scavio-ai/scavio-mcp [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/scavio-ai/scavio-mcp  
**GitHub Stars:** 8  
**npm Downloads (last month):** 4009  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/scavio-ai-scavio-mcp

## Description
Unified real-time search API for AI agents. Google, YouTube, Amazon, Walmart, Reddit, and TikTok through one endpoint. 21 tools for web search, e-commerce, product data, social media, and video platforms. Free tier included.

## Tools
Capabilities this server exposes over MCP:

- **extract_url** — Read any web page and return it as clean Markdown, plain text, or raw HTML
- **map_website** — List a site's page URLs from its sitemaps and start page, path-filtered, with `lastmod` when known
- **crawl_website** — Crawl a site from one URL and extract every same-site page; waits up to `wait_seconds` and returns results, or the job id
- **get_crawl_status** — A crawl's status, page counts, credits used and page results, paged by cursor; can wait for completion
- **cancel_crawl** — Stop a running crawl; nothing more is billed, results so far stay readable
- **batch_extract** — Extract a list of URLs in one job, results in input order; waits up to `wait_seconds
- **get_batch_status** — A batch's status and results, paged by cursor; can wait for completion
- **cancel_batch** — Stop a running batch
- **search_google** — Web search (v2) with organic results, ads, and AI Overview
- **google_custom_search** — Google results in the Custom Search JSON API format (`items[]`, `searchInformation`, `queries.nextPage`) for code ported from CSE
- **google_ai_mode** — AI Mode conversational answer with cited sources
- **google_maps_search** — Search Google Maps for local businesses
- **google_maps_place** — Place details: address, phone, hours, rating
- **google_maps_reviews** — Reviews for a place with pagination
- **google_shopping** — Product listings with price, store, and rating
- **google_shopping_product** — Product detail and sellers
- **google_shopping_stores** — More sellers for a product (pagination)
- **google_flights** — Flight itineraries with prices and stops
- **google_hotels** — Hotel search with prices and ratings
- **google_hotels_detail** — Hotel property details
- **google_news** — News results by query, topic, story, or publication
- **google_trends** — Interest-over-time and related queries
- **google_trending** — Trending searches
- **chatgpt_prompt** — Ask ChatGPT a prompt: the full Markdown answer, every cited page (title, publisher, date), the web searches it ran and the products it recommended
- **gemini_prompt** — Ask Google Gemini a prompt: the full Markdown answer, the URLs it cites and the products it recommended
- **search_youtube** — Search videos, channels, and playlists
- **search_youtube_shorts** — Search short-form videos
- **youtube_search_suggestions** — Get search autocomplete suggestions
- **get_youtube_video** — Get full video details, chapters, and captions
- **get_youtube_metadata** — Deprecated alias of `get_youtube_video
- **get_youtube_comments** — Get comments on a video with pagination
- **get_youtube_comment_replies** — Get replies to a specific comment
- **get_youtube_transcript** — Get a video transcript as plain text or SRT
- **get_youtube_related** — Get videos related to a video
- **search_youtube_channels** — Search channels by keyword
- **get_youtube_channel** — Get channel profile by ID, handle, or URL
- **get_youtube_channel_videos** — List a channel's videos
- **get_youtube_channel_shorts** — List a channel's Shorts
- **get_youtube_channel_community** — List a channel's community posts
- **resolve_youtube_channel** — Resolve a handle or URL to a channel ID
- **get_youtube_streams** — Get direct media stream URLs for a video
- **get_youtube_community_post** — Get one community post: text, author, likes, images, comments cursor
- **get_youtube_community_post_comments** — Get comments on a community post with pagination
- **search_amazon** — Search product listings across 22 marketplaces (no sort option)
- **get_amazon_product** — Get full product details by ASIN
- **get_amazon_offers** — List every seller offering an ASIN, with buy-box winner
- **get_amazon_options** — List the supported marketplaces and their country codes (free)
- **search_walmart** — Search product listings with price and delivery filters
- **get_walmart_product** — Get full product details by product ID
- **get_walmart_reviews** — Customer reviews with ratings, text, author, date and the rating breakdown
- **get_walmart_category** — Products within a category, same product shape as search
- **get_walmart_offers** — The buy-box offer for a product: price, seller, condition, buy-box flag
- **get_walmart_seller** — Marketplace seller storefront: name, rating, Pro Seller badge, business details
- **get_walmart_seller_products** — A seller's catalogue; `total_count` is the real size
- **get_walmart_stores** — Stores near a US ZIP or Canadian postal code, nearest first, with `store_id`, address, distance and hours
- **get_tiktok_profile** — Get user profile (bio, follower/following counts, likes)
- **get_tiktok_user_posts** — List a user's videos with stats
- **get_tiktok_video** — Get detailed info for a single video
- **get_tiktok_video_comments** — Get comments on a video
- **get_tiktok_comment_replies** — Get replies to a specific comment
- **search_tiktok_videos** — Search videos by keyword
- **search_tiktok_users** — Search users by keyword
- **get_tiktok_hashtag** — Get hashtag details and stats
- **get_tiktok_hashtag_videos** — List videos for a hashtag
- **get_tiktok_user_followers** — Get a user's follower list
- **get_tiktok_user_followings** — Get a user's following list
- **get_tiktok_trending_searches** — Search terms trending now (about 90, no region filter)
- **get_tiktok_trending_videos** — A sample of trending videos (about 6 per call)
- **get_tiktok_search_suggestions** — Search autocomplete suggestions for a keyword
- **get_tiktok_music** — Get a sound: artist, album, duration, videos using it, chart rank
- **get_tiktok_music_videos** — List videos that use a sound (about 14 per page)
- **search_tiktok_music** — Search sounds by keyword
- **get_tiktok_music_chart** — Top 50 or Viral 50 sound chart (global)
- **get_tiktok_user_similar** — Creators similar to a user (about 30 per page)
- **get_tiktok_user_playlists** — List a user's playlists (series)
- **get_tiktok_playlist_videos** — List the videos in a playlist
- **get_tiktok_user_live** — Is a user live now: room status, title, viewers
- **get_tiktok_user_region** — The region an account is registered in, plus sec_user_id
- **get_instagram_profile** — Get user profile (bio, follower/following/post counts)
- **get_instagram_user_posts** — List a user's posts with pagination

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "scavio-mcp": {
    "command": "npx",
    "args": ["-y","@scavio/mcp-server"],
    "env": {
      "SCAVIO_API_KEY": "",
      "SCAVIO_PLATFORMS": ""
    }
  }
}
```

**Requires environment variables:** `SCAVIO_API_KEY`, `SCAVIO_PLATFORMS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What scavio-ai/scavio-mcp does

scavio-ai/scavio-mcp exposes Scavio's unified search and data-extraction service through the Model Context Protocol. Its platform coverage includes Google, YouTube, Amazon, Walmart, Reddit, TikTok, travel sources, social networks, e-commerce providers, company data, and other search-oriented systems. The available catalog is broad, while the server loads a curated subset by default.

The extraction tools handle individual pages as well as multi-page jobs. `extract_url` returns a page as Markdown, plain text, or HTML. `map_website` discovers URLs from a site's sitemap and starting page, and can filter by path. `crawl_website` and `batch_extract` support longer-running work, with status, pagination, cancellation, and optional waiting through their companion tools.

## How it works

The hosted MCP endpoint is `https://mcp.scavio.dev/mcp`. Claude Desktop, claude.ai, and Claude Code can authenticate there with Scavio OAuth; API-key authentication is also supported through the `x-api-key` header. Local installations use `npx -y @scavio/mcp-server`, communicate over stdio, and authenticate with `SCAVIO_API_KEY`.

A platform allowlist controls which tool groups are registered. The default selection includes the platform set used by earlier releases plus extraction tools. `all` registers the complete catalog, while values such as `extract,google,zillow` select specific groups. Remote connections pass this selection through the `x-scavio-platforms` header or a `platforms` query parameter.

## Setup and configuration

For a local setup, use Node.js 20 or newer and configure an MCP client to launch the package with `npx`. Set `SCAVIO_API_KEY` to a key from Scavio. `SCAVIO_PLATFORMS` is optional and accepts a comma-separated list of platform keys, including `extract`, `google`, `youtube`, `amazon`, `reddit`, `zillow`, `sec`, and `companieshouse`.

The hosted endpoint avoids local installation. Add it as an HTTP MCP connection, then either sign in through OAuth where supported or provide the API key as a request header. Configuration examples are available for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Cline, and Zed.

## Tools and capabilities

The tool groups cover:

- Google web, Custom Search, AI Mode, Maps, Shopping, Flights, Hotels, News, Trends, and trending queries
- YouTube video, Shorts, channel, playlist, suggestion, metadata, chapter, and caption searches
- Product listings, product details, sellers, ratings, prices, and local-business information
- ChatGPT and Gemini prompt requests with answers, citations, searches, and recommended products
- URL extraction, site mapping, crawling, batch extraction, status polling, and cancellation

Most tools consume one credit per call, while some endpoints use pricing based on the endpoint or request body. Long-running crawl and batch operations can return a job ID, be checked later with a cursor, or be cancelled while retaining completed results.

## Limitations and notes

Registering every available tool can add roughly 260 KB of definitions, or about 65,000 tokens, to a session and may exceed limits in some clients. Selecting only the required platform groups reduces that overhead. An unset or `default` platform selection loads the curated default set; `none` loads only `get_usage`.

The server requires Scavio authentication for normal use, and calls consume credits according to the service's pricing rules. `get_youtube_metadata` is a deprecated alias for `get_youtube_video`. The hosted service and local package use different configuration mechanisms: environment variables apply locally, while remote platform selection is passed in the connection.

_Full upstream README: https://allmcps.com/mcp/scavio-ai-scavio-mcp/readme_