Company Search

Signal Foundry の CLI では、1 社を調べる最初の 1 手は sf search です。このページは Search command の使い方を説明します。Company Card と Signals は、ここで解決した company_id を前提に進みます。

基本コマンド

sf search 7203 --json
sf search トヨタ --json
sf search 銀行 --json
sf search ＡＢＥＪＡ --json

<query> には次を渡せます。

• 証券コード
• 社名
• 既知の identifier

詳細 option

sf search 7203 --limit 20 --json
sf search トヨタ --has-website true --json
sf search トヨタ --market-segment prime --json
sf search "webサイトがある非上場企業" --json
sf search 金融機関 --industry-33-code 7050,7100,7150,7200 --json
sf search "大阪の製造業で求人募集している会社" --json
sf search "AI系の求人を募集している会社" --json

通常は自然文のまま sf search "<criteria>" --json を使います。以下の option は、 agent や backend が条件を明示済みの場合だけ使います。

• --limit
• --offset
• --has-website true
• --has-jobs true
• --ai-jobs true
• --construction true
• --prefecture <value[,value]>
• --min-employees <number>
• --order name|jobs|ai|construction|employees
• --industry-33-code <value[,value]>
• --listing-status <value[,value]>
• --market-segment <value[,value]>

--listing-status の accepted value は listed, private, delisted, unknown です。未上場 / 非上場 / unlisted は private に寄せます。

求人・建設・従業員数・都道府県の条件を使う場合は、会社検索 hot path が sf_company_source_enrichment_mv に切り替わり、companies[].source_context に求人件数、求人ソース数、求人の最新観測日時、AI 求人件数、建設業許可件数、営業所件数、サンプル求人タイトルが入ります。この hot path では、meta.matched_companies は scan 済み件数ではなく条件に合う総件数です。

sf search は会社起点です。--prefecture や自然文の「大阪」は会社所在地として扱われ、求人勤務地の絞り込みではありません。勤務地で個別求人を先に並べる workflow は求人検索 surface 側を使います。

返り値でまず見る場所

成功時は、少なくとも次を確認してください。

• companies[0].company.company_id
• companies[0].company.display_name
• companies[0].profile.website_domain
• companies[0].query_match.identifier_matched
• warnings[]
• meta.coverage_warnings
• meta.returned_companies

出力イメージは次です。

{
  "companies": [
    {
      "company": {
        "company_id": "jpx_7203",
        "display_name": "トヨタ自動車",
        "listing_status": "listed"
      },
      "profile": {
        "website_domain": "global.toyota"
      },
      "query_match": {
        "identifier_matched": true,
        "relevance": 120
      }
    }
  ],
  "warnings": [],
  "meta": {
    "returned_companies": 1,
    "coverage_warnings": []
  }
}

warnings[] / meta.coverage_warnings に weak、pending、no_data、unsupported が出た場合は、0 件成功として扱わず、条件を分解して再確認します。財務しきい値を決定的に扱う場合は、自然文 q に残さず company_query.v1 を生成し、sf query --file company-query.json --json で実行します。

sf search に入れない条件

sf search は会社候補と根拠を返す入口です。次の条件は、弱い keyword にして実行せず、unsupported、needs_human、または company_query.v1 に分けます。

低ヒットや 0 件は「存在しない」の証明ではありません。coverage、source、条件分解を確認してから次に進みます。

次に進むコマンド

sf company jpx_7203 --json
sf signals jpx_7203 --json
sf usage --json

自由入力の社名を Company Card 読み取りに直接渡す前に、まず sf search で canonical な company_id に解決します。必要な会社だけ Signals を読み、最後に Usage で quota と credit 境界を確認します。