成果物サンプル

このページは、Signal Foundry の live API が返す JSON を調査メモや候補リストへ 整形する型を示します。PDF や調査パックを自動生成する API の説明ではありません。

1 社の調査パック

まず公開 CLI で会社を解決し、Company Card と必要な Signals を読みます。

sf search "<company name or domain>" --json
sf company <companyId> --json
sf signals <companyId> --json

確認する key:

• companies[].company.company_id
• companies[].query_match
• company.company_id
• card
• meta.source_coverage
• signals
• gaps[]

成果物には次の順で残します。

説明:
- 対象会社と確認条件
- 使った source と期間

ファクト:
- 基本情報
- 財務、求人、事例、event など、JSON で確認できた値

示唆:
- 複数のファクトから判断した仮説
- 営業、投資、調査のどの用途に向けた判断か

evidence:
- source、URL、対象期、取得日時

gaps:
- 未確認、weak、unsupported

次の行動:
- 追加で読む Signals
- 人間が確認する項目

条件から候補リストを作る

自然言語条件は server-side planned search に渡せます。HTTP API から直接使う場合は、 POST /api/signal-foundry/search に planner_mode: "auto" を指定します。

curl -s \
  -X POST \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  -H "Content-Type: application/json" \
  "https://signal-foundry.app/api/signal-foundry/search" \
  --data '{
    "query": "東京都の情報通信業でAI求人を出している会社",
    "limit": 10,
    "planner_mode": "auto"
  }'

見る key:

• companies[].company.company_id
• companies[].source_context
• companies[].query_match
• planner.mode
• planner.decision_reason
• planner_runs[]
• meta.returned_companies
• meta.pagination_supported
• gaps[]
• warnings[]

planned_search_truncated がある場合は候補を完全な母集団として扱いません。cursor で 続けず、地域、業種、上場状態、求人条件などを明示的な filters に分けます。

候補表には company_id、採用理由、確認したファクト、evidence、gaps を同じ行に 残します。会社名だけのリストは、同名会社と判断根拠を後から確認できません。

大株主情報を追加する

大株主情報が必要な会社だけ Ownership API を読みます。

curl -s \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  "https://signal-foundry.app/api/signal-foundry/companies/<companyId>/ownership"

見る key:

• facts.major_shareholders.periods[]
• facts.major_shareholders.changes[]
• facts.ownership_relations
• gaps[]

大株主表は EDINET の開示原文と対象期を残します。ownership_relations は相互確認済みの 会社間関係だけです。gaps[] がある場合は「株主なし」「関係なし」と断定しません。

復旧方法

次に読む

• Search の HTTP 契約: Company Search API
• 1 社を深掘りする: 1社調査
• 大株主情報: Company Ownership API
• 財務条件を構造化する: 財務条件の Company Query