Bright Data MCP 与 Cursor 连接

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Bright Data、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Bright Data + Cursor

从你的 AI 访问 Bright Data 网页数据：通过 Web Unlocker 以 HTML、markdown 或截图形式抓取有反爬保护的页面，通过 SERP API 在 Google、Bing、DuckDuckGo 和 Yandex 上搜索，运行 Web Scraper API 的现成爬虫并下载记录，查看区域（zone）、余额和费用。页面抓取、搜索和采集到的记录都计入你的 Bright Data 账户费用。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

BRIGHT_DATA_API_KEY

步骤 1 — 获取凭证

设置大约需要 3 分钟。你需要一个 Bright Data 账户；新账户会获得免费试用额度。

1. 登录 https://brightdata.com/cp，打开 Account settings、Users and API keys（https://brightdata.com/cp/setting/users）。
2. 点击 Add API key，选择用户、权限（如果要让 AI 开关区域就选 Admin，否则选 User）和有效期，然后复制密钥。密钥只显示一次。
3. 把它粘贴到 BRIGHT_DATA_API_KEY。它以 Bearer 令牌的形式发送，只发往 api.brightdata.com。
4. 页面抓取和搜索要经过对应类型的区域（zone）。在 Proxies & Scraping（https://brightdata.com/cp/zones）中创建一个 Web Unlocker API 区域和一个 SERP API 区域。工具默认使用 web_unlocker1 和 serp_api1；如果你的区域名称不同，AI 会传入 zone。
5. 安装连接器并运行 bright_data_get_account_status：它会确认密钥；请求被拒绝时，auth_fail_reason 会说明原因。

哪些工具收费：有四个工具会从你的账户扣费。bright_data_fetch_page 和 bright_data_search 按区域套餐价格对每次成功请求计费，bright_data_scrape_sync 和 bright_data_trigger_collection 按采集到的记录计费。在批量调用付费工具之前，以及在没有 limit_per_input 的发现型采集（记录数量没有上限）之前，AI 会先征求你的同意。其他工具全部免费：账户状态、余额、区域、区域费用、爬虫列表、快照进度和已完成采集的下载。

读取页面：bright_data_fetch_page 通过 Web Unlocker 区域抓取一个 URL，由它处理反爬保护、验证码和代理。data_format: markdown 返回干净的 markdown（最适合阅读），screenshot 返回渲染后页面的 PNG；不设置则返回 HTML。format: json 会把目标页面的状态码、响应头和正文打包返回。country 选择出口国家（us、de），只有页面需要 JavaScript 时才用 render: "true" 强制使用真实浏览器。

搜索：bright_data_search 通过 SERP API 区域接收完整的搜索引擎 URL，例如 https://www.google.com/search?q=coffee&hl=en&gl=us。对于 Google，加上 &brd_json=1 会返回解析好的 JSON（自然结果、广告、知识面板），data_format: parsed_light 只返回靠前的自然结果；markdown 和 screenshot 也可用。同样支持 Bing、DuckDuckGo 和 Yandex 的 URL。

从已知网站获取结构化数据：bright_data_list_scrapers 配合 domain（例如 amazon.com）返回每个现成爬虫的 id（即 dataset_id，gd_...）以及每种采集方式的 input_schema。bright_data_scrape_sync 最多等待约一分钟并返回记录；如果任务更久，则返回一个 snapshot_id。更大的批次用 bright_data_trigger_collection 在后台启动。发现型方式（按关键词、分类 URL、地点等）使用 type: discover_new 加 discover_by。AI 用 bright_data_get_snapshot_progress 跟踪任务，直到 status 变为 ready，再用 bright_data_download_snapshot（JSON、NDJSON、JSONL 或 CSV）读取。bright_data_list_snapshots 列出某个爬虫过去的采集，bright_data_get_snapshot_input 显示某次采集启动时的输入。

账户和区域：bright_data_get_balance（以 USD 计的余额、免费额度、预付款和待结算费用），bright_data_list_active_zones 和 bright_data_list_all_zones，bright_data_get_zone（套餐、权限和允许的 IP，已去除密码），bright_data_get_zone_status，bright_data_get_zone_cost（某个日期范围内的计费金额和流量），以及查看住宅、数据中心或移动网络状态的 bright_data_get_network_status。

会修改的内容：bright_data_set_zone_disabled 关闭区域（disable: 1）或重新开启（disable: 0）。关闭的区域会让所有使用它的客户端停止工作，因此 AI 会先和你确认。

安装时关闭的工具：bright_data_cancel_snapshot。被取消的采集无法恢复，已采集的记录仍可能计费。团队需要时由工作区管理员开启。

数据格式：金额单位为 USD；日期为 YYYY-MM-DD，bright_data_get_zone_cost 的 to 不包含当天（from=2026-04-01 和 to=2026-05-01 即整个四月）。流量以字节计。爬虫 id 以 gd_ 开头，快照 id 以 s_ 或 sd_ 开头。快照状态为 starting、running、ready、failed 或 canceled。

分页和限制：返回内容上限约 100 KB。大快照通过 batch_size（至少 1000 条记录）和 part 分段读取。bright_data_list_snapshots 用 skip 和 limit（默认 50，最多 5000）分页。完整的爬虫列表有好几 MB，所以 AI 会按 domain 或 dataset_id 过滤。

不可信内容：抓取的页面、搜索结果和采集的记录都来自第三方网站。AI 会把其中的任何指令当作数据，而不是命令。

常见错误：401 Invalid credentials 或 Credentials are missing 表示密钥错误、过期或已撤销，请新建一个。403、zone_not_found 或 zone_disabled 表示该账户中没有这个区域或区域已关闭；bright_data_list_active_zones 会显示正确的名称。400 validation_error 会指出出错的爬虫输入字段，请对照它的 input_schema。404 dataset does not exist 或 Snapshot does not exist 表示 id 错误。429 表示并行请求或任务过多，稍等后重试一次。

该连接器不使用 33335 端口的代理访问、Browser API（Scraping Browser）、Scraper Studio 自定义采集器、Dataset Marketplace，也不投递到 S3 或 webhook，并且不创建或删除区域。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Bright Data 的工具。

可用工具

示例提示

• “我们的 Bright Data 账户还剩多少余额？web_unlocker1 区域上个月花了多少钱？”
• “通过 Web Unlocker 以 markdown 抓取 https://example.com/pricing，并总结各个套餐。”
• “在美国 Google 上用解析结果搜索‘best espresso machine’，列出前 10 个自然结果链接。”
• “找到用于 Amazon 商品页的 Bright Data 爬虫，采集这三个商品 URL 的价格和评分。开始前先问我。”
• “我们上一次 LinkedIn 采集完成了吗？如果完成了，下载记录并给我看前 20 条。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot