Indeed MCP Server

Claude、Cursor、Windsurf、その他すべての MCP クライアントに、2つの読み取り専用 Indeed ツールを提供するホスト型 Model Context Protocol (MCP) サーバーです。キーワードと場所で求人リストを検索し、個別の求人情報を全文読むことができます。すべて構造化 JSON として返され、Indeed の開発者アカウントもパートナー承認も不要です。

ログアウト状態の訪問者でも閲覧できる公開求人情報を読み取ります。

https://mcp.hasdata.com/api/mcp?apis=indeed

目次

• 必要なもの

• クイックスタート

• プロンプトの例

• ツール

• エラーと失敗のパターン

• 料金、無料枠、制限

• ツールの選択

• 他のサービスとの比較

• FAQ

• HasData リンク

• 開発

• コントリビューション

• ライセンス

Related MCP server: Indeed Skills

必要なもの

MCP クライアントと、ダッシュボード から取得する HasData API キーが必要です。ダッシュボードのアカウントはカード不要で無料で作成でき、トライアルでは5クレジットレートで約200回の呼び出しが利用できます。これはリモートサーバーなので、最も簡単な方法は URL と x-api-key ヘッダーを使うことです。実行するコンテナはなく、フローのどこにも Indeed 開発者アカウントは必要ありません。stdio のみに対応したクライアントは、軽量ランチャーを通じてこのサーバーにアクセスします。このランチャーは npm では @hasdata/indeed-mcp、PyPI では hasdata-indeed-mcp として公開されており、後述します。

クイックスタート

サーバー URL はすべてのクライアントで共通です。私たちは Claude Code と Claude Desktop で実際に動作確認しています。以下の各ブロックは、各クライアントがリモートサーバー向けに公式に文書化している形式に従っています。

OAuth 対応のクライアントでは、同じ URL をコネクタとして追加し、設定ファイルにキーを書かずにサインインできます。

claude mcp add --transport http indeed "https://mcp.hasdata.com/api/mcp?apis=indeed" \
  --header "x-api-key: HASDATA_API_KEY"

設定 → コネクタ → カスタムコネクタを追加 の順に進み、https://mcp.hasdata.com/api/mcp?apis=indeed を貼り付けてサインインします。

設定ファイルを使う場合、Claude Desktop はローカル (stdio) サーバーのみを読み込むため、stdio ランチャーを介してリモートサーバーに接続します。@hasdata/indeed-mcp パッケージがそのランチャーで、環境変数からキーを読み取ります。以下を claude_desktop_config.json に追加してください:

{
  "mcpServers": {
    "indeed": {
      "command": "npx",
      "args": ["-y", "@hasdata/indeed-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Node ではなく Python を使う場合は、ランチャーを PyPI パッケージに置き換えます。uvx は手動インストールなしでそのパッケージを実行できます:

{
  "mcpServers": {
    "indeed": {
      "command": "uvx",
      "args": ["hasdata-indeed-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

全プロジェクトで使用する場合は ~/.cursor/mcp.json、1つのプロジェクトのみの場合は .cursor/mcp.json です:

{
  "mcpServers": {
    "indeed": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=indeed",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json を使用します。Windsurf はこのフィールドを url ではなく serverUrl と呼びます:

{
  "mcpServers": {
    "indeed": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=indeed",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

ワークスペース内の .vscode/mcp.json です:

{
  "servers": {
    "indeed": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=indeed",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

プロンプトの例

コードではなくプロンプトです。いずれかを貼り付けると、エージェントがツールを自動的に選択します。各プロンプトには必要な呼び出し回数が注記されています。成功した呼び出しは毎回5クレジット消費するためです。

Indeed で「python developer」の求人をニューヨークで日付順に検索し、会社名と給与を含む最新10件を教えて。

呼び出し1回、5クレジット。リストページには会社名、給与、掲載日がすでに含まれています。

その検索結果の一番上の求人を取得し、完全な説明と応募要件を抽出して。

呼び出し1回、5クレジット。リストには求人 URL が含まれており、詳細ツールがそれを直接受け取ります。

オースティンで「data analyst」の求人を検索し、給与が記載されている3件の完全な詳細情報を取得して。

呼び出し4回、20クレジット。リスト1回、続いて3件それぞれに詳細呼び出し1回ずつです。

シカゴで掲載されている「registered nurse」の給与を、ヒューストンのものと比較して。

呼び出し2回、10クレジット。各都市につきリスト1回です。

給与は、掲載に明記されている場合にのみリストに表示されます。そのため「給与あり」の求人を指定するプロンプトでは、給与があることを前提にせず、フィールドで絞り込む必要があります。ページングは start オフセットを使って行うたびに、1回の呼び出しとしてカウントされます。

ツール

2つの読み取り専用ツールがあります。以下のサンプルは実際の呼び出しから抜粋したもので、数値は Indeed の更新に応じて変わります。あくまでも形として捉えてください。各ツール名は、完全なフィールド一覧を掲載したエンドポイントリファレンスにリンクされています。

サンプルはペイロードであり、レスポンス全体ではありません。tools/call の結果には1つのテキストブロックが含まれ、そのテキスト自体が url、status、text、json を保持する JSON です。スクレイピングされたデータは json の下にあります。生の JSON-RPC レスポンスからデータを取り出すパスは、result.content[0].text をパースし、次に .json という順になります。チャットクライアントはこれを自動的に展開しますが、エンドポイントに直接通信するコードでは展開されません。

Indeed 求人リストの取得

hasdata_indeed_listing_getJobListings

キーワードと場所による検索結果の1ページ分です。

レスポンスには searchInformation、jobs 配列、peopleAlsoSearchFor、pagination が含まれ、pagination の nextPage は次ページの URL です。各求人には title、company、location、url、短い description、sponsored、相対的な date と絶対的な isoDate、Full-time や Hybrid work のようなラベルの details 配列、benefits 配列、そして掲載に給与が明記されている場合には salary オブジェクトが含まれます。

リストの details はプレーンな文字列の配列です。後述の求人詳細ツールが返す details は、jobType と workSetting の配列を持つオブジェクトです。同じ名前でも構造が異なるため、各ツールの仕様に従って読み取ってください。

{
  "title": "Hedge Fund Application Developer",
  "company": "TBA",
  "location": "Stamford, CT 06901",
  "url": "https://www.indeed.com/pagead/clk?...",
  "sponsored": true,
  "date": "30+ days ago",
  "isoDate": "2025-06-03T17:22:54.869Z",
  "details": ["Full-time", "Hybrid work"],
  "benefits": ["Health insurance", "401(k)", "401(k) matching"],
  "salary": { "min": 80000, "max": 150000, "type": "YEARLY" }
}

Indeed 求人詳細の取得

hasdata_indeed_job_getJobDetails

求人 URL によって、1件の求人情報を全文取得します。

レスポンスには、title、company、location、sponsored、jobType と workSetting の配列を持つ details オブジェクト、存在する場合は salary オブジェクト、そして求人本文が description（プレーンテキスト）と descriptionHtml（同じ内容でリストと段落のマークアップを保持したもの）の両方で含まれます。構造が必要な場合は descriptionHtml を、モデルに渡すクリーンなテキストが必要な場合は description を使用してください。

{
  "title": "Python Developer",
  "company": "Think IT Technologies",
  "location": "New York, NY 10114",
  "sponsored": false,
  "details": { "jobType": ["Contract"], "workSetting": ["In-person"] },
  "salary": { "min": 60.5, "max": 65, "type": "HOURLY" },
  "description": "Overview\nWe are seeking a Python Developer...",
  "descriptionHtml": "<p><b>Overview</b></p><p>We are seeking a Python Developer...</p>"
}

エラーと失敗のパターン

ツール呼び出しで HTTP エラーコードが返ることは、ほとんどありません。MCP レイヤーは 200 で応答し、失敗内容を結果の中に含めます。isError が true に設定され、理由はテキストとして入ります。ステータス行を期待する場面で、エージェントはメッセージを読み取ることになります。

誤ったキーは、接続失敗ではなくツールの出力として現れます。 tools/list は空でないキーであれば何でも受け入れ、両方のツールを返すため、クライアントはハンドシェイクを完了して正常表示になります。その後、最初のツール呼び出しで isError: true とテキスト HasData API error: 401 Unauthorized が返ってきます。フローのそれより前の段階では問題が報告されないため、この文字列に注意してください。

キーが欠落している場合だけが、実際の HTTP エラーです。 認証はすべてのツールの前に実行され、接続自体が 401 で失敗します。CORS ヘッダーは存在するため、ブラウザクライアントは不透明なネットワーク障害ではなくステータスコードを読み取ります。

ツールのスキーマに適合しない引数は、スクレイピングが行われる前に拒否されます。 サーバーは isError: true と、問題のあるフィールドを指名したテキスト MCP error -32602: Input validation error で応答します。データの取得も課金も行われません。

何も一致しない検索は、空の jobs 配列を含む成功結果を返します。これはエラーではありません。求人がないキーワードと場所の組み合わせでも、requestMetadata.status が ok に設定されて返ってきます。反復処理の前に、配列の長さを確認してください。

掲載が取り下げられた求人は 400 を返し、requestMetadata.status が error に設定されます。Indeed の掲載はすぐに失効するため、以前の検索で得た URL が無効になっている場合があります。

データを含む結果には requestMetadata.id も含まれており、サポートへの問い合わせ時にこの ID を伝えると役立ちます。

料金、無料枠、制限

各 Indeed ツールは、成功した呼び出しごとに5クレジットかかります。レスポンスサイズによって料金は変わりません。50件の求人が載ったリストページも、2件だけのページも同じ料金です。

無料トライアルはカード不要で30日間1,000クレジットで、これは Indeed の呼び出し200回分です。その後も、アクティブなアカウントは残高が100を下回るたびに毎日100クレジットが補充され続けるため、利用量が少ないエージェントは無料枠で無期限に稼働できます。

有料プランは月額49ドルからで、200,000クレジット（40,000回の呼び出し）が含まれます。単価は利用量に応じて下がり、エントリープランでは1,000回あたり1.23ドル、Business では0.50ドル、Growth では0.42ドル、最も大きな高ボリュームプランでは0.37ドルです。

同時実行数もプランによって決まります。無料トライアルは同時に1リクエスト、Startup は15、Business は30、Growth は50、高ボリュームプランは200〜1,500です。無人で稼働させるものでは、上限超過への対処を防御的に実装してください。

200 以外で返ってきたリクエストは課金されません。何も見つからなかった成功した呼び出しも、呼び出しとしてカウントされます。

ツールの選択

apis クエリパラメータによって、エージェントがどのツールを見るかが決まります。ツールが少なければ、ツール定義に消費されるコンテキストが減り、モデルが誤ったツールを選ぶ可能性も減ります。

?apis=indeed                     the two tools in this repo
?apis=indeed,glassdoor           add Glassdoor jobs
?apis=indeed,google_serp         add Google search

このパラメータには、indeed のようなプロバイダ名や、indeed_listing のような個別の API 名を指定できます。スペルミスのある名前は無視されます。すべての名前が間違っている場合、リクエストは 400 で失敗し、レスポンス本文には認識できなかった名前と有効な値の一覧の両方が記載されます。パラメータを省略すると、同じエンドポイントで HasData の全57ツールが公開されます。

比較

Indeedは公開のPublisher APIとJob Search APIを廃止しました。プログラムによるアクセスは現在、セルフサービスのキーではなく、承認されたパートナーシップとATS連携を通じて行われます。任意の検索にまたがって公開の求人リストや投稿を読み取るための公開された公式ルートは存在しません。

このサーバーが行わないこと。 応募の送信、雇用者向けダッシュボード、候補者データ、非公開の求人投稿はありません。サインアウトした訪問者に見えるものだけを読み取ります。

FAQ

公式のIndeed MCPサーバーはありますか？

Indeedは公式のものを公開していません。このサーバーはHasDataが保守しており、公開ページを読み取るため、Indeedの開発者アカウントは不要です。

Indeed MCPサーバーとは何ですか？

Indeedの求人データを、AIクライアントが呼び出せるツールとして公開するサーバーです。クライアントはModel Context Protocolを介してツール呼び出しを送信し、サーバーはデータを取得して構造化JSONを返し、モデルがその結果を処理します。このサーバーは2つのツールを公開し、リモートで動作します。

Indeed APIキーやパートナーアカウントは必要ですか？

いいえ。必要な認証情報はHasDataのキーだけです。ツールは公開されたIndeedのページを読み取るため、申請するPublisherアカウントはありません。

複数画面にわたる結果をページングするにはどうすればよいですか？

startオフセットをURLではなく数値としてリスティングツールに渡してください。レスポンスはpagination.nextPageを返します。このstart値が次のページのオフセットなので、その数値を読み取って、URLを渡すのではなくその値を渡し直してください。

給与が表示されないことがあるのはなぜですか？

求人投稿に給与が記載されていないためです。salaryオブジェクトは、Indeedに金額が表示されている場合にのみ存在します。防御的に読み取ってください。

他のHasData APIと併用できますか？

はい。apisパラメータはリストを受け取り、?apis=indeed,glassdoorとすると、エージェントはIndeedとGlassdoorを利用できます。パラメータを省略すると、すべてを利用できます。

コンプライアンスと個人データ

HasDataは公開されているデータのみにアクセスします。プラットフォームの利用規約が自動アクセスを制限する場合があり、コンプライアンスの責任はあなたにあります。収集したデータに個人情報が含まれる場合は、GDPR、CCPA、またはお住まいの地域の同等の規則に基づく正当な根拠があることを確認してください。

HasDataのリンク

開発

このリポジトリは、リモートサーバー向けの設定とドキュメントです。ビルドステップはなく、コンテナ化するものもありません。

test/内のテストは、ツール契約、すなわちここへのコミットなしに壊れ得る部分を検証します。具体的には、?apis=indeedが正確に2つのツールを返すこと、すべてのツールが必須パラメータを引き続き宣言していること、名前が変更されていないこと、使用中のキーが実際に受け入れられることを確認します。最後のチェックは実際にツールを呼び出し、5クレジットを消費します。これは、正しい理由で失敗し得るカナリアの価格です。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

同じスイートは、プッシュのたびと週1回のスケジュールでCI実行されます。上流のツールリストは、このリポジトリに誰も触れなくても変更され得るためです。失敗は、ツールリストが変更されたか、キーが機能しなくなったか、エンドポイントに到達できなかったことを意味し、アサーションメッセージがその原因を示します。

コントリビューション

ツールの表とレスポンスサンプルの修正が最も役立つコントリビューションです。それらは乖離しがちな部分だからです。実行した呼び出しと取得したレスポンスを含めてください。フォークからのプルリクエストはキーなしでスイートを実行し、ライブチェックは赤になる代わりにスキップされます。

ライセンス

MIT。 LICENSE を参照してください。