mcpField
B
billing

billing

github.com/brightdata其他272135 次安装2 周前更新
代码仓库

关于 billing

用于读取 Bright Data 账户余额、用量成本和定价依据的技能,并据此报告带来源的估算。它严格限定为只读操作,并说明如何避免产生费用或泄露凭据。

主要功能

  1. 01读取账户余额和区域成本
  2. 02查询产品与域名成本数据
  3. 03依据用量单位和费率估算任务费用
  4. 04区分估算与 API 报价
  5. 05只读账单与凭据安全规范

适用场景

  1. 01查看账户当前支出
  2. 02按区域或域名归因成本
  3. 03估算抓取任务费用
  4. 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 balanceGET /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 返回的结果。请按以下三个步骤进行估算,并明确标注为估算值。

  1. 找出产品的计费单位。 Web Unlocker 和 SERP 按成功请求计费,失败的请求不收费,但有一种例外:启用自定义请求头或 Cookie 时,每个请求都会计费。返回多个结果页的 SERP 请求仍算作一个请求。Web Scraper API 按交付的记录数计费,因输入错误而失败的尝试仍会计费。Scraper Studio 按页面加载次数计费,文件下载则按 GB 另行收费。Browser API 和代理网络按流量 GB 计费,部分代理套餐则按 IP 收取固定费用。
  2. 统计计费单位,而非输入数量。 一个输入不等于一条记录。五个列表 URL 每个包含二十种商品,就会产生一百条记录。批量提交十个 URL,就会产生十个独立的计费请求。在 Scraper Studio 中,分页、详情页和额外导航都会分别计为页面加载。
  3. 使用账户自己的费率,而非公开价目表。 使用自定义按量付费或预付费套餐的账户有自己的费率,因此公开价目表可能不适用。对于 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 密钥,或让用户将密钥粘贴到聊天中

评论

支持 Markdown