Signal Foundry
ドキュメント
サポート 戻る
ドキュメントユースケースAPI リファレンスリリースノート

概要

Agent が迷わず使える順に整理しています。

はじめに
sf CLI をインストールクイックスタートデータの出所カバレッジとタグ
CLI 概要
基本コマンドCLI 認証会社検索求人検索建設業許可検索ヘルプとエラーコマンドとフラグCLI 更新
認証
APIキーのライフサイクル利用状況の見方
請求
クレジット表
トラブルシュート
認証・接続・制限エラー低ヒット検索の見直し方クレジットと maxCredits の失敗
CLI

Job Search

source-native 求人行を検索する `sf job search` を説明します。

このページの内容3項目
基本コマンド給与条件の境界返り値でまず見る場所

sf job search は求人行起点の検索です。会社カード起点の sf search とは違い、まず個別求人を返し、リンク済み求人だけ company_id と会社 context を添えます。

基本コマンド

sf job search "大阪勤務のAI求人" --json
sf job search "直近7日の新着AI求人" --json
sf job search "新着AI求人" --first-seen-after 2026-05-20 --json
sf job search "AI求人" --ai-jobs true --job-location 大阪 --json
sf job search --company-id jpx_7203 --json
sf job search "大阪の製造業求人" --prefecture 大阪府 --manufacturing true --json

主な option は次です。

  • --ai-jobs true
  • --job-location <value>
  • --prefecture <value[,value]>
  • --manufacturing true
  • --industry-33-code <value[,value]>
  • --company-id <id>
  • --company-name <name>
  • --first-seen-after <YYYY-MM-DD>
  • --last-seen-after <YYYY-MM-DD>
  • --posted-after <YYYY-MM-DD>
  • --source <value[,value]>
  • --status active|missing|closed|all
  • --linked true
  • --unlinked true
  • --order newest|posted|salary|company|source
  • --limit
  • --offset

--job-location は求人勤務地、--prefecture は linked Base 会社所在地です。大阪勤務のAI求人 のような自然文では 大阪 を求人勤務地として扱います。--company-id を指定する場合は <query> を省略できます。

--first-seen-after は Signal Foundry が初めて見た日で切るため、新着求人だけ追う用途に向いています。--last-seen-after は更新後も見えている求人、--posted-after は求人票の掲載日で切ります。

--order newest は last_seen_at と date_posted を優先して新しい求人から返します。--order posted は求人票の date_posted を優先します。

給与条件の境界

--order salary は、source 側で読める給与情報を持つ求人行を並べる補助です。会社単位で「年収1000万円以上の求人を出している会社」を証明する filter ではありません。

依頼扱い
AI求人を新しい順に見るsf job search "AI求人" --order newest --json
大阪勤務の求人を探すsf job search "大阪勤務の求人" --job-location 大阪 --json
年収1000万円以上の求人を出している会社unsupported.source=structured_job_salary
未上場企業の平均給与が高い会社unsupported.source=private_salary_data

給与しきい値を salary sort や自由文検索に落とすと、条件を満たさない求人や会社を混ぜるリスクがあります。専用の構造化 salary filter が返るまで、agent は明示的に止めます。

返り値でまず見る場所

  • jobs[].job_posting_id
  • jobs[].title
  • jobs[].locations
  • jobs[].company_link.company_id
  • jobs[].company.display_name
  • meta.matched_postings
  • meta.matched_postings_kind

meta.matched_postings は meta.matched_postings_kind と組み合わせて読みます。

matched_postings_kindJSONの意味人間向け表示
exact確定総数Matched 47 job postings
planner_estimateplanner の推定総数Matched ~749 job postings (estimated)
lower_bound確認できた下限Matched 60+ job postings
unknownsource 未配置で総数不明。数値の 0 は総数ではないMatched count unavailable
{
  "meta": {
    "matched_postings": 3,
    "matched_postings_kind": "planner_estimate",
    "offset": 40,
    "returned_postings": 0
  },
  "gaps": [
    {
      "code": "job_search_count_estimate_returned_no_rows"
    }
  ]
}

offset > 0 の空ページは総数を確定できません。満杯ページで planner 推定より多い行を確認した場合は、offset + returned_postings を lower_bound として返します。unknown の場合は job_search_source_pending を確認し、0件と解釈しないでください。

会社情報へ進む場合:

sf company <companyId> --json

会社候補をまとめる場合:

sf job search "大阪の製造業求人" --prefecture 大阪府 --manufacturing true --json
sf company <companyId> --json

このページの内容

基本コマンド給与条件の境界返り値でまず見る場所