关于 brightdata-mcp
此技能用于配置和引导 Bright Data MCP,让 AI 应用在运行时选择数据抓取工具。内容涵盖托管的 Remote 与自托管 Local 版本、身份验证、工具筛选,以及如何将请求路由到合适的抓取工具。
主要功能
- 01配置 Remote 和 Local 版本
- 02说明身份验证与工具筛选
- 03将已知站点路由到抓取器
- 04使用 Markdown 抓取页面内容
- 05区分 MCP、CLI 和 SDK
适用场景
- 01将 MCP 客户端连接到 Bright Data
- 02排查工具列表差异
- 03指导 Agent 选择合适的抓取工具
MCP 相关
Bright Data 通过托管的 Remote 端点或经 stdio 运行的自托管 @brightdata/mcp 包,向 MCP 客户端提供数据抓取工具。此技能说明其设置、身份验证、工具选择和路由方式。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ brightdata/ skills --skill brightdata-mcp安装后在 Claude Code 中输入/brightdata-mcp确认已加载。
附带文件references/choosing-tools.mdreferences/setup.md
详细介绍
Bright Data MCP
MCP 是 AI 应用在运行时决定获取什么内容的接口。模型会读取 Bright Data 工具列表,并在每轮选择一个工具。这里没有可运行的 shell,也没有可在轮次之间编辑的代码路径,因此你公开的工具列表和编写的路由规则就是产品的全部界面。
如果由人或编码 Agent 在终端运行任务,请使用 brightdata-cli。如果同一任务由你自己的代码按计划运行,请使用 brightdata-sdk。MCP 用于运行时选择。
两种已出现差异的变体
Bright Data 提供两种变体,供应商称其为 Remote(托管服务,位于 mcp.brightdata.com)和 Local(可自托管的 @brightdata/mcp 包)。
| Remote | Local | |
|---|---|---|
| 端点 | https://mcp.brightdata.com/mcp(Streamable HTTP)或 /sse | 通过 stdio 运行 npx @brightdata/mcp |
| 身份验证 | 对于你控制的客户端,在 URL 上使用 ?token=;对于由其他人运行的客户端,使用 OAuth 2.1(Bearer 标头、浏览器登录) | API_TOKEN 环境变量 |
| 工具配置 | URL 查询参数 groups= 和 tools= | 环境变量 GROUPS 和 TOOLS |
| 默认工具列表 | 所有工具均启用,共 31 个;使用 groups= 或 tools= 缩小范围 | 所有工具均启用,共 32 个;使用 GROUPS 或 TOOLS 缩小范围 |
发布的包是 @brightdata/mcp。Remote 使用独立的发布版本序列。不要假定某个工具名称在一个变体中存在,在另一个变体中也存在;也不要跨变体沿用可用配置。请以实际使用的变体为准进行确认。
密钥
?token= 和 API_TOKEN 都需要账户 API 密钥。请像 CLI 一样查找:如果已设置 BRIGHTDATA_API_KEY,则使用它;否则从 bdata login 写入的 credentials.json 中读取 api_key(Linux:~/.config/brightdata-cli/,macOS:~/Library/Application Support/brightdata-cli/,Windows:%USERPROFILE%\AppData\Roaming\brightdata-cli\)。登录后该变量通常为空,密钥只存储在文件中:这表示机器已登录,而非缺少密钥,因此请在代码中读取它,绝不要打印。要检查密钥是否存在,请运行 agent-onboarding 技能中的 node scripts/check-auth.mjs(该命令绝不会打印密钥);绝不要对文件或变量使用 cat、echo 或 jq。要将密钥传入配置或 URL,请在写入配置的程序或命令中读取,并确保它不会出现在任何打印内容中(特定 shell 的读取方式见该技能的 references/auth.md)。如果两处都不存在密钥,请交由 agent-onboarding 处理。绝不要让用户把密钥粘贴到聊天中。
默认路由规则
对于 Agent 能指出名称的网站上的记录,使用预构建的抓取器:先用 search_scrapers 查找,再用 get_scraper_details 查看其输入,最后运行 run_scraper。页面内容使用 scrape_as_markdown。通过 scrape_as_html 获取未经处理的解锁 HTML 是最后的手段,而不是首选。这是最耗费 token 且返回数据质量最差的错误路由,因此请先阅读此规则,再编写提示词或工具说明。
参考资料
- references/setup.md - 首次连接客户端、Agent 看到的工具数量不正确,或需要在 Remote 和 Local 之间做选择时阅读。涵盖两种安装方式、身份验证、区域,以及
GROUPS和TOOLS过滤器。 - references/choosing-tools.md - 在编写 Agent 的系统提示词或工具指南之前,或者 Agent 正在抓取原始 HTML 以获取现成抓取器已能返回的数据时阅读。涵盖完整工具清单和路由表。