<div align="center">
<a href="https://www.bright.cn/ai/mcp-server">
<img src="https://github.com/user-attachments/assets/c21b3f7b-7ff1-40c3-b3d8-66706913d62f" alt="Bright Data Logo">
</a>
<h1>The Web MCP</h1>
<p>
<strong>🌐 让你的 AI 拥有实时上网超能力</strong><br/>
<i>无缝连接 LLM 到实时网络，不再被封锁</i>
</p>
<p>
<a href="https://www.npmjs.com/package/@brightdata/mcp">
<img src="https://img.shields.io/npm/v/@brightdata/mcp?style=for-the-badge&color=blue" alt="npm version"/>
</a>
<a href="https://www.npmjs.com/package/@brightdata/mcp">
<img src="https://img.shields.io/npm/dw/@brightdata/mcp?style=for-the-badge&color=green" alt="npm downloads"/>
</a>
<a href="https://github.com/bright-cn/brightdata-mcp/blob/main/LICENSE">
<img src="https://img.shields.io/badge/license-MIT-purple?style=for-the-badge" alt="License"/>
</a>
</p>
<p>
<a href="#-quick-start">快速开始</a> •
<a href="#-features">功能特性</a> •
<a href="#-pricing--modes">价格与模式</a> •
<a href="#-demos">演示</a> •
<a href="#-documentation">文档</a> •
<a href="#-support">支持</a>
</p>
<div>
<h3>🎉 <strong>提供免费套餐！</strong> 🎉</h3>
<p><strong>每月 5,000 次请求免费</strong> <br/>
<sub>非常适合原型开发与日常 AI 工作流</sub></p>
</div>
</div>
---
## 🌟 概览
The Web MCP 是为 AI 助手赋予真正「上网能力」的通道。告别过时回答，也不再出现“我无法访问实时信息”的窘境——只需稳定、顺畅、可用的网络访问。
由全球领先的[Bright Data](https://www.bright.cn) Web 数据平台打造，这个 MCP 服务器确保你的 AI 不再被封锁、限流或被验证码拦住。
<div align="center">
<table>
<tr>
<td align="center">✅ <strong>适配任意 LLM</strong><br/><sub>Claude、GPT、Gemini、Llama</sub></td>
<td align="center">🛡️ <strong>不再被封</strong><br/><sub>企业级解封与反封锁</sub></td>
<td align="center">🚀 <strong>5,000 次/月免费</strong><br/><sub>按月计</sub></td>
<td align="center">⚡ <strong>零配置</strong><br/><sub>开箱即用</sub></td>
</tr>
</table>
</div>
---
## 🎯 适用场景
- 🔍 实时调研——获取最新价格、新闻与实时数据
- 🛍️ 电商情报——监测产品、价格与库存
- 📊 市场分析——跟踪竞品与行业趋势
- 🤖 AI 代理——构建真正能「浏览网页」的智能体
- 📝 内容创作——为写作获取最新可信的信息
- 🎓 学术研究——高效汇聚多源公开数据
---
## ⚡ 快速开始
<summary><b>📡 使用托管服务器——无需安装！</b></summary>
零门槛使用，只需在你的 MCP 客户端中添加以下 URL：
```
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
```
在 Claude Desktop 中设置：
1. 打开：Settings → Connectors → Add custom connector
2. 名称：`Bright Data Web`
3. URL：`https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN`
4. 点击 “Add”，完成！✨
<summary><b>在本地运行</b></summary>
```json
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
```
---
## 🚀 价格与模式
<div align="center">
<table>
<tr>
<th width="33%">⚡ Rapid 模式（免费）</th>
<th width="33%">💎 Pro 模式</th>
</tr>
<tr>
<td align="center">
<h3>$0/月</h3>
<p><strong>5,000 次请求</strong></p>
<hr/>
<p>✅ Web 搜索<br/>
✅ 使用 Web Unlocker 抓取<br/>
❌ 浏览器自动化<br/>
❌ Web 数据工具</p>
<br/>
<code>默认模式</code>
</td>
<td align="center">
<h3>按量计费</h3>
<p><strong>包含 Rapid 全部内容 + 60+ 高级工具</strong></p>
<hr/>
<p>✅ 浏览器控制<br/>
✅ Web 数据 API<br/>
<br/>
<br/>
<br/>
<code>PRO_MODE=true</code>
</td>
</tr>
</table>
</div>
> 💡 注意：Pro 模式不包含在免费套餐内，按使用量额外计费。
---
## ✨ 功能特性
### 🔥 核心能力
<table>
<tr>
<td>🔍 <b>智能网页搜索</b><br/>面向 AI 优化的类 Google 级结果</td>
<td>📄 <b>干净 Markdown</b><br/>适配 AI 的内容抽取输出</td>
</tr>
<tr>
<td>🌍 <b>全球可达</b><br/>自动绕过地理限制</td>
<td>🛡️ <b>反机器人与防封</b><br/>不再被封、不再限流</td>
</tr>
<tr>
<td>🤖 <b>浏览器自动化</b><br/>远程控制真实浏览器（Pro）</td>
<td>⚡ <b>低时延</b><br/>为快速响应优化</td>
</tr>
</table>
### 🎯 一些“开箱即用”的查询示例
```yaml
✅ “特斯拉当前股价是多少？”
✅ “现在东京评分最高的餐厅有哪些？”
✅ “纽约今天的天气预报是什么？”
✅ “本周有哪些电影上映？”
✅ “今天 Twitter 上的热点话题是什么？”
```
---
## 🎬 演示
> 注：以下视频展示的是早期版本，新的演示即将上线！🎥
<details>
<summary><b>查看演示视频</b></summary>
### 基础网页搜索演示
https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33
### 高级抓取演示
https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d
[📺 更多教程（YouTube）→](https://github.com/bright-cn/brightdata-mcp/blob/main/examples/README.md)
</details>
---
## 🔧 可用工具
### ⚡ Rapid 模式工具（默认，免费）
| 工具 | 描述 | 适用场景 |
|------|------|----------|
| 🔍 `search_engine` | 面向 AI 优化的 Web 搜索 | 研究、查证、时事 |
| 📄 `scrape_as_markdown` | 将任意网页转为干净的 Markdown | 内容抽取、文档化 |
### 💎 Pro 模式工具（60+）
<details>
<summary><b>点击查看全部 Pro 工具</b></summary>
| 类别 | 工具 | 描述 |
|------|------|------|
| 浏览器控制 | `scraping_browser.*` | 全功能浏览器自动化 |
| Web 数据 API | `web_data_*` | 结构化数据抽取 |
| 电商 | 产品抓取器 | Amazon、eBay、Walmart 等 |
| 社媒 | 社交抓取器 | Twitter、LinkedIn、Instagram |
| 地图与本地 | 位置工具 | Google 地图、商家数据 |
[📚 查看完整工具文档 →](https://github.com/bright-cn/brightdata-mcp/blob/main/assets/Tools.md)
</details>
---
## 🎮 立即试用！
### 🧪 在线 Playground
无需任何配置，直接体验 Web MCP：
<div align="center">
<a href="https://www.bright.cn/ai/playground-chat">
<img src="https://img.shields.io/badge/Try_on-Playground-00C7B7?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMyA3VjE3TDEyIDIyTDIxIDE3VjdMMTIgMloiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMiIvPgo8L3N2Zz4=" alt="Playground"/>
</a>
</div>
---
## 🔧 配置
### 基础配置
```json
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here"
}
}
}
}
```
### 高级配置
```json
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here",
"PRO_MODE": "true", // 启用 60+ 全部工具
"RATE_LIMIT": "100/1h", // 自定义限速
"WEB_UNLOCKER_ZONE": "custom", // 自定义解封 Zone
"BROWSER_ZONE": "custom_browser" // 自定义浏览器 Zone
}
}
}
}
```
---
## 📚 文档
<div align="center">
<table>
<tr>
<td align="center">
<a href="https://docs.brightdata.com/mcp-server/overview">
<img src="https://img.shields.io/badge/📖-API_Docs-blue?style=for-the-badge" alt="API Docs"/>
</a>
</td>
<td align="center">
<a href="https://github.com/bright-cn/brightdata-mcp/blob/main/examples">
<img src="https://img.shields.io/badge/💡-Examples-green?style=for-the-badge" alt="Examples"/>
</a>
</td>
<td align="center">
<a href="https://github.com/bright-cn/brightdata-mcp/blob/main/CHANGELOG.md">
<img src="https://img.shields.io/badge/📝-Changelog-orange?style=for-the-badge" alt="Changelog"/>
</a>
</td>
<td align="center">
<a href="https://www.bright.cn/blog/ai/web-scraping-with-mcp">
<img src="https://img.shields.io/badge/📚-Tutorial-purple?style=for-the-badge" alt="Tutorial"/>
</a>
</td>
</tr>
</table>
</div>
---
## 🚨 常见问题与解决方案
<details>
<summary><b>🔧 故障排查指南</b></summary>
### ❌ “spawn npx ENOENT” 错误
解决：安装 Node.js，或使用 node 的完整路径：
```json
"command": "/usr/local/bin/node" // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe" // Windows
```
### ⏱️ 复杂站点超时
解决：在客户端设置中将超时提高到 180s
### 🔑 鉴权问题
解决：确认 API Token 有效且具备相应权限
### 📡 远程连接问题
解决：检查网络与防火墙设置
[更多排查 →](https://github.com/bright-cn/brightdata-mcp#troubleshooting)
</details>
---
## 🤝 参与贡献
我们欢迎各种形式的贡献：
- 🐛 [提交 Bug](https://github.com/bright-cn/brightdata-mcp/issues)
- 💡 [功能建议](https://github.com/bright-cn/brightdata-mcp/issues)
- 🔧 [提交 PR](https://github.com/bright-cn/brightdata-mcp/pulls)
- ⭐ 欢迎为本仓库加星！
请遵循 [Bright Data 的代码规范](https://www.bright.cn/dna/js_code)。
---
## 📞 支持
<div align="center">
<table>
<tr>
<td align="center">
<a href="https://github.com/bright-cn/brightdata-mcp/issues">
<strong>🐛 GitHub Issues</strong><br/>
<sub>提交问题与需求</sub>
</a>
</td>
<td align="center">
<a href="https://docs.brightdata.com/mcp-server/overview">
<strong>📚 文档</strong><br/>
<sub>完整指南</sub>
</a>
</td>
<td align="center">
<a href="mailto:support@brightdata.com">
<strong>✉️ 邮件</strong><br/>
<sub>support@brightdata.com</sub>
</a>
</td>
</tr>
</table>
</div>
---
## 📜 许可证
MIT © [Bright Data Ltd.](https://www.bright.cn)
---
<div align="center">
<p>
<strong>由 ❤️ 驱动</strong><br/>
<a href="https://www.bright.cn">
<img src="https://idsai.net.technion.ac.il/files/2022/01/Logo-600.png" alt="Bright Data" height="30"/>
</a>
</p>
<p>
<sub>全球第一的 Web 数据平台</sub>
</p>
<br/>
<p>
<a href="https://github.com/bright-cn/brightdata-mcp">⭐ 欢迎为本仓库加星</a> •
<a href="https://www.bright.cn/blog">阅读我们的博客</a>
</p>
</div>
