請求

クレジット表

Signal Foundry の操作ごとのクレジット消費、無料境界、再試行ルールを固定します。

このページの内容8項目

このページは、Signal Foundry のクレジット入出力です。

クレジットは data request と credit-consuming Signal read の両方を ledger で扱います。Signal Foundry の Company-first data endpoint を API / CLI から読むと Request Credit、一部の signal read では追加の Signal Credit を使います。

まず見る command

sf credits balance --json
sf credits summary --json
sf usage --json
sf query --file company-query.json --json

見る key:

balance.available_credits
balance.remaining_credits
balance.reserved_credits
balance.grants[]
summary.used_credits
summary.meterBreakdown[]
summary.usageBreakdown[]
usage_limits.remaining
usage_limits.limits.plan
query.executors.financial_gold.status
query.executors.financial_gold.result.matched_count
companies[].company.company_id
warnings[]
meta.coverage_warnings
meta.returned_companies

credits balance は「今実行できるか」を見ます。credits summary は「何が credit event を作ったか」を見ます。財務しきい値は自然文 q に残さず、company_query.v1 を作って sf query --file company-query.json --json で実行します。

Plan 付与

契約とクレジット付与の単位はチームワークスペースです。1 人で使う場合も、owner だけのチームワークスペースが API key、usage、billing の範囲になります。

Plan / 付与	Scope	Quota / Credit	Notes
Free quota	チームワークスペース	0 円、10,000 request credits/month から始まる探索枠	agent exploration
Pro quota	チームワークスペース	9,800 円/month 税込、higher monthly volume、rate headroom	本番・商用利用
Pro monthly credit grant	チームワークスペース	20,000 / month	credit ledger 付与
Credit Pack 10000	チームワークスペース	5,000 円税込、10,000 / purchase	3 ヶ月有効

個人向け checkout は通常導線にしません。個人 account は認証 identity と初期設定のために存在し、通常の実行範囲はチームワークスペースです。

Credit Pack は credit 残高を増やす one-time purchase です。plan quota、RPM、batch 上限、検索結果上限は増やしません。

Plan quota / rate boundary

Boundary	Free	Pro
Searches	1,000/day	5,000/month
Company Cards	2,000/day	10,000/month
Credit-consuming Signal reads	200/day	1,000/month
API rate limit	120 RPM	300 RPM
Search results	50/request	100/request
Signal results	50/request	100/request
Search offset	500 max	10,000 max
Page depth	10 max	no fixed cap
Batch resolve / batch signals	unavailable in Free	500 resolve / 100 signals

Batch / bulk endpoints は direct integration 用の上限を持ちますが、初回成功や通常の v0 公開 workflow の前提にはしません。複数会社を扱う通常導線では、Search JSON を agent 側でローカルに整形し、必要な会社だけ Company Card / Signals を読みます。

Operation schedule

Operation	Request Credit	Signal Credit	CLI
`company search`	1	0	`sf company search 7203 --json`
`company profile`	1	0	`sf company profile jpx_7203 --json`
`company cases`	1	1 when used as a credit-consuming signal read	`sf company cases jpx_6836 --json`
`company observations`	1	0	`sf company observations jpx_7203 --json`
`company filings`	1	1 when used as IR evidence	`sf company filings jpx_7203 --json`
`query`	1 when executable search runs	0	`sf query --file company-query.json --json`
根拠の確認	1	0	Company Card と company-level signals を読む
`job search`	1	0	`sf job search "<query>" --json`
`construction search`	1	0	`sf construction search "<query>" --json`
credit-consuming Signal read	1	signal 単位	`sf usage --json` と `sf credits summary --json` で利用量を確認
`credits balance` / `credits summary` / `feedback create`	0	0	`sf credits balance --json`

credits、usage、feedback などの確認・管理 endpoint は request credit の対象外です。

実行前の確認

credit-consuming Signal read や高い volume の利用前に、残高と直近利用を確認します。

sf credits balance --json
sf credits summary --json
sf credits summary --days 7 --limit 5 --json
sf usage --json

v0 の通常探索では、agent が sf company search の JSON からローカルリストやCSVを作ります。サーバー側 workspace 実行は compatibility surface です。

Idempotency

同じ書き込みを再試行する場合は idempotency を使います。

Surface	Required	Notes
CLI	command 側で safe retry を扱う。必要なら `--idempotency-key` を指定	失敗時は `error.suggested_next_commands` を見る
HTTP API	`Idempotency-Key` header	書き込み系 API で使う

同じ会社 / signal / idempotency key の再試行では二重消費しません。対象、上限、idempotency key を変える場合は別実行として扱います。

復旧方法

Error	次に見る command	復旧
`max_credits_required`	`sf <command> --help`	`--max-credits <n>` を付ける
`max_credits_exceeded`	`sf company search "<query>" --json`	検索条件や対象会社数を絞る
`credit_balance_insufficient`	`sf credits balance --json`	付与残高を確認する
`daily_search_quota_exceeded` / `monthly_search_quota_exceeded`	`sf usage --json`	reset_at を待つ、条件を絞る、Free なら Pro の月次 quota を使う
`daily_card_quota_exceeded` / `monthly_card_quota_exceeded`	`sf usage --json`	reset_at を待つ、読む会社を絞る、Free なら Pro の月次 quota を使う
`daily_deep_signal_quota_exceeded` / `monthly_deep_signal_quota_exceeded`	`sf usage --json`	signal read の対象を絞るか reset_at を待つ
`bulk_not_available_on_free`	`sf usage --json`	通常導線では Search JSON と必要な Company Card / Signals に分ける。direct integration で batch が必要なら Pro の batch 上限を確認する
`account_scope_conflict`	`sf auth show --json`	API key のチームワークスペース範囲に任せ、request 側の account 指定を外す

unsupported / weak / needs_human が返る場合は、クレジットを使う実行へ進みません。条件を分解して人間に確認してください。

次に読むページ

team plan: Access Plans
クレジット台帳: GET /credits/balance
usage summary: Usage Metering

請求