brightdata-mcp
brightdata-mcp copied to clipboard
A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.
The Web MCP
๐ Give your AI real-time web superpowers
Seamlessly connect LLMs to the live web without getting blocked
Quick Start โข Features โข Pricing โข Demos โข Docs โข Support
๐ Free Tier Available! ๐
5,000 requests/month FREE
Perfect for prototyping and everyday AI workflows
๐ Overview
The Web MCP is your gateway to giving AI assistants true web capabilities. No more outdated responses, no more "I can't access real-time information" - just seamless, reliable web access that actually works.
Built by Bright Data, the world's #1 web data platform, this MCP server ensures your AI never gets blocked, rate-limited, or served CAPTCHAs.
| โ
Works with Any LLM Claude, GPT, Gemini, Llama |
๐ก๏ธ Never Gets Blocked Enterprise-grade unblocking |
๐ 5,000 Free Requests Monthly |
โก Zero Config Works out of the box |
๐ฏ Perfect For
- ๐ Real-time Research - Get current prices, news, and live data
- ๐๏ธ E-commerce Intelligence - Monitor products, prices, and availability
- ๐ Market Analysis - Track competitors and industry trends
- ๐ค AI Agents - Build agents that can actually browse the web
- ๐ Content Creation - Access up-to-date information for writing
- ๐ Academic Research - Gather data from multiple sources efficiently
โก Quick Start
Use the configuration wizard:
Perfect for users who want zero setup. Just add this URL to your MCP client:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
Setup in Claude Desktop:
- Go to: Settings โ Connectors โ Add custom connector
- Name:
Bright Data Web - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - Click "Add" and you're done! โจ
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
๐ Pricing & Modes
| โก Rapid Mode (Free tier) | ๐ Pro Mode | ๐ง Custom Mode |
|---|---|---|
$0/month5,000 requests โ
Web Search Default Mode
|
Pay-as-you-goEverything in rapid plus 60+ tools โ
Browser Control |
Usage-basedPick the tools you need โ
Combine tool groups GROUPS="browser"TOOLS="scrape_as_html"
|
๐ก Note: Pro mode is not included in the free tier and incurs additional charges based on usage.
๐ง Advanced Tool Selection
GROUPSlets you enable curated tool bundles. Use comma-separated group IDs such asecommerce,browser.TOOLSadds explicit tool names on top of the selected groups.- Mode priority:
PRO_MODE=true(all tools) โGROUPS/TOOLS(whitelist) โ default rapid mode (base toolkit). - Base tools always enabled:
search_engine,search_engine_batch,scrape_as_markdown,scrape_batch. - Group ID
customis reserved; useTOOLSfor bespoke picks.
| Group ID | Description | Featured tools |
|---|---|---|
ecommerce |
Retail and marketplace datasets | web_data_amazon_product,
web_data_walmart_product,
web_data_google_shopping |
social |
Social, community, and creator insights | web_data_linkedin_posts,
web_data_tiktok_posts,
web_data_youtube_videos |
browser |
Bright Data Scraping Browser automation tools | scraping_browser_snapshot,
scraping_browser_click_ref,
scraping_browser_screenshot |
finance |
Financial intelligence datasets | web_data_yahoo_finance_business |
business |
Company and location intelligence datasets | web_data_crunchbase_company,
web_data_zoominfo_company_profile,
web_data_zillow_properties_listing |
research |
News and developer data feeds | web_data_github_repository_file,
web_data_reuter_news |
app_stores |
App store data | web_data_google_play_store,
web_data_apple_app_store |
travel |
Travel information | web_data_booking_hotel_listings |
advanced_scraping |
Batch and AI-assisted extraction helpers | search_engine_batch,
scrape_batch,
extract |
Claude Desktop example
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "browser,advanced_scraping",
"TOOLS": "extract"
}
}
}
}
โจ Features
๐ฅ Core Capabilities
| ๐ Smart Web Search Google-quality results optimized for AI |
๐ Clean Markdown AI-ready content extraction |
| ๐ Global Access Bypass geo-restrictions automatically |
๐ก๏ธ Anti-Bot Protection Never get blocked or rate-limited |
| ๐ค Browser Automation Control real browsers remotely (Pro) |
โก Lightning Fast Optimized for minimal latency |
๐ฏ Example Queries That Just Work
โ
"What's Tesla's current stock price?"
โ
"Find the best-rated restaurants in Tokyo right now"
โ
"Get today's weather forecast for New York"
โ
"What movies are releasing this week?"
โ
"What are the trending topics on Twitter today?"
๐ฌ Demos
Note: These videos show earlier versions. New demos coming soon! ๐ฅ
View Demo Videos
Basic Web Search Demo
https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33
Advanced Scraping Demo
https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d
๐ง Available Tools
โก Rapid Mode Tools (Default - Free)
| Tool | Description | Use Case |
|---|---|---|
๐ search_engine |
Web search with AI-optimized results | Research, fact-checking, current events |
๐ scrape_as_markdown |
Convert any webpage to clean markdown | Content extraction, documentation |
๐ Pro Mode Tools (60+ Tools)
Click to see all Pro tools
| Category | Tools | Description |
|---|---|---|
| Browser Control | scraping_browser.* |
Full browser automation |
| Web Data APIs | web_data_* |
Structured data extraction |
| E-commerce | Product scrapers | Amazon, eBay, Walmart data |
| Social Media | Social scrapers | Twitter, LinkedIn, Instagram |
| Maps & Local | Location tools | Google Maps, business data |
๐ฎ Try It Now!
๐งช Online Playground
Try the Web MCP without any setup:
๐ง Configuration
Basic Setup
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here"
}
}
}
}
Advanced Configuration
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here",
"PRO_MODE": "true", // Enable all 60+ tools
"RATE_LIMIT": "100/1h", // Custom rate limiting
"WEB_UNLOCKER_ZONE": "custom", // Custom unlocker zone
"BROWSER_ZONE": "custom_browser" // Custom browser zone
}
}
}
}
๐ Documentation
๐จ Common Issues & Solutions
๐ง Troubleshooting Guide
โ "spawn npx ENOENT" Error
Solution: Install Node.js or use the full path to node:
"command": "/usr/local/bin/node" // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe" // Windows
โฑ๏ธ Timeouts on Complex Sites
Solution: Increase timeout in your client settings to 180s
๐ Authentication Issues
Solution: Ensure your API token is valid and has proper permissions
๐ก Remote Server Connection
Solution: Check your internet connection and firewall settings
๐ค Contributing
We love contributions! Here's how you can help:
- ๐ Report bugs
- ๐ก Suggest features
- ๐ง Submit PRs
- โญ Star this repo!
Please follow Bright Data's coding standards.
๐ Support
|
๐ GitHub Issues Report bugs & features |
๐ Documentation Complete guides |
โ๏ธ Email [email protected] |
๐ License
MIT ยฉ Bright Data Ltd.