概要
company_id の使い方
検索語から `company_id` を解決し、そのあとに使う CLI command を整理します。
このページの内容6項目
Signal Foundry を使い始めるときに、最初に覚えるルールは 1 つです。
検索語をそのまま profile や filings に渡さず、必ず先に company search で company_id を解決する。
この company_id が、以降の会社 profile、observation、filing の共通キーです。
まず company_id を解決する
company search は、次のような入力から正規化済みの会社候補を返します。
- 証券コード
- 社名
- 既知の識別子
sf company search 7203 --json sf company search トヨタ --listing-status listed --json
この結果で最低限保持したいのは次です。
company.company_idcompany.display_namequery_match
次に使う command
| 目的 | CLI | 返るもの |
|---|---|---|
| 会社候補を解決する | sf company search <query> --json | 会社候補、match 情報、簡易 profile |
| 1 社の profile を見る | sf company profile <companyId> --json | 会社、identifiers、profile |
| 1 社の observation を見る | sf company observations <companyId> --json | 根拠付き observations |
| 1 社の filing 一覧を見る | sf company filings <companyId> --json | filing 一覧 |
| IR Signals を見る | sf signals <companyId> --include ir --json | 事前生成された IR signal |
| filing evidence を確認する | sf company filings <companyId> --json | filing id、artifact、summary metrics |
何を受け取ったら次へ進むか
company search の次に見る値:
companies[0].company.company_idcompanies[0].company.display_namemeta.returned_companies
company profile の次に見る値:
company.company_ididentifiersprofile.website_domain
company observations の次に見る値:
observations[].sourceobservations[].typeobservations[].summaryobservations[].evidence
company filings の次に見る値:
filings[].filing_idfilings[].document_typefilings[].submitted_at
よくある間違い
間違い:
sf company profile 7203 --json
推奨:
sf company search 7203 --json sf company profile jpx_7203 --json
profile や filings が受け取るのは検索語ではなく company_id です。検索語しか持っていない段階では、常に company search から始めます。
Claude Code / Codex に教えるべきこと
エージェントに渡すときは、次の 3 点を明示してください。
company_idは先に解決する- 各コマンドは
--jsonで実行する - 失敗時は
error.hintとerror.suggested_next_commandsをそのまま次アクションに使う
この 3 つを守ると、初回の詰まり方を減らせます。
次に読むページ
- 初回接続を確認する: クイックスタート
- 1 社調査の流れを見る: 1社調査
- エージェント運用の基本ルールを見たい: Claude Code ワークフロー