Company Search と Profile

Signal Foundry の最初の 1 手は、必ず company を解決することです。自由入力をそのまま downstream endpoint に渡すのではなく、まず company_id を確定してください。

入口 surface

• GET /api/signal-foundry/companies
• GET /api/signal-foundry/companies/{companyId}/profile

companies でできること

• 社名や証券コードで会社を探す
• 登録済み identifier から exact match する
• listing_status (listed / delisted / unknown) で絞る
• market_segment で絞る
• has_website で絞る

検索結果は company profile query_match を 1 セットで返します。query_match.relevance によって候補の並び順が決まるため、agent は上位候補から profile へ進めば十分です。

profile で返るもの

• canonical company
• identifiers
• latest observed state
• website 情報と key site sections
• materialized company profile
• observation counts

典型的な使い方

CLI:

sf companies search 7203 --json
sf company profile jpx_7203 --json

HTTP API:

curl -H 'x-api-key: <SIGNAL_FOUNDRY_API_KEY>' \
  'https://signal-foundry.app/api/signal-foundry/companies?q=7203&limit=3'

curl -H 'x-api-key: <SIGNAL_FOUNDRY_API_KEY>' \
  'https://signal-foundry.app/api/signal-foundry/companies/jpx_7203/profile'

使い分け

• companies: company set を探す、あるいは company_id を解決する
• profile: 1 社の現在地を確認する

注意点として、profile に自由入力の検索語を直接渡すのは避けてください。まず companies で company_id に解決するのが正しい順序です。

API key request の companies は broad search abuse を避けるため、広すぎる free-text 検索を制限します。検索が弱いときは、社名より証券コードや既知 identifier を優先してください。

このページは company layer の基本導線です。company 解決のあと、必要なら observations search で横断探索し、list や research に最小保存するところまでは current public surface に含まれます。