Thanks to visit codestin.com
Credit goes to github.com

Skip to content

brightdata/brightdata-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Bright Data Logo

The Web MCP

๐ŸŒ Give your AI real-time web superpowers
Seamlessly connect LLMs to the live web without getting blocked

npm version npm downloads License

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

  1. Go to: Settings โ†’ Connectors โ†’ Add custom connector
  2. Name: Bright Data Web
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. 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

$0/month

5,000 requests


โœ… Web Search
โœ… Scraping with Web unlocker
โŒ Browser Automation
โŒ Web data tools


Default Mode

Pay-as-you-go

Every thing in rapid and 60+ Advanced Tools


โœ… Browser Control
โœ… Web Data APIs



PRO_MODE=true

๐Ÿ’ก Note: Pro mode is not included in the free tier and incurs additional charges based on usage.


โœจ 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:

Please follow Bright Data's coding standards.


๐Ÿ“ž Support


๐Ÿ“œ License

MIT ยฉ Bright Data Ltd.


Built with โค๏ธ by
Bright Data

The world's #1 web data platform


โญ Star us on GitHub โ€ข Read our Blog