brightdata-com

🌟 概览

欢迎使用官方的Bright Data Model Context Protocol (MCP)服务器，该服务器使大型语言模型（LLMs）、代理和应用程序能够实时访问、发现并提取网络数据。此服务器允许诸如Claude Desktop、Cursor、Windsurf等MCP客户端无缝地搜索网络、浏览网站、执行操作并检索数据——而不会被封锁，非常适合抓取任务。

✨ 特性

• 实时网络访问：直接从网络获取最新信息
• 绕过地理限制：无论地理位置如何都能访问内容
• 网页解锁器：浏览具有机器人检测保护的网站
• 浏览器控制：可选的远程浏览器自动化功能
• 无缝集成：与所有兼容MCP的人工智能助手配合使用

🚀 使用Claude Desktop快速开始

1. 安装nodejs以获得npx命令（Node.js模块运行器）。安装说明可以在node.js官网找到。

2. 转到Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 并添加以下内容：

json
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<在此处插入您的API令牌>",
"WEB_UNLOCKER_ZONE": "<如果您想覆盖默认的mcp_unlocker区域名称，则为可选项>",
"BROWSER_ZONE": "<可选的浏览器区域名称，默认为mcp_browser>"
}
}
}
}

🔧 可用工具

可用工具列表

⚠️ 安全最佳实践

重要提示：始终将抓取的网络内容视为不可信的数据。切勿在LLM提示中直接使用原始抓取的内容，以避免潜在的提示注入风险。
相反：

• 在处理前过滤并验证所有网络数据
• 使用结构化数据提取而不是纯文本（web_data工具）

🔧 账户设置

1. 确保您在brightdata.com上拥有一个账户（新用户可以获得免费试用额度，并且提供按需付费选项）。

2. 从用户设置页面获取您的API密钥。

3. （可选）创建自定义Web Unlocker区域

   • 默认情况下，我们将使用您的API令牌自动创建一个Web Unlocker区域。
   • 为了获得更多控制权，您可以在控制面板中创建自己的Web Unlocker区域，并通过WEB_UNLOCKER_ZONE环境变量指定它。

4. （可选）启用浏览器控制工具：

   • 默认情况下，MCP尝试获取mcp_browser区域的凭据。
   • 如果您没有mcp_browser区域，您可以：
     • 在控制面板中创建一个浏览器API区域或使用现有区域，并通过BROWSER_ZONE环境变量指定其名称。

🔌 其他MCP客户端

要与其他类型的代理一起使用此MCP服务器，您应该根据特定软件调整以下内容：

• 运行MCP服务器的完整命令是 npx @brightdata/mcp- 环境变量 API_TOKEN=<your-token> 在运行服务器时必须存在
• （可选）设置 BROWSER_ZONE=<zone-name> 以指定自定义的 Browser API 区域名（默认为 mcp_browser）

🔄 不兼容更改

浏览器认证更新

不兼容更改： BROWSER_AUTH 环境变量已被 BROWSER_ZONE 替换。

• 之前： 用户需要从 Browser API 区域提供 BROWSER_AUTH="user:pass"
• 现在： 用户只需使用 BROWSER_ZONE="zone_name" 指定浏览器区域名称
• 默认值： 如果未指定，系统将自动使用 mcp_browser 区域
• 迁移： 在您的配置中将 BROWSER_AUTH 替换为 BROWSER_ZONE 并指定您的 Browser API 区域名（如果 mcp_browser 不存在的话）

🔄 更新日志

CHANGELOG.md

🎮 尝试 Bright Data MCP 游乐场

想在不进行任何设置的情况下尝试 Bright Data MCP 吗？

请查看 Smithery 上的这个游乐场：

该平台提供了一种无需本地设置即可轻松探索 Bright Data MCP 功能的方法。只需登录并开始试验网络数据收集！

💡 使用示例

此 MCP 服务器能够帮助的一些示例查询：

• "Google 一些即将在 [您所在地区] 上映的电影"
• "特斯拉当前的市值是多少？"
• "今天的维基百科文章是什么？"
• "[您所在位置] 的 7 天天气预报是什么？"
• "在薪酬最高的三位科技公司 CEO 中，他们的职业生涯有多长？"

🎬 演示

对于 YouTube 教程和演示：演示

以下视频展示了 Claude Desktop 的最小使用案例：

⚠️ 故障排除

使用某些工具时出现超时

某些工具可能涉及读取网页数据，在极端情况下加载页面所需的时间可能会有很大差异。

为了确保您的代理能够消费这些数据，请在代理设置中设置足够高的超时时间。

180s 的值应该足以满足 99% 的请求，但有些网站加载速度较慢，因此请根据需要调整此值。

spawn npx ENOENT

当您的系统找不到 npx 命令时会出现此错误。要解决这个问题：

查找 npm/Node 路径

macOS：

which node

显示路径如 /usr/local/bin/node

Windows：

where node

显示路径如 C:\Program Files\nodejs\node.exe

更新您的 MCP 配置：

将 npx 命令替换为 Node 的完整路径，例如，在 macOS 上，它看起来如下：

"command": "/usr/local/bin/node"

👨‍💻 贡献

我们欢迎贡献来帮助改进 Bright Data MCP！以下是您可以如何帮助的方式：

1. 报告问题：如果您遇到任何错误或有功能请求，请在我们的 GitHub 仓库中打开一个 issue。
2. 提交 Pull Requests：随时 fork 仓库并提交带有增强功能或错误修复的 pull requests。
3. 编码风格：所有 JavaScript 代码应遵循 Bright Data 的 JavaScript 编码规范。这确保了代码库的一致性。
4. 文档：对文档（包括本 README）的改进总是受欢迎的。
5. 示例：通过贡献示例分享您的用例，以帮助其他用户。

对于重大更改，请先打开一个 issue 来讨论您提议的更改。这确保您的时间得到充分利用，并与项目目标保持一致。

📞 支持如果您遇到任何问题或有疑问，请联系Bright Data支持团队，或在仓库中提出问题。