概要
Company ID Surface Map
Signal Foundry の surface は `company_id` を中心につながっています。検索語から company を解決し、そのあとにどの endpoint / CLI command を使うかを整理します。
このページの内容6項目
Signal Foundry を使い始めるときに、最初に覚えるべきルールは 1 つです。
検索語をそのまま profile や filings に渡さず、必ず先に companies search で company_id を解決する。
この company_id が、以降の surface の共通キーです。
まず company_id を解決する
companies search は、次のような入力から canonical company 候補を返します。
- 証券コード
- 社名
- 既知の識別子
CLI:
sf companies search 7203 --json sf companies search トヨタ --listing-status listed --json
HTTP API:
curl -H 'x-api-key: <SIGNAL_FOUNDRY_API_KEY>' \ 'https://signal-foundry.app/api/signal-foundry/companies?q=7203&limit=3'
この結果で最低限保持したいのは次です。
company.company_idcompany.display_namequery_match
surface 対応表
| 目的 | CLI | HTTP API | 返るもの |
|---|---|---|---|
| 会社候補を解決する | sf companies search <query> --json | GET /api/signal-foundry/companies?q=<query> | company 候補、match 情報、簡易 profile |
| 1 社の canonical profile を見る | sf company profile <companyId> --json | GET /api/signal-foundry/companies/{companyId}/profile | company、identifiers、profile |
| 1 社の観測を見る | sf company observations <companyId> --json | GET /api/signal-foundry/companies/{companyId}/observations | evidence 付き observations |
| 1 社の filing 一覧を見る | sf company filings <companyId> --json | GET /api/signal-foundry/companies/{companyId}/filings | filing 一覧 |
| 単一 filing の detail を見る | sf filing show <companyId> <filingId> --json | GET /api/signal-foundry/companies/{companyId}/filings/{filingId} | metrics、sections、facts |
| filing を比較する | sf filing compare <companyId> <filingId> --json | GET /api/signal-foundry/companies/{companyId}/filings/{filingId}/compare | 直前 filing との差分 |
何を受け取ったら次へ進むか
companies 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 companies search 7203 --json sf company profile jpx_7203 --json
profile や filings が受け取るのは検索語ではなく company_id です。検索語しか持っていない段階では、常に companies search から始めます。
Claude Code / Codex に教えるべきこと
agent に渡すときは、次の 3 点を明示してください。
company_idは先に解決する- 各コマンドは
--jsonで実行する - 失敗時は
error.hintとerror.suggested_next_commandsをそのまま次アクションに使う
この 3 つだけで、初回の詰まり方はかなり減ります。
次に読むページ
- 実際の初日ループを見たい: First Day Playbook
- agent にそのまま渡す prompt が欲しい: Claude Code / Codex で始める