关于 billing
用于读取 Bright Data 账户余额、用量成本和定价依据的技能,并据此报告带来源的估算。它严格限定为只读操作,并说明如何避免产生费用或泄露凭据。
主要功能
- 01读取账户余额和区域成本
- 02查询产品与域名成本数据
- 03依据用量单位和费率估算任务费用
- 04区分估算与 API 报价
- 05只读账单与凭据安全规范
适用场景
- 01查看账户当前支出
- 02按区域或域名归因成本
- 03估算抓取任务费用
- 04说明账单访问权限不足
MCP 相关
说明 Bright Data MCP 工具调用的计费方式,包括搜索、抓取和浏览器工具的计费单位。未介绍 MCP 服务的实现方式。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ brightdata/ skills --skill billing安装后在 Claude Code 中输入/billing确认已加载。
附带文件references/cost-api.md
详细介绍
Bright Data - 账单
有两个问题:这个账户已经花了多少钱?这项任务会花多少钱?第一个问题可以根据账户自身的数据给出确切答案。第二个问题始终只是估算,因此要明确说明。
只读,没有例外
读取数字,报告结果,然后停止。绝不添加或更改付款方式,绝不充值,绝不设置自动充值,绝不更改套餐,绝不购买数据集,绝不取消任何内容。这些操作应由用户本人完成,而不是由 Agent 完成,即使用户要求 Agent 操作也不例外。请将用户引导至 brightdata.com/cp/billing/settings,让他们自行点击。
绝不通过运行实际任务来查明账户能做什么或某项服务的费用。Web Unlocker 请求、抓取器触发和浏览器会话都会产生费用。以下所有读取操作均免费,也不会启动任何任务。
查询方式
| 问题 | 命令 | 对应的端点 |
|---|---|---|
| 还剩多少钱 | bdata budget balance | GET /customer/balance |
| 某个区域的费用 | bdata budget zone <name> --from <date> --to <date> | GET /zone?zone=<name> 和 GET /zone/cost?zone=<name> |
| 所有活跃区域的费用 | bdata budget zones --from <date> --to <date> | GET /zone/get_active_zones,然后对每个区域调用一次 /zone/cost |
| 每种产品、区域、数据集或域名的费用 | 没有 CLI 命令,直接调用 | POST /costs/export/json |
| 抓取费用 | 没有 CLI 命令,直接调用 | POST /costs/export/json,Web Scraper API 使用 dimension web_apis,Scraper Studio 使用 collectors |
| 存在哪些区域,包括已删除的区域 | 没有 CLI 命令,直接调用 | GET /zone/get_all_zones |
| 哪个网站消耗了预算 | 没有 CLI 命令,直接调用 | GET /domains/req 和 GET /domains/bw,必须提供日期 |
| 快照交付了多少条记录 | 没有 CLI 命令,直接调用 | GET /datasets/v3/snapshots?dataset_id=<id>,读取 dataset_size |
基础主机是 https://api.brightdata.com,身份验证使用请求头 Authorization: Bearer <key>。从环境变量或 CLI 自身的存储中读取密钥。各操作系统对应的确切文件路径,以及安全读取且不打印密钥的方法,见 agent-onboarding 技能中的身份验证参考。该参考还说明了这里一个容易让 Agent 出错的地方:CLI 登录后,BRIGHTDATA_API_KEY 未设置是正常现象,并不表示机器已退出登录,因为登录会将密钥写入 CLI 的存储,而不会写入环境变量。绝不要要求用户在对话中粘贴密钥,也绝不要打印密钥:要检查密钥是否存在,请在 agent-onboarding 技能目录下运行 node scripts/check-auth.mjs,绝不要使用 cat、echo 或 jq 读取凭据文件或变量。
/zone/cost 只显示由区域计费的产品,例如 Web Unlocker、SERP、Browser API 和代理网络。Web Scraper API 和 Scraper Studio 的费用按数据集 ID 和采集器计算,而不是按区域名称计算,因此不会显示在该端点中。这些费用应通过费用导出查询。
哪个密钥可以读取这些数据
API 密钥分为五种权限级别:Admin、Finance、Ops、User 和 Limit。账单和费用数据需要 Finance 或 Admin 权限,其中 Finance 权限最低且足够使用,因此优先使用。对这些读取操作,直接在 Authorization 请求头中使用 Finance 密钥:bdata login --api-key 要求使用具有完全访问权限的密钥,因此请让 CLI 保持 Admin 密钥的登录状态,并将 Finance 密钥用于 API。只有账户管理员可以在 brightdata.com/cp/setting/users 创建或更改密钥。401 表示密钥缺失、已撤销或错误。403 表示密钥有效,但权限不足以访问账单数据;请指出缺少的权限,而不要重试。Finance 密钥可能无法读取快照或 Studio 任务等产品数据,这种权限区分没有问题:报告可以读取的部分,并说明另一部分需要哪种权限。404 表示快照、任务或数据集 ID 错误或已过期;区域名称错误则会返回 422。
妥善使用预算命令
养成三个习惯,确保 bdata budget 的输出可靠。始终为 budget zone 和 budget zones 传入 --from 和 --to,确保数值准确覆盖你指定的时间范围。对于待处理费用,直接从 GET /customer/balance 读取 pending_costs。如果需要机器可读的输出,请调用端点,而不是余额命令。
编写任何解析代码之前,请先阅读 references/cost-api.md,了解字段列表和实时响应示例,包括日期参数的行为(这些端点上的 to 不包含在范围内)。
运行前估算任务成本
没有任何端点会返回报价,因此绝不要把估算说成是 API 返回的结果。请按以下三个步骤进行估算,并明确标注为估算值。
- 找出产品的计费单位。 Web Unlocker 和 SERP 按成功请求计费,失败的请求不收费,但有一种例外:启用自定义请求头或 Cookie 时,每个请求都会计费。返回多个结果页的 SERP 请求仍算作一个请求。Web Scraper API 按交付的记录数计费,因输入错误而失败的尝试仍会计费。Scraper Studio 按页面加载次数计费,文件下载则按 GB 另行收费。Browser API 和代理网络按流量 GB 计费,部分代理套餐则按 IP 收取固定费用。
- 统计计费单位,而非输入数量。 一个输入不等于一条记录。五个列表 URL 每个包含二十种商品,就会产生一百条记录。批量提交十个 URL,就会产生十个独立的计费请求。在 Scraper Studio 中,分页、详情页和额外导航都会分别计为页面加载。
- 使用账户自己的费率,而非公开价目表。 使用自定义按量付费或预付费套餐的账户有自己的费率,因此公开价目表可能不适用。对于 Web Unlocker 和 SERP,你可以计算实际费率:通过
from和to向/zone/cost查询一个时间段,然后用custom分类中的cost除以请求数。如果该分类同时包含reqs_unblocker和reqs_serp,则要除以两者之和,因为该费用是此区域的一笔合计金额(实时数据)。对于 Web Scraper API,记录数可通过读取GET /datasets/v3/snapshots?dataset_id=<id>中的dataset_size获取;金额则可在费用导出数据中按数据集查看web_apis(实时数据),或在有归属信息时按快照查看ws_api_snaps。如果读取结果有数据,就据此计算实际的单条记录费率。如果账户没有历史用量,请从GET /pricing_plans读取该账户自己的套餐(需要 Admin 或 Finance 密钥;选择is_current: true的套餐及其product_prices,其中req表示每 1,000 个请求的费率)。只有在该读取被拒绝时,才打开公开价目表brightdata.com/pricing(Web Scraper API 使用brightdata.com/pricing/web-scraper),并说明这是公开标价,而非该账户的费率。绝不要凭记忆报价,因为价格会变动。在回复中注明你读取的数据来源。
免费额度
每个符合条件的账户每月都会从共享额度池中获得 5,000 个免费额度。额度在每月 1 日重置,未使用的额度会作废,不会结转。Web Unlocker、SERP 和 Web Scraper API 每次请求或每条记录消耗 1 个额度;Scraper Studio 每次页面加载消耗 1 个额度。Browser API 使用同一个额度池,每 MB 流量消耗 5 个额度(自 2026-09-01 起生效),因此每月的全额额度可支持接近 1 GB 的浏览器流量。采用自定义按量付费计划或预付费计划的账户,每月不会获得免费额度。
代理网络不在覆盖范围内。新账户可获得一次性 $2 代理产品试用额度,有效期为 7 天;添加付款方式后,还可获得额外的 $5,有效期为 30 天。以上数据均来自文档。注册完成调用会在注册时一次性返回全新账户的 entitlements(monthly_credits、trial_credit_usd、trial_days)(参见 agent-onboarding 技能中的 No account yet)。上述计费查询均不会返回这些信息。
任何计费 API 都不会提供免费额度。 没有任何余额字段会统计免费额度,/customer/balance 中的 credit 字段表示美元,而不是额度数量。免费层级和试用状态可在 brightdata.com/cp/billing/overview 控制面板的 Free Tier Credits 下查看,其中也会显示续订日期。请引导用户前往该页面,不要猜测,也绝不要把金额余额为零视为免费额度已用尽的证据。它们属于不同的额度池。
MCP 工具调用的计费方式
关于“我的 Agent 的工具调用花了多少钱”,启用了哪些工具(groups=、tools=)不会改变任何费用。search_engine 及其批处理变体按每条查询计为一次请求;scrape_as_markdown、scrape_as_html 和 scrape_batch 按每个 URL 计为一次 Web Unlocker 请求;run_scraper 按交付的 Web Scraper API 记录计费;scraping_browser_* 按 Browser API 带宽计费。凭证不会造成差异:使用 ?token= 的远程客户端和使用 OAuth 2.1 的客户端可以调用相同的工具,也会使用同一账户的额度,因此 OAuth 客户端消耗的是用户登录的 Bright Data 账户额度,该账户可能不是此处的账户。
后续阅读
- 调用以下任何端点之前: references/cost-api.md——精确路径、参数、真实响应结构、11 个成本维度,以及哪些信息已通过账户实时验证,而不只是从文档中读取。
- 读取遭拒时:
agent-onboarding技能。这些端点收到缺失或无效的密钥时会返回 401 和简短的纯文本响应;CLI 则会返回No API key found。这两种情况都表示需要登录。
风险提示
- 代替用户添加付款方式、充值或更改计划
- 为了查明费用而运行真实任务或发送单次测试请求
- 从实时余额响应中读取
pending_balance,而不是pending_costs - 将成本导出的所有键都当作日期,导致把
total加进天数中 - 报告区域费用时未提供
--from和--to - 将
back_m0加到back_d0上,或假设每个分桶中都存在bw - 未按
references/cost-api.md所述与products交叉核对,就将空成本导出报告为没有消费 - 把公开标价说成该账户的实际费率
- 在
/zone/get_all_zones和/zone?zone=能回答时,还询问用户使用哪个计划或区域 - 把估算说成 API 报价,而 API 并没有估算端点
- 原样回显
/zone?zone=的响应,其中包含区域密码。bdata budget zone <name>只会打印摘要,不会显示密码(在 CLI 0.4.1 中,其--json和--pretty参数会被父级budget命令接收并忽略);请使用该命令或/zone/cost查询费用 - 打印 API 密钥,或让用户将密钥粘贴到聊天中