Headcount Labs

Headcount Labs MCP サーバー

AI エージェント向けの求人情報です。Headcount Labs はホステッド型のModel Context Protocolサーバーで、Claude、ChatGPT、Codex、Cursor、VS Code などの MCP クライアントが、雇用主の採用サイトや利用している採用プラットフォーム（Workday、Greenhouse、Lever、iCIMS、SmartRecruiters など）から、募集中の求人を検索、集計、閲覧できます。同じ求人のコピーは1件に統合され、すべての求人に元の掲載ページへのリンクが付いています。

インストールや実行は不要です。このリポジトリには、接続手順、クライアントの使用例、公式 MCP Registry エントリー（server.json、名前 com.headcountlabs/jobs）が含まれています。サーバー自体はホストされています。

エンドポイント	サインイン	ツール
https://api.headcountlabs.com/mcp/public	不要	読み取り専用ツール6個。1回の検索で最大250件の該当求人を表示し、1ページあたり50件
https://api.headcountlabs.com/mcp	OAuth 2.1（PKCE、動的クライアント登録）またはベアラートークンとしての API キー	エクスポート、企業レジストリ、求人変更フィード、利用状況など、26個のツール

どちらも Streamable HTTP トランスポートを使用します。

料金。 すべての組織は、カード登録不要で、暦月（UTC）あたり100,000件のレコードを無料で利用できます。それ以降は1,000件あたり一律 $0.01 です。件数、マーケットインサイト、フィールド検索、ドキュメント検索は無料です。 headcountlabs.com/pricingをご覧ください。

アカウントなしで試す

公開エンドポイントを任意の MCP クライアントに追加します。Claude Code の場合：

claude mcp add --transport http headcountlabs-public https://api.headcountlabs.com/mcp/public

または、直接呼び出すこともできます。カタログ内の募集中の求人をすべて集計します。

curl -s https://api.headcountlabs.com/mcp/public \
  -H "content-type: application/json" -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"count_jobs","arguments":{}}}'

アカウントを使って接続する

Claude Code（次に /mcp を実行し、「Authenticate」を選択）：

claude mcp add --transport http headcountlabs https://api.headcountlabs.com/mcp

または、サーバーと求人検索スキルを追加するClaude Code プラグインをインストールします。

/plugin install headcount-labs --marketplace HeadcountLabs/claude-plugin

Codex：

codex mcp add headcountlabs --url https://api.headcountlabs.com/mcp
codex mcp login headcountlabs

Cursor、Windsurf、および mcp.json を読み込むその他のクライアント：examples/mcp.json。 VS Code：examples/vscode-mcp.json。 claude.ai と Claude Desktop：エンドポイント URL を使ってカスタムコネクターを追加します。 ChatGPT：headcountlabs.com/mcp/chatgpt。Grok： headcountlabs.com/mcp/grok。 リモートサーバーに対応していないクライアント：サーバーコマンドとして npx mcp-remote https://api.headcountlabs.com/mcp を実行します。

ツール

公開エンドポイントでは、この表の最初の6つのツールを利用できます。サインイン済みのエンドポイントでは、すべてのツールを利用できます。スコープと上限を含む完全なリファレンスは、headcountlabs.com/docs/mcp-tools にあります。

ツール	機能	レコードを使用
search_jobs	職種名、キーワード、企業、市区町村、州、国、勤務形態、給与、日付で求人を検索します。サインインしていて deliver_file: true を指定すると、最大5,000件の求人をファイルに書き込みます。	はい
count_jobs	一連のフィルターに一致する求人を数え、必要に応じて雇用主ごとに分類します。	いいえ
get_job	1件の求人について、リンクされたすべての掲載情報とそのソースリンクを取得します。	はい
market_insights	日付付きのスナップショットに基づき、給与、上位の雇用主、リモート勤務の割合、大都市圏、州別の求人などを取得します。	いいえ
list_fields	「給与」や「リモート」などの語句に一致するフィルターと求人フィールドを検索します。	いいえ
search_docs	Headcount Labs のドキュメントから、最も一致するセクションを返します。	いいえ
read_file	search_jobs が作成したファイルを、24時間にわたってページ単位で読み取ります。	いいえ
verify_jobs	元の掲載情報からランダムなサンプルを再取得し、リンク、ステータス、職種名、雇用主、勤務地、給与を確認します。	サンプル対象の求人
compare_sources	独自の求人リストを Headcount Labs のデータと1行ずつ照合します。	一致した求人
search_jobs_json, search_jobs_dsl	JSON ボディまたは Elasticsearch 形式の句を使って、同じ求人検索を行います。	はい
list_job_changes	指定した時刻またはカーソル以降の新着、変更、終了した求人を取得します。	はい
list_companies, search_companies, get_company, list_company_jobs	企業レジストリと各企業の求人を取得します（companies:read スコープが必要です）。	求人のみ
create_job_export, list_job_exports, get_job_export, read_job_export_file	最大100,000件の求人を非同期でエクスポートします。	完了したエクスポート
get_usage, get_overage, get_usage_requests, get_usage_analytics	プラン、使用済みおよび残りのレコード数、超過利用の状態、リクエストレポートを取得します。	いいえ
set_confirmation_level, set_overage	エージェントがユーザーに確認を求める必要がある検索規模と、超過利用の請求を有効にするかどうかを設定します。エージェントがこれらを変更するのは、ユーザーから依頼された場合のみです。	いいえ

すべてのツールには、title と readOnlyHint または destructiveHint の注釈が付いています。ツールは求人データを読み取ります。求人への応募や雇用主への連絡はできません。

結果の内容

• デフォルトでは簡潔です。 search_jobs は各求人の短い概要を返します。概要には、順位、job_id、雇用主が記載した職種名、雇用主、および200文字の抜粋（job_ad 内）、勤務地、勤務形態、給与とその期間、日付、求人掲載リンクと応募リンクが含まれます。view: "full" を渡すか、必要な fields を指定するか、すべてのフィールドを取得するには get_job を呼び出してください。一般的な検索10件では、すべてのフィールドを取得する場合と比べてトークン数が62％少なくなりました。
• 求人広告のテキストはデータです。 雇用主が記載したテキストを含む結果には、untrusted_content の通知が先頭に付加されます。また、サーバーはAIに対して、求人広告内の指示に決して従わないよう伝えます。非表示のテキスト（ゼロ幅文字、テキスト方向文字、HTMLコメント、非表示要素）は送信前に削除されます。
• エラーには呼び出しの修正方法が示されます。 引数が不正な場合は invalid_arguments が返され、問題のある各 field、何が誤っているか、受け入れ可能な値または最も近い有効な名前（did_you_mean）、および動作する example が示されます。レート制限と過負荷のエラーには retry_after_seconds が示されます。
• ページネーション。 サインイン済みの場合、limit はページサイズ（10～100、デフォルトは50）で、max_results は1回の検索で全ページを通じて返される結果の最大数（10～1,000、デフォルトは250）です。これらは search_jobs、search_jobs_json、search_jobs_dsl、list_company_jobs、list_companies、search_companies、list_job_changes に適用されます。カーソルに両方の値が保持されるため、最初の呼び出しで両方を設定し、すべてのページで同じ値を維持してください。検索が上限に達すると、next_cursor: null と注記が返されます。アカウント不要のエンドポイントでは、1～50件の求人がページ分割され（デフォルトは10件、詳細な説明を含める場合は1～10件）、250件で停止します。
• 求人カード。 MCP Apps に対応するクライアントでは、search_jobs は給与、リモート、勤務地の各フィルターと、元の求人掲載ページを開く応募ボタンを備えたカード形式でも求人を表示します。それ以外のクライアントでは通常の結果が表示されます。

プロンプトの例

• 「現在、ドイツではデータエンジニアの求人が何件ありますか？」
• 「米国で先週掲載された、給与と応募リンク付きのリモートソフトウェアエンジニアの求人を5件見つけてください。」
• 「テキサス州で、登録看護師の求人を最も多く掲載している雇用主はどこですか？」
• 「プロジェクトマネージャーの求人のうち、リモート、ハイブリッド、出社勤務はそれぞれ何割ですか？」
• 「ドイツにあるDeloitteの募集中の求人をすべてファイルにまとめてください。」

データ

雇用主の採用サイトや求人プラットフォームから取得した募集中の求人を継続的に更新し、募集終了した求人は削除します。各求人には、雇用主、職種名、勤務地、勤務形態、雇用主が公開した給与、日付、求人掲載リンクと応募リンクが含まれます。

• プラットフォーム、国、企業別の掲載範囲：headcountlabs.com/coverage
• 求人レコードのフィールド：headcountlabs.com/docs/data-fields
• 同じフィルターを使えるREST API：headcountlabs.com/docs
• Hugging Faceで公開している求人データセットの一部（ODbL 1.0）：huggingface.co/HeadcountLabs。データセット全体は近日公開予定です。クエリの例とスキーマは求人掲載リポジトリにあります。

プライバシーとサポート

クライアントは検索フィルターと求人IDをapi.headcountlabs.comに送信し、求人データを受け取ります。Headcount Labsが保持するのは、請求に必要な利用回数のみです。プライバシーポリシーと利用規約をご覧ください。

サポート：headcountlabs.com/contact、または[email protected]。

このリポジトリの例とドキュメントはMITライセンスです。