ガイド更新日:
2026-10-17 確認の公式 v2 枠 API、OpenAPI と請求文書に基づく実装です。実チームの Key、ログイン後の導線、権限と枠の照合はユーザーテスト待ちです。代理ログイン、クロール、入金や権限変更は行っていません。
- 必要な認証情報
- 対象チームの Firecrawl API Key(fc- 接頭辞)
- 監視単位
- Credits · チーム作業単位、通貨ではない(XXX)
- 監視の対象
- 公式チーム作業 Credits 残量 · 現金ではない
- 固定 GET https://api.firecrawl.dev/v2/team/credit-usage のみ。Bearer 認証、クエリ/本文やリダイレクトなし。firecrawlCredits.remainingCredits は Key 所属チームの残枠です。planCredits はクーポン/PAYG 追加分を除き、差引で使用量や割合を算出しません。現金・費用・金銭予算・残日数・API 可用性は null です。
Key を保存せずチーム枠を手動確認
- Firecrawl アプリにログインし、実際に業務で使うチームを選びます。
- Billing でチーム Credits、プランと追加枠を個別に確認し、現金や単一 Key 上限と混同しません。
- 実際の期間と非同期精算を考慮し、欠落日付を推測せず、共有 Key を合算しません。
Firecrawl · チーム作業 Credits を Quota Monitor に接続する
正しい Firecrawl チームを選ぶ
公式アプリで業務に使うチームを選択し、API Keys を開きます。個人アカウント、別チームや当サイトのプロジェクト名で代用できません。
先に Billing で既存プランとチーム Credits を確認します。監視のために購入や PAYG 有効化をせず、既存チームの公式機能を照合します。
独立した監視 Key を作成し私的に保管
API Keys の新規 Key 入口で独立した資格情報を用意し、QuotaMonitorCredits 等の名前を付けます(Key メニューの Rename も使用可能)。fc- Secret 全体を私的に保存し、Key ID や末尾表示と混同しません。ログイン後の作成導線はユーザー検証待ちです。
通常の Key は有料作業を実行でき、枠専用の読み取り scope はありません。重要な業務 Key は避けてください。保管リスクを受け入れられない場合は Secret を提出せず、下記の手動 Billing を使います。
実際の最小権限の限界を理解
既存 Key メニューの Set limit は日/週/月の Credit 支出上限を設定しますが、読み取り専用にはなりません。この接続のために上限や権限を変えず、既存の安全設定を維持します。
Enterprise の Restrictions は端点グループ/出力形式を制限し、/v2/team/* メタデータには常に到達できます。account-only 設定は未公開で、空の許可リストは拒否ではなく無制限です。権限 JSON を作り上げず、アップグレードや利用申請もしません。
プロジェクトで作業枠接続を選択
Quota Monitor の対象プロジェクトで接続を追加し、Firecrawl · チーム作業 Credits と接続名を選びます。MCP の安全な入力リンクも同じ種類です。AI 会話やツール引数に Key を送らないでください。
通貨、チーム/プロジェクト/Key フィルターや金銭予算は設定しません。XXX は非通貨で USD ではありません。当サイトのプロジェクトは Firecrawl のウォレット作成やチーム枠の分割を行いません。
完全な Key をマスク欄だけに入力
fc- から始まる監視 Secret 全体を安全なフォームのパスワード欄に貼り付けて保存します。Bearer、URL や JSON を付けません。暗号化して保存し、他の画面は末尾 4 文字のみ表示します。構文検査でチームや権限までは証明できません。
ヘルプは入力を読み取ったり送信せず、この公開ガイドを表示します。閉じて入力を続け、キャンセル時は消去します。Secret をスクリーンショット、問い合わせや会話に含めません。
初回同期を原フィールドで照合
初回同期を待つか枠の更新を使い、新しい成功日時を確認します。remainingCredits が主値で、planCredits と報告期間は別表示です。任意項目の欠落はゼロではなく不明です。
remainingCredits=7500、planCredits=5000 でも正常な場合があり、負の使用量や残り 150% と表示しません。残高、費用、percentageRemaining、providerAvailable は null のまま、USD 換算もしません。
同じチームの Billing と比較
同じチームの Billing に戻り、残 Credits、プラン、追加枠と直近成功時刻を個別に確認します。API は追加種類別残量を返さないため、二項目の差から内訳を推定できません。
billingPeriodStart/billingPeriodEnd は報告された期間境界で、全 Credits の同時リセット/失効を保証しません。非同期処理の精算中は後で再確認し、未報告の日付を自然月初、推測の時差や入金日で補いません。
安全な排障とローテーション
401/403 は完全な Key、選択チーム、失効と既存権限を確認します。404 は公式端点の提供状況、429 は待って再試行します。有料クロールで試験しません。取得/形式エラー時は前回成功値と日時を維持し、新規成功と扱いません。
安全な更新フォームから独立した監視 Key のみを交換し、成功後に旧監視 Key を処置します。業務 Key は変更しません。Cookie 提出、入金、ロール昇格や権限変更で排障せず、Secret のないエラーコードだけを共有します。
Quota Monitor が取得する Firecrawl · チーム作業 Credits のデータ範囲
- チーム Key、ツールと当サイトのプロジェクトで共有する枠で、単一 Key の上限ではありません。重複接続を合算せず、米ドルや返金可能な資金に換算しません。
- remainingCredits は planCredits を上回る場合があります。後者はクーポン/PAYG 追加分を含まず、差額から購入・特典・クーポン別残量を推測できません。
- 公式 billingPeriodStart/billingPeriodEnd だけを表示し、欠落/null は不明のままです。実際の更新日、年払いの月次期間と特定の繰越は、全追加 Credits の一律失効/リセットとは異なります。
- 非同期処理の精算は遅れる場合があり、取得時刻は精算完了時刻ではありません。PAYG 等ではゼロ/負でも全作業停止とは限らず、低現金残高や金銭的な残日数アラートも適用しません。
- 枠と期間は報告時点の値で、精算完了時刻ではありません。未報告の日付は不明のまま、期間末を一律のリセット/失効日と扱いません。更新失敗時は前回の値と日時を維持します。
Firecrawl · チーム作業 Credits のよくある質問とトラブルシューティング
- 現金残高ではないのはなぜ?
- Credits はクロール等の作業単位です。チーム remainingCredits を取得し、ウォレット、請求書や定価計算費用は取得しません。一律のドル換算はなく、Key の spend limit もチーム枠とは別です。
- 残量がプラン枠を超えるとエラー?
- 必ずしもそうではありません。planCredits はクーポン/PAYG 追加分を除き、範囲が異なります。そのまま報告し、差引で使用量、割合や追加種類別残量を作りません。
- Key を読み取り専用にできる?
- 適用可能な account-only scope は見つかりません。通常 Key は有料作業を実行でき、支出上限でも読み取り専用にはなりません。Enterprise の空許可リストも全拒否ではありません。権限 JSON の創作、アップグレードや権限変更はしません。
- 期間末ですべてリセットする?
- いいえ。billingPeriodStart/billingPeriodEnd の報告値のみで、欠落は null/不明です。更新、特定の繰越、購入とクーポンの規則は異なり、一律の失効日にはしません。
- ゼロ/負 Credits や古い値は停止を意味する?
- 保証しません。PAYG や非同期精算で利用可能な作業が異なり、providerAvailable は不明です。同期失敗では前回の値と日時を保持するため、公式チーム Billing も確認します。
- 401、403、404、429 や形式エラーの対処は?
- 同じチームの完全な fc- Key と既存権限を確認し、429 は待ちます。継続する場合は公式に Secret のないコードを伝えます。remainingCredits の欠落や不正な数字/日付はゼロではなく失敗です。Cookie 提出、有料クロールやロール変更は不要です。
Firecrawl · チーム作業 Credits の公式資料
- 公式資料 · docs.firecrawl.dev/api-reference/endpoint/credit-usage(新しいタブで開きます)
- 公式資料 · docs.firecrawl.dev/api-reference/v2-openapi.json(新しいタブで開きます)
- 公式資料 · docs.firecrawl.dev/billing(新しいタブで開きます)
- 公式資料 · docs.firecrawl.dev/features/key-restrictions(新しいタブで開きます)
- 公式資料 · docs.firecrawl.dev/api-reference/introduction(新しいタブで開きます)
- 公式資料 · docs.firecrawl.dev/introduction(新しいタブで開きます)
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。