ユースケース

Claude Code で使う

Claude Code から Signal Foundry を安全にたどるための実務フローです。

このページの内容7項目

Signal Foundry は、Claude Code から CLI + JSON + 必要なときだけ HTTP API で使うのが最短です。このページでは、ユーザーが Claude Code に渡すときの実務フローを固定します。

基本ルール

最初に sf version --json --check-update と sf auth show --json で前提を見る
会社群や営業候補は sf company search で候補を出し、必要なら条件を短く分ける
取得は常に --json を付ける
テーマ語だけの依頼は、sf company search "<theme or criteria>" --json で根拠と weak 条件を確認する
Company Card は sf company profile <companyId> --card --json で読む
繰り返し実行や deep signal は sf credits balance --json と sf credits summary --json を見てから進める
profile や filings の前に必ず company search を使う
候補一覧や CSV は Signal Foundry に保存せず、agent 側のローカル成果物として作る
失敗時は error.code error.hint error.suggested_next_commands を次アクションに使う

Claude Code が 1 セッションでやること

sf version --json --check-update で CLI が古くないか確認する
sf auth show --json で接続前提を確認する
自然文の job を 会社検索 1社調査 有報差分 source-native 行検索 のどれかに分ける
必要なら sf <surface> --help を読む
会社群なら company search の候補をローカル表にする
1 社調査なら company_id や filing_id を解決する
JSON の要点だけを要約する
必要なら Company Card / cases / observations / filings まで進める

セッション開始時にやること

初回は、長いプロンプトを貼るのではなく、CLI の接続状態と agent skill の配置を確認します。

sf login --base-url https://signal-foundry.app --json
sf auth show --json
sf agent install --target claude-code --json

Codex で使う場合は sf agent install --target codex --json を実行します。すでに配置済みなら --force を付けて更新してください。

基本ループ

会社が分かっているとき:

sf company search 7203 --json
sf company profile jpx_7203 --json
sf company observations jpx_7203 --limit 5 --json

テーマから入りたいとき:

sf company search "生成AI CRM に反応している上場SaaS" --json
sf company profile <companyId> --card --json

テーマ根拠を確認してから、必要な会社だけ profile / observations / filings を読みます。今年上場した会社 のような上場日条件は coverage gap があれば代替条件を提案してください。

確認する key

version、update.current_version、update.latest_version、update.update_available
effectiveBaseUrl、authMode、oauth.tokenAvailable
status
unsupported_conditions
companies[].company.company_id
companies[].reason
meta.returned_companies
company
source_coverage
meta.request_credit

ローカル成果物まで進めるとき

候補企業を見つけた後に あとで見返せる状態 まで作るなら、Claude Code には Company Card を読ませ、ローカルの Markdown / CSV / JSON にまとめさせます。

sf company profile <companyId> --card --json
sf company cases <companyId> --limit 5 --json
sf company observations <companyId> --limit 5 --json

agent が必要な会社だけ抽出して手元の成果物にします。approval ワークフローと full monitor はまだ未提供側です。

Claude Code が止まりにくい運用

コマンドに迷ったら sf <surface> --help
company_not_found なら sf company search <query> --json
401 や 429 なら sf auth show --json
検索条件が長すぎるなら、自然文をやめて短い token と絞り込みに分解する

基本ルール

最初に sf version --json --check-update と sf auth show --json で前提を見る

会社群や営業候補は sf company search で候補を出し、必要なら条件を短く分ける

取得は常に --json を付ける

テーマ語だけの依頼は、sf company search "<theme or criteria>" --json で根拠と weak 条件を確認する

Company Card は sf company profile <companyId> --card --json で読む

繰り返し実行や deep signal は sf credits balance --json と sf credits summary --json を見てから進める

profile や filings の前に必ず company search を使う

候補一覧や CSV は Signal Foundry に保存せず、agent 側のローカル成果物として作る

失敗時は error.code error.hint error.suggested_next_commands を次アクションに使う

Claude Code が 1 セッションでやること

sf version --json --check-update で CLI が古くないか確認する

sf auth show --json で接続前提を確認する

自然文の job を 会社検索 1社調査 有報差分 source-native 行検索 のどれかに分ける

必要なら sf <surface> --help を読む

会社群なら company search の候補をローカル表にする

1 社調査なら company_id や filing_id を解決する

JSON の要点だけを要約する

必要なら Company Card / cases / observations / filings まで進める

セッション開始時にやること

初回は、長いプロンプトを貼るのではなく、CLI の接続状態と agent skill の配置を確認します。

sf login --base-url https://signal-foundry.app --json sf auth show --json sf agent install --target claude-code --json