brightdata/brightdata-mcpPublic

NotificationsYou must be signed in to change notification settings
Fork229
Star1.8k

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

License

MIT license

1.8k stars 229 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 234 Commits
.github/workflows		.github/workflows
assets		assets
examples		examples
.gitignore		.gitignore
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
aria_snapshot_filter.js		aria_snapshot_filter.js
brightdata-mcp-extension.dxt		brightdata-mcp-extension.dxt
browser_session.js		browser_session.js
browser_tools.js		browser_tools.js
package-lock.json		package-lock.json
package.json		package.json
server.js		server.js
server.json		server.json
smithery.yaml		smithery.yaml
tool_groups.js		tool_groups.js

Repository files navigation

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 byBright 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 our hosted server - No installation needed!

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

Run locally on your machine

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

⚡ Rapid Mode (Free tier)	💎 Pro Mode	🔧 Custom Mode
$0/month 5,000 requests ✅ Web Search ✅ Scraping with Web unlocker ❌ Browser Automation ❌ Web data tools `Default Mode`	Pay-as-you-go Everything in rapid plus 60+ tools ✅ Browser Control ✅ Web Data APIs `PRO_MODE=true`	Usage-based Pick the tools you need ✅ Combine tool groups ✅ Add individual tools ❌ Overrides Pro eligibility `GROUPS="browser"` `TOOLS="scrape_as_html"`

$0/month

5,000 requests

✅ Web Search
✅ Scraping with Web unlocker
❌ Browser Automation
❌ Web data tools

Default Mode

Pay-as-you-go

Everything in rapid plus 60+ tools

✅ Browser Control
✅ Web Data APIs

PRO_MODE=true

Usage-based

Pick the tools you need

✅ Combine tool groups
✅ Add individual tools
❌ Overrides Pro eligibility

GROUPS="browser"
TOOLS="scrape_as_html"

💡 Note: Pro mode isnot included in the free tier and incursadditional charges based on usage.

🧠 Advanced Tool Selection

GROUPS lets you enable curated tool bundles. Use comma-separated groupIDs such asecommerce,browser.
TOOLS adds 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 IDcustom is reserved; useTOOLS for 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

bright-data-mcp-scraping-browser-demo-claude.mp4

Advanced Scraping Demo

bright-data-mcp-with-claude-quick-demo.mp4

📺 More tutorials on YouTube →

🔧 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

📚 View complete tool documentation →

🎮 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

More troubleshooting →

🤝 Contributing

We love contributions! Here's how you can help:

🐛Report bugs
💡Suggest features
🔧Submit PRs
⭐ Star this repo!

Please followBright Data's coding standards.

📞 Support

🐛 GitHub Issues
_{Report bugs & features}

📚 Documentation
_{Complete guides}

✉️ Email
_{support@brightdata.com}

📜 License

Built with ❤️ by

_{The world's #1 web data platform}

⭐ Star us on GitHub •Read our Blog

About

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

brightdata.com/

Releases4

v2.7.0 Latest

Dec 16, 2025

+ 3 releases

Movatterモバイル変換

License

brightdata/brightdata-mcp

Folders and files

Latest commit

History

Repository files navigation

The Web MCP

🎉Free Tier Available! 🎉

🌟 Overview

🎯 Perfect For

⚡ Quick Start

🚀 Pricing & Modes

$0/month

Pay-as-you-go

Usage-based

🧠 Advanced Tool Selection

Claude Desktop example

✨ Features

🔥 Core Capabilities

🎯 Example Queries That Just Work

🎬 Demos

Basic Web Search Demo

Advanced Scraping Demo

🔧 Available Tools

⚡ Rapid Mode Tools (Default - Free)

💎 Pro Mode Tools (60+ Tools)

🎮 Try It Now!

🧪 Online Playground

🔧 Configuration

Basic Setup

Advanced Configuration

📚 Documentation

🚨 Common Issues & Solutions

❌ "spawn npx ENOENT" Error

⏱️ Timeouts on Complex Sites

🔑 Authentication Issues

📡 Remote Server Connection

🤝 Contributing

📞 Support

📜 License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases4

Uh oh!

Contributors13

Languages