SalesBrain API 求人全文検索ガイド

Claude CodeからSalesBrain APIを使って、求人全文検索を行うためのガイドです。

まだAPIキーを設定していない場合は、先に Claude Codeセットアップ を完了してください。

一言で言うと

求人全文検索は、求人票の中身から「いま何が起きている会社か」を探す機能です。

求人タイトルだけでは拾えない、業務内容、採用背景、働き方、利用ツール、組織課題まで読めます。単なる求人検索ではなく、会社のいまの課題と次の動きを探す検索です。

自社商材に合う検索条件を考えたい場合は、自社商材から検索条件を作る の依頼文をClaude Codeに貼ってください。

このガイドでは、求人票の本文全体を 求人全文 と呼びます。API上は GET /jobs/{jobId}/detail で取得しますが、説明上はこの取得結果も「求人全文」と呼びます。

なぜ求人全文検索が重要なのか

求人には、その企業の現在地と、これからやろうとしていることが出ます。

人を採る背景には、事業拡大、組織立ち上げ、業務負荷の増加、既存体制の限界、新しいツールや業務プロセスへの移行など、何らかの変化があります。

つまり求人全文は、営業仮説の宝庫です。

求人タイトルだけだと「営業募集」「経理募集」「採用担当募集」で終わります。求人全文まで読むと、「Salesforceを使っている」「BDRを立ち上げたい」「月次決算を早めたい」「スカウト運用を強化したい」「SaaS管理を整えたい」といった、提案の切り口になる言葉が見えてきます。

SalesBrain APIでは、こうした言葉を横断して拾えます。業界・規模・地域だけではなく、「いま起きている変化」を起点に営業先を絞り込めます。

検索できる期間

求人全文検索の対象は、SalesBrainが直近1か月に取得した求人全文です。

過去のすべての求人全文を検索する機能ではありません。直近に絞ることで、「今まさに動いている企業」を見つけやすくしています。

検索結果には一致箇所の抜粋である descriptionSnippet が返ります。求人全文を確認したい場合は、求人IDを指定して GET /jobs/{jobId}/detail を呼び出します。

カテゴリ別の読み方

求人全文には、職種名だけでなく、業務、採用理由、働き方、使っているツール、連絡先まで出ます。見る場所を変えると、リストの切り口も変わります。

カテゴリ求人全文に出る言葉読めることリスト例
業務内容架電、商談創出、問い合わせ対応、月次決算、請求管理、入退社対応、データ入力現場で発生している仕事、負荷が高い業務、外注・自動化できそうな作業BPO、SaaS、AIエージェントの提案先
採用の背景立ち上げ、拡大、組織強化、新規事業、上場準備、事業成長、欠員補充会社が今どのフェーズにいるか、なぜ人を増やしているか成長・変化のタイミングにある企業
働き方リモート、フレックス、シフト、夜勤、土日、業務委託、副業、短時間勤務雇用環境、稼働時間、現場オペレーションの特徴勤怠、労務、採用、BPO、アルバイト支援の対象企業
福利厚生研修制度、資格取得支援、住宅手当、育休、インセンティブ、社内制度採用競争力を高めたい領域、定着や採用広報で訴求している要素福利厚生、定着支援、採用ブランディングの提案先
利用ツールSalesforce、HubSpot、freee、マネーフォワード、kintone、Slack、Notion、Zendesk既に使っているSaaS、業務フロー、置き換え・連携候補競合利用企業、周辺ツール提案先、連携ニーズのある企業
連絡先採用担当、応募先、問い合わせ先、メール、電話、担当者名接点になりうる部署や連絡経路連絡先が公開されている求人・企業

求人全文で拾った言葉は、商談準備の根拠になります。

求人で「Salesforce」「インサイドセールス」「商談創出」の記載があったため、
営業組織の立ち上げや商談創出の体制づくりを進めている可能性があります。

ただし、求人全文はあくまで手がかりです。営業仮説は断定せず、「可能性がある」「確認したい」という表現にしてください。

業界別ユースケース

売りたい商材によって、見るべき言葉は変わります。業界名だけで絞るより、求人全文に出る業務・背景・ツールの言葉で探すほうが、営業理由のあるリストになります。

人材系

人材紹介、求人広告代理店、RPO、採用代行では、採用背景、働き方、福利厚生を見る。採用に困っている会社や、採用手法を増やそうとしている会社を拾います。

見るカテゴリ検索語の例リスト例
採用の背景採用強化、組織拡大、新規事業、立ち上げ、急募採用需要が強い企業リスト
業務内容スカウト、採用広報、カジュアル面談、母集団形成、面接調整採用代行・RPOの提案先
働き方・福利厚生未経験歓迎、研修制度、リモート、シフト、インセンティブ求人原稿改善や採用広報の提案先

外国人採用支援

外国人採用支援では、在留資格、語学要件、生活支援、受け入れ体制を見る。外国人材の採用・定着に取り組む会社を拾います。

これは個人の国籍や属性を推測する用途ではありません。求人側が明記している「受け入れ条件」「語学要件」「支援制度」を根拠に、企業単位で営業仮説を作る使い方です。

見るカテゴリ検索語の例リスト例
採用の背景人手不足、増員、オープニング、体制強化、採用強化外国人材の採用ニーズがありそうな企業リスト
受け入れ条件特定技能、技能実習、在留資格、ビザサポート、外国籍歓迎、留学生歓迎外国人採用支援・在留資格支援の提案先
福利厚生寮、社宅、住宅手当、引越し支援、日本語研修、生活サポート定着支援・生活支援サービスの提案先
対象領域介護、外食、宿泊、製造、物流、清掃、建設現場職で人手不足がありそうな企業リスト
利用ツール・体制多言語対応、翻訳、通訳、研修制度、マニュアル受け入れ体制づくりや教育支援の提案先

SaaS系

SaaSでは、利用ツールと業務内容を見る。既存ツールの利用状況、周辺ツールの導入余地、業務課題を拾います。

見るカテゴリ検索語の例リスト例
利用ツールSalesforce、HubSpot、kintone、freee、マネーフォワード、Slack、Notion競合利用企業・連携ニーズのある企業リスト
業務内容SFA運用、請求管理、月次決算、問い合わせ対応、アカウント管理特定業務に課題がありそうな企業リスト
採用の背景業務改善、DX推進、組織拡大、体制強化SaaS導入の検討余地がある企業リスト

BPO

BPOでは、業務内容と働き方を見る。人手で回している作業や、外部委託しやすいオペレーションを拾います。

見るカテゴリ検索語の例リスト例
業務内容架電、問い合わせ対応、データ入力、請求処理、受発注、日程調整外注化しやすい業務を持つ企業リスト
働き方シフト、夜勤、土日対応、短時間勤務、業務委託稼働時間が広く、運用負荷が高い企業リスト
採用の背景拡大、増員、繁忙期、体制強化人手不足が起きていそうな企業リスト

コンサル

コンサルティングでは、採用の背景と業務内容を見る。組織変化や業務改革の入口を探します。

見るカテゴリ検索語の例リスト例
採用の背景新規事業、上場準備、組織強化、事業成長、海外展開変革テーマを持つ企業リスト
業務内容業務改善、内部統制、PMO、DX推進、プロジェクト管理コンサル提案の入口がある企業リスト
利用ツールERP、CRM、BI、会計システム、ワークフローシステム刷新・業務設計の余地がある企業リスト

AIエージェント

AIエージェントでは、業務内容と利用ツールを見る。繰り返し作業、情報入力、社内外のやりとりが多い業務を拾います。

見るカテゴリ検索語の例リスト例
業務内容レポート作成、議事録、データ入力、問い合わせ対応、スカウト送信、CRM入力自動化余地がある業務を持つ企業リスト
利用ツールSlack、Notion、Salesforce、HubSpot、Zendesk、Google WorkspaceAIエージェントを既存業務に組み込みやすい企業リスト
採用の背景業務効率化、体制強化、属人化解消、生産性向上AI導入の課題が顕在化していそうな企業リスト

検索条件の作り方

ORで広く見る

市場感を見るときは、似た言葉を広く入れます。

求人全文に「情シス」「社内SE」「情報システム」「SaaS管理」「アカウント管理」のいずれかを含む求人を探してください。

ANDで営業リストにする

営業理由を強くしたいときは、複数のキーワードをすべて含む求人に絞ります。

求人全文に「情シス」と「SaaS管理」の両方を含む求人を探してください。

除外条件でノイズを減らす

広く検索すると、意図と違う求人が混ざることがあります。

求人全文に「スカウト」と「採用広報」を含む求人を探してください。
人材紹介会社、求人広告代理店、採用代行会社っぽいものは除外候補にしてください。

除外しすぎると有望な企業も落ちます。少数の検索結果を見てから条件を足してください。会社種別の判定はAPI項目だけで完結しない場合があるため、Claude Codeに検索結果を見て仕分けさせます。

求人タイトルで職種を寄せる

求人全文だけだと関連職種が混ざることがあります。求人タイトルも使うと、職種を寄せられます。

求人全文に「月次決算」を含み、求人タイトルに「経理」を含む求人を探してください。

直近求人に絞る

営業で使うなら、取得日の新しい求人に絞ります。

求人全文に「Salesforce」と「インサイドセールス」を含む求人を、
取得日が直近30日以内のものに絞って出してください。

自社商材から検索条件を作る

キーワードがまだ決まっていない場合は、Claude Codeに検索条件から考えさせます。

SalesBrain APIの求人全文検索を使って、{自社商材名}の営業先を探したいです。

この商材が刺さりそうな求人全文キーワードを10個提案してください。
次に、その中から検索条件として使いやすい組み合わせを3パターン作ってください。

各パターンについて、
- ORで広く見る条件
- ANDで営業リストにする条件
- 除外したほうがよいキーワード
- 出力列
を整理してください。

最後に、代表的な検索依頼文を1つ作ってください。

API項目としてはここだけ覚えればよい

Claude Codeには自然言語で依頼できます。裏側では主に次の項目を使います。

やりたいことAPI項目
求人全文にいずれかの語を含むjobDescriptionPartialMatchOr
求人全文にすべての語を含むjobDescriptionPartialMatchAnd
求人全文から語を除外するjobDescriptionPartialMatchNot
求人タイトルで補助的に絞るjobTitlePartialMatchOr, jobTitlePartialMatchAnd
取得日で補助的に絞るjobCreatedAtFrom
求人連絡先の有無で絞るhasContactEmail, hasContactPhone
求人全文を確認するGET /jobs/{jobId}/detail

求人全文を持たない求人では、descriptionSnippet や description が null になる場合があります。

注意点

このページ内