MCP Server

Connect AI agents to ScrapeBadger via Model Context Protocol. 92 tools for Twitter, Google, Vinted, and web scraping.

MCP Server

ScrapeBadger provides a hosted MCP (Model Context Protocol) server at mcp.scrapebadger.com that lets AI agents access all ScrapeBadger APIs through structured, typed tools.

What is MCP?

Model Context Protocol is an open standard by Anthropic for connecting AI models to external tools and data sources. Instead of writing code, your AI agent discovers and calls ScrapeBadger tools naturally during a conversation.

Key Features

92 Tools

Every ScrapeBadger API endpoint is available as a typed MCP tool with structured parameters.

Zero Setup

Hosted at mcp.scrapebadger.com — just add one config snippet to your AI tool.

10 Platforms

Works with Claude, Cursor, Windsurf, VS Code, Gemini, ChatGPT, OpenClaw, Cline, and more.

Same Pricing

No extra cost — MCP uses the same credit-based pricing as the REST API.

4 Products

Twitter/X data, Google (16 products), Vinted marketplace, and general web scraping — all in one server.

Bearer Auth

Secure API key authentication via Authorization header or query parameter.

Available Tools

Category	Tools	Description
Twitter Users	11	Profiles, search, followers, following, mentions, subscriptions
Twitter Tweets	11	Get tweets, advanced search, replies, quotes, retweeters, edit history
Twitter Discovery	12	Trends, communities, lists, places, spaces, broadcasts
Twitter Streams	8	Real-time stream monitors, webhooks, delivery logs
Twitter Filter Rules	8	Query-based monitoring, pricing tiers, delivery logs
Google Search	6	Web search (SERP), Images, Videos, Autocomplete, AI Mode, Lens
Google Maps	5	Place search, details, reviews, photos, business posts
Google News & Content	8	News search/topics/trending, Scholar, Patents search + detail, Finance, Products
Google Shopping	3	Product search, product detail, merchant URL enrichment
Google Specialized	7	Hotels (search + details), Trends (4 endpoints), Jobs
Vinted	8	Item search, details, seller profiles, brands, markets
Web Scraping	6	Scrape URLs, screenshots, AI extraction, batch jobs

Google Tools

All 29 Google MCP tools are prefixed with google_:

Search & Discovery

Tool	Description
google_search	Web search (SERP) with 21 parameters + knowledge graph, PAA, AI overview
google_images_search	Image search with size/color/type filters
google_videos_search	Video search
google_autocomplete	Search suggestions for a query prefix
google_ai_mode_search	Generative AI answers (udm=50) with references
google_lens_search	Visual image search by URL

Maps

Tool	Description
google_maps_search	Search places by text query
google_maps_place	Place detail by place_id or data_id
google_maps_reviews	Paginated reviews (sortable)
google_maps_photos	Place photos
google_maps_posts	Business posts

Shopping

Tool	Description
google_shopping_search	Product search with filters + quick_filters + ads
google_shopping_product	Product detail with seller list
google_shopping_product_click	Resolve the real merchant URL per product

News, Trends, Jobs

Tool	Description
google_news_search	News article search
google_news_topics	News by predefined topic
google_news_trending	Trending stories
google_trends_interest	Interest over time (up to 5 terms)
google_trends_regions	Interest by region
google_trends_related	Related topics + queries
google_trends_trending	Real-time trending searches
google_jobs_search	Job listings with filters

Specialized

Tool	Description
google_hotels_search	Hotel search with dates
google_hotels_details	Property details by property_token
google_patents_search	Patent document search
google_patents_detail	Full patent by publication number
google_scholar_search	Academic paper search with year filters
google_finance_quote	Stock / index / crypto quotes
google_products_detail	Immersive product detail

Quick Start

1. Get an API Key

   Sign up at scrapebadger.com and create an API key from the dashboard.

2. Choose Your AI Tool

   See the integration guides for copy-paste config snippets for each platform.

3. Start Using Tools

   Ask your AI agent to search tweets, scrape websites, or look up Vinted items — it will discover and call the right tools automatically.

Authentication

Pass your API key using one of these methods:

Method	Example	Best For
Bearer header	Authorization: Bearer sb_live_...	Cursor, Windsurf, VS Code, Cline
Query parameter	?api_key=sb_live_...	Claude Desktop (via mcp-remote)
Environment variable	SCRAPEBADGER_API_KEY=sb_live_...	Local/stdio installations

MCP Endpoint

https://mcp.scrapebadger.com/mcp

Health check: https://mcp.scrapebadger.com/health