ユースケース
Signal Foundry を目的から使うための入口です。会社検索、Company Card、Signals のどこから始めるかを選びます。
このページの内容8項目
このページは、API や CLI の一覧ではありません。完了したい仕事から、最初に実行する command と読むページを選ぶための入口です。
Signal Foundry の公開 core は、Search、Company Card、Signals、Usage です。 CLI が実行し、JSON の結果で成功を確認し、UI は結果と利用状況を読みます。
最初に実行するもの
どのユースケースでも、最初に company_id を解決します。
sf search "<company name or criteria>" --json sf company <companyId> --json
見る key:
companies[].company.company_idcompanies[].cardcompanies[].query_matchmeta.returned_companiescardsource_coverage
目的別の入口
| 始点 | やりたいこと | 最初に読む | 主な成果物 |
|---|---|---|---|
| 会社から始める | 1 社を深掘りする | 1社調査 | card, signals, evidence |
| 条件から始める | 条件に合う会社候補を探す | Company Search | companies[], local list, card |
| 手元の営業リストから始める | 各行を会社へ名寄せし、確定した会社だけを保存する | 営業リストの名寄せ | 判定 CSV / JSON, Saved List |
| 財務条件から始める | 財務しきい値やランキングを構造化する | 財務条件の Company Query | company_query.v1, matched_financial_facts |
| テーマ / seed 会社から始める | 市場テーマや seed 会社から候補を広げて比較する | 市場調査 | companies[], 比較軸, card, evidence |
| 検索の内部を知りたい | query と filter がどう評価されるかを確認する | 自然言語検索の解決 | query_match, gaps, 明示した条件 |
| 成果物から始める | 調査パックや候補リストの型を確認する | 成果物サンプル | facts, evidence, gaps, next actions |
| エージェントに渡す | Codex / Claude Code に任せて進める | Claude Code で使う | JSON keys, local output, recovery |
条件から始める
条件から始める場合は、まず sf search を使います。
sf search "<criteria>" --json sf search "AI系の求人を募集している会社" --json sf search "生成AIに関心がありそうな会社" --json
返ってきた companies[] から、agent が local list、CSV、Markdown table を 作ります。再利用する会社群は、確定した company_id だけを Saved List に保存できます。
財務しきい値、BS/CF 条件、利益率、財務ランキングが含まれる場合は、自然文を q に残さず 財務条件の Company Query に進みます。 agent が company_query.v1 を生成し、sf query --file company-query.json --json で実行します。
会社から始める
1 社を調べる場合は、まず company_id を解決します。自由入力をそのまま Company Card / Signals に渡さないでください。
sf search "<company name>" --json sf company <companyId> --json sf signals <companyId> --json
使うページ:
テーマ / seed 会社から始める
市場テーマから候補を探す場合も、seed 会社から競合候補を広げる場合も、入口は同じ sf search です。
sf search "<theme or criteria>" --signal genai_interest --json sf search "<seed company>" --json
必要な会社だけ Signals に降ります。
sf signals <companyId> --json
使うページ:
- 市場調査(テーマから広げる / seed 会社から広げる の 2 節)
Usage 境界
credit を消費する Signals の読み取りや繰り返し検索の前に、usage を確認します。
sf credits balance --json sf credits summary --json
Free は探索できる範囲を広めに取り、Paid はより大きい volume、rate headroom、Email support、本番・商用利用時の運用余裕を提供します。private mode、MCP、query data resale、automation は v0 の課金軸にしません。
弱い結果・未対応の結果
次の状態では断定に進みません。
statusがweakstatusがunsupportedstatusがneeds_humangaps[]が意思決定に影響するmeta.returned_companiesが期待より小さい
復旧の最初の command:
sf search "<shorter or more exact query>" --json sf search "<criteria>" --limit 20 --json
次に読む
- 最初の成功を確認する: クイックスタート
- 会社検索の詳細: Company Search
- 財務条件を構造化する: 財務条件の Company Query
- 成果物の型を確認する: 成果物サンプル
- 1 社を調べる: 1社調査
- 市場や競合候補を調べる: 市場調査
- 検索の内部仕様を知る: 自然言語検索の解決