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 - Billing
よくある質問は、アカウントがこれまでにいくら使ったか、そしてこのジョブにいくらかかるかです。前者はアカウントの実際の数値から正確に答えられます。後者は常に見積もりなので、その旨を伝えてください。
例外なしの読み取り専用
数値を読み取り、報告したら、そこで終了します。支払い方法の追加や変更、残高のチャージ、自動チャージの設定、プランの変更、データセットの購入、キャンセルは絶対に行わないでください。ユーザーから依頼された場合でも、こうした操作を行うのはエージェントではなく本人です。brightdata.com/cp/billing/settings に案内し、本人に操作してもらってください。
アカウントで何ができるか、または何にいくらかかるかを調べるために、実際のジョブを実行してはいけません。Web Unlocker リクエスト、スクレーパーの起動、ブラウザーセッションはいずれも料金が発生します。以下の読み取りはすべて無料で、何も開始しません。
読み取り操作
| 質問 | コマンド | 裏側で呼び出すエンドポイント |
|---|---|---|
| 残高はいくらか | bdata budget balance | GET /customer/balance |
| 1つのゾーンにかかった費用 | 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、続いてゾーンごとに1回ずつ /zone/cost |
| 各製品、ゾーン、データセット、ドメインにかかった費用 | CLI コマンドなし。直接呼び出します | POST /costs/export/json |
| スクレイピングにかかった費用 | CLI コマンドなし。直接呼び出します | Web Scraper API の場合は dimension を web_apis、Scraper Studio の場合は collectors に指定して、POST /costs/export/json |
| 削除済みを含む既存のゾーン | CLI コマンドなし。直接呼び出します | GET /zone/get_all_zones |
| どの Web サイトが予算を消費したか | 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 独自のストアから読み取ってください。OS ごとの正確なファイルパスと、値を表示せずに安全に読み取る方法は、agent-onboarding スキルの認証リファレンスに記載されています。このリファレンスには、エージェントがつまずきやすい点も記載されています。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 の5つの権限レベルがあります。請求とコストのデータには Finance または Admin が必要で、必要な権限が最も少ないのは Finance なので、こちらを優先してください。これらの読み取りには Finance キーを Authorization ヘッダーで直接使用してください。bdata login --api-key はフルアクセスのキーを必要とするため、CLI では Admin キーでログインした状態を維持し、API には Finance キーを使ってください。キーを作成または変更できるのはアカウント管理者のみです。brightdata.com/cp/setting/users で操作できます。401 はキーが存在しない、取り消されている、または間違っていることを示します。403 はキーが有効だが請求データの読み取りに必要な権限が不足していることを示します。再試行せず、不足しているアクセス権を伝えてください。Finance キーでは、スナップショットや Studio ジョブなどの製品データを読み取れない場合があります。この権限の分担に問題はありません。読み取れる範囲を報告し、もう一方のデータにはどのアクセス権が必要かを伝えてください。404 はスナップショット、ジョブ、またはデータセットの ID が間違っているか期限切れであることを示します。ゾーン名が間違っている場合は 422 が返されます。
budget コマンドを適切に使う
bdata budget の出力を信頼できるものにするには、3 つの習慣が重要です。budget zone と budget zones には、必ず --from と --to を指定し、数値が指定した期間だけを対象にするようにしてください。保留中の請求額については、GET /customer/balance から pending_costs を直接読み取ってください。また、機械可読な出力が必要な場合は、balance コマンドではなくエンドポイントを呼び出してください。
解析コードを書く前に、フィールド一覧と実際のレスポンス例、日付パラメーターの動作(これらのエンドポイントでは to は期間に含まれません)について記載された references/cost-api.md をお読みください。
ジョブの実行前に料金を見積もる
見積もりを返すエンドポイントはありません。そのため、API から取得した情報であるかのように提示してはいけません。次の 3 つの手順で見積もりを作成し、見積もりであることを明記してください。
- 製品の課金単位を確認します。 Web Unlocker と SERP はリクエストの成功ごとに課金され、失敗したリクエストは課金されません。ただし、カスタムヘッダーまたは Cookie を有効にした場合は、すべてのリクエストが課金されます。複数の検索結果ページを返す SERP リクエストも、1 件のリクエストとして扱われます。Web Scraper API は配信されたレコードごとに課金され、入力の誤りによる失敗も課金対象です。Scraper Studio はページ読み込みごとに課金され、ファイルのダウンロードは GB ごとに別途課金されます。Browser API とプロキシネットワークはトラフィックの GB ごとに課金されますが、一部のプロキシプランでは IP ごとの定額料金となります。
- 入力ではなく、課金単位を数えます。 入力 1 件がレコード 1 件とは限りません。商品をそれぞれ 20 件掲載した商品一覧 URL が 5 件なら、レコードは 100 件になります。URL を 10 件まとめたバッチは、課金対象のリクエスト 10 件です。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も同じプールを使用し、トラフィック1 MBあたり5クレジットを消費します(2026-09-01から適用)。そのため、毎月の無料枠全額でブラウザーのトラフィックを約1 GB利用できます。カスタム従量課金プランまたはプリコミットプランのアカウントには、毎月の無料クレジットは付与されません。
プロキシネットワークは対象外です。新規アカウントには、プロキシ製品用の2ドル分のトライアルクレジットが1回限りで付与され、有効期間は7日間です。また、支払い方法を追加すると、さらに5ドル分が付与され、有効期間は30日間です。これらの数値はすべてドキュメントに記載されているものです。登録完了時の呼び出しでは、新規アカウントのentitlements(monthly_credits、trial_credit_usd、trial_days)が、サインアップ時に一度だけ返されます(agent-onboardingスキルの「アカウントがまだない場合」を参照)。上記の請求情報を読み取るAPIでは、いずれもこれらの値は返されません。
**無料クレジットはどの請求APIにも含まれません。**残高フィールドに無料クレジットの残数はなく、/customer/balanceのcreditフィールドはクレジット数ではなく金額(ドル)です。無料枠とトライアルの状態は、brightdata.com/cp/billing/overviewのコントロールパネルにある「Free Tier Credits」で確認できます。更新日も表示されます。推測するのではなく、ユーザーにこのページを案内してください。また、金額残高がゼロだからといって、無料クレジットがなくなったと判断してはいけません。これらは別々のプールです。
MCP ツール呼び出しの請求対象
「エージェントのツール呼び出しにいくらかかったか」を確認する場合、どのツールを有効にしているか(groups=、tools=)によって料金が変わることはありません。search_engineとそのバッチ版はクエリごとに1リクエスト、scrape_as_markdown、scrape_as_html、scrape_batchはURLごとにWeb Unlockerのリクエスト1件、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_costsではなくpending_balanceを読む - コストのエクスポートに含まれるすべてのキーを日付と見なし、
totalを日数に加算する --fromと--toを指定せずにゾーンのコストを報告するback_m0をback_d0に加算したり、すべてのバケットにbwがあると仮定したりするreferences/cost-api.mdに記載されたproductsとの照合を行わず、空のコストエクスポートを支出がない証拠として報告する- 公開されている通常価格を、このアカウントに適用される料金として提示する
/zone/get_all_zonesと/zone?zone=でわかるにもかかわらず、ユーザーに利用中のプランやゾーンを尋ねる- 推定値を、見積もりエンドポイントが存在しないAPIからの見積もりであるかのように提示する
- ゾーンのパスワードを含む生の
/zone?zone=レスポンスをそのまま返す。bdata budget zone <name>はパスワードを含まない概要のみを出力します(CLI 0.4.1では、その--jsonと--prettyは親のbudgetコマンドに渡されて無視されます)。コストの確認にはこれを使うか、/zone/costを使用してください - APIキーを表示したり、ユーザーにチャットへ貼り付けるよう求めたりする