iCIMS API: 任意のiCIMSキャリアサイトから公開求人情報を取得する

iCIMSは求人情報の公開読み取りAPIを提供していないため、ほとんどのチームは雇用主ごとに個別のパーサーを作成することになります。このリポジトリでは、そのショートカットとして、動作するPythonの例と、Apify上のiCIMS Careers APIのMCPインストール手順を紹介します。

キャリアサイトを指定すると、構造化された求人情報（タイトル、リクエジションID、雇用主、勤務地、雇用形態、掲載日・更新日、雇用主が公開している場合は給与、応募リンク）が返ってきます。これは、従来のcareers-{tenant}.icims.comポータルと、雇用主自身のドメイン上にある最新のiCIMSキャリアサイトの両方の公開iCIMSサーフェスを読み取るため、雇用主がどちらを使用しているかを事前に知る必要はありません。

無料のApify APIキーはこちらから取得できます：https://apify.com?fpr=9n7kx3

テキストによるウォークスルー

あなたが探しているicims apiは、このActorです。startUrlsにURLとして、またはcompaniesに会社名としてキャリアサイトを1つ指定するだけで、何も取得する前にその雇用主がどのiCIMSサーフェスを使用しているかを自動的に判別します。すべての公開リクエジションが1行として返されます：title、id（雇用主自身のリクエジション番号）、organization、locations_derived、employment_type、date_posted、date_updated、description_text、salary_raw、apply_url。フィールド名は一般的な求人フィードの慣習に意図的に合わせているため、マッピング層なしで既存のパイプラインにそのまま投入できます。

本当にコストを節約できるのはnewerThanです。これを7dに設定すると、Actorは求人ページを開く前にサイト自身の最終更新日でフィルタリングするため、400件の公開リクエジションがある雇用主を毎日ポーリングしても、実際に変更があった数件だけが課金対象になります。includeDetails: falseを追加すると、純粋な変更フィード（url、id、title、日付）が得られます。これは、Track New iCIMS Job Postings Every Dayレシピの背後にある正確な形状であり、採用チームがスケジュールに従って実行し、Slackにパイプすることができます。

失敗したサイトは黙りません。無効なテナント、IP制限のあるポータル、iCIMSではないドメインは、error_code付きのラベル付きエラー行として返されるため、自動化ジョブは「新しい求人なし」と「この雇用主はiCIMSを離れた」を区別できます。

Related MCP server: JobDataLake MCP Server

クイックスタート

git clone https://github.com/johnisanerd/Apify-iCIMS-Careers-API.git
cd Apify-iCIMS-Careers-API
uv sync
cp .env.example .env

.envにApifyトークンを貼り付けてから：

uv run icims-api-example.py

最初の実行では、テキスト説明付きの求人を1つのキャリアサイトから5件取得するため、ほぼ無料に近い状態です。icims-api-example.pyのすべての入力には注釈が付いているので、意図的に拡張できます。

レシピ

コードを書かずに実行できる、Apify Store上のライブページとしてのすぐに使える入力セット：

スケジュールのヒント： これらのいずれもタイマーで実行できます。Apify ConsoleでActorを開き、Schedulesをクリックして、日次または週次のcronを追加します。スケジュールとnewerThan: "24h"およびincludeDetails: falseを組み合わせれば、フルクロールの数分の一のコストで求人変更フィードが得られます。

入力パラメータ

出力フィールド

各行にはresult_typeが含まれ、jobまたはerrorのいずれかです。

url、id、title、organization、organization_url、description_text、description_html、description_markdown、employment_type、locations_derived、remote_derived、date_posted、date_updated、date_validthrough、salary_raw、category、additional_fields、apply_url、latitude、longitude、tenant、source、source_type、source_surface、source_domain、source_url、scraped_at、およびエラー行にはerror_codeとerror_message。

データセットは2つのビューを提供します。Overviewは完全なテーブルです。Changesは監視ビューで、url、date_updated、date_posted、titleのみを含み、これは実行間の差分を取るために必要な唯一の形状です。

Claude Cowork Desktopにインストール

Coworkはデスクトップアプリの自動化モードです。iCIMS APIをツールとして利用できるようにするには、Apify MCPサーバーをコネクタとして追加します。

1. Claudeデスクトップアプリを開き、Settings > Connectors（またはSettings > Developer > Edit Configで直接claude_desktop_config.jsonを編集）に移動します。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. このActorのみをプリロードしたApify MCPサーバーを追加します：

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"
      ]
    }
  }
}

3. アプリを再起動します。Coworkが初めてツールを呼び出すときに、ブラウザでOAuthプロンプトを完了するか、コネクタ設定にApify APIトークンを追加してOAuthをスキップします。

4. Coworkチャットで、ツールが利用可能であることを確認し、iCIMS APIを実行するよう依頼します。

デスクトップアプリをダウンロードして無料トライアルを開始：https://claude.ai/referral/uIlpa7nPLg 詳細はこちら：https://docs.apify.com/platform/integrations/claude-desktop

Claude Codeにインストール

Claude Codeはコマンドラインツールです。ActorのMCPサーバーを1つのコマンドで追加します：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"

ブラウザOAuthの代わりにトークンを使用する場合：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

その後、claude mcp listで確認するか、セッション内で/mcpを実行します。Claude CodeにiCIMS APIを呼び出すよう依頼します。

Claude Codeを無料で試す：https://claude.ai/referral/uIlpa7nPLg Claude Code MCPドキュメント：https://code.claude.com/docs/en/mcp

Claude（ウェブサイト）にインストール

claude.aiでは、Apifyをコネクタとして追加し、このActorのツールのみを有効にします。

1. Settings > Connectors > Browse connectorsに移動し、Apify MCP serverを検索します。インストールします（プロンプトが表示されたら有効化または更新します）。

2. 接続時にApify APIトークンで認証し、ツールjohnvc/icims-careers-apiを有効にします。

3. 任意のチャットで、+ > Connectorsを開き、Apifyをオンにします。

4. または、Add custom connectorを選択し、完全なMCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-apiを貼り付け、プロンプトが表示されたらOAuthを使用します。

5. ClaudeにiCIMS APIを実行するよう依頼します。

ウェブでClaudeを開く：https://claude.ai

Cursorにインストール

Cursorはプロジェクトファイル.cursor/mcp.jsonからMCPサーバーを読み取ります。

1. プロジェクト内に.cursor/mcp.jsonを作成します：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"
    }
  }
}

2. ブラウザOAuthの代わりにトークン認証を希望する場合は、ヘッダーを追加します：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor > Settings > MCPを開き、apifyサーバーが接続されていることを確認します（緑色のドット）。

4. ComposerまたはChatで、CursorにiCIMS APIを呼び出すよう依頼します。

Cursorを初めて使う方はこちら：https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPTにインストール

ChatGPTはDeveloperモード（ChatGPT Pro、Plus、Business、Enterprise、Educationプランで利用可能）を通じてApify MCPサーバーに接続します。

1. プロフィールアイコンをクリックし、Settings > Appsに移動します。Create appボタンが表示されない場合は、Advanced settingsを開き、Developer modeを有効にします。

2. Create appをクリックし、フォームに入力します：

   • Name: Apify

   • MCP Server URL: https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api

   • Authentication: OAuth

3. Createをクリックし、Apifyとの接続を承認します。

4. 会話でアプリを使用するには、チャット内で**+**をクリックし、Developer modeを選択して、Apifyを選択します。

詳細はこちら：https://docs.apify.com/platform/integrations/mcp

FAQ

公式の iCIMS API は存在しますか？ 一般ユーザーが自由に登録して使える公開 API はありません。iCIMS は自社の顧客に対してのみ統合アクセスを販売しています。そのため、自分が勤めていない企業の求人情報を取得したい場合、公開されている採用サイトが唯一の情報源です。この Actor はその公開面を読み取り、API が返すのと同じ構造化フィールドを提供します。

両方のタイプの iCIMS サイトで動作しますか？ はい。icims.com 上のクラシックポータルと、企業独自ドメインでホストされているモダンな iCIMS 採用サイトの両方に対応しています。Actor がドメインを調査して適切なパスを自動選択するため、どちらの URL を渡しても問題なく動作します。

サイトに負荷をかけずに求人情報をスクレイピングするにはどうすればよいですか？ newerThan を使用してください。クラシックポータルでは、求人ページを開く前にサイト側の変更データに対してフィルタが適用されるため、変更のないポジションは取得されません。includeDetails: false を追加すると、1 サイトにつき 1 ページのみのアクセスで実行できます。

これを自社プロダクト内で ATS API として使用できますか？ 多くのユーザーがその目的で利用しています。Apify クライアントを使ってバックエンドから呼び出したり、n8n から呼び出したり、MCP 経由でエージェントから呼び出したりできます。出力フィールド名は一般的なジョブフィードの命名規則に従っているため、既存のノーマライザーでそのまま取り込めることが多いです。

採用サイトが停止していたり、アクセス制限されていたりした場合はどうなりますか？ 実行がクラッシュするのではなく、result_type: "error" と tenant_not_found、ip_gated、not_icims などの error_code を含む行が返されます。監視ジョブはその情報をもとに、企業が iCIMS を利用しなくなった、またはテナントが廃止されたなどのアクションを取れます。

1 回の実行にかかる費用はいくらですか？ 料金は Actor ページ に記載されており、配信されたジョブ行ごとに課金されます。そのため、変更された求人が 2 件見つかった監視実行では、全件クロールではなく 2 行分の料金が発生します。README に転載された数値ではなく、必ず現地の料金を確認してください。

確実に利用できるフィールドはどれですか？ url、id、title、organization、date_updated はすべてのジョブ行に含まれます。給与、カテゴリ、座標は雇用主が公開するかどうかに依存するため、null になる可能性があります。

こちらもよく検索されています

icims API、icims ATS、icims 求人、ATS API、求人データ API、求人情報スクレイピング、応募者追跡システム API、求人情報 API、iCIMS を利用している企業、iCIMS API ドキュメント、iCIMS MCP サーバー、新しい iCIMS 求人情報の追跡、採用サイト 求人データ、求人一覧 API

n8n 連携

n8n のコミュニティノードとして n8n-nodes-icims-careers-api が利用可能です。n8n で「設定」「コミュニティノード」から n8n-nodes-icims-careers-api をインストールすると、任意のワークフローで使用できます（AI エージェントツールとしても動作します）。

詳細

• Apify Store 上の Actor: https://apify.com/johnvc/icims-careers-api?fpr=9n7kx3

• 無料の Apify アカウント: https://apify.com?fpr=9n7kx3

• Apify Python クライアントドキュメント: https://docs.apify.com/api/client/python/

• Apify MCP ドキュメント: https://docs.apify.com/platform/integrations/mcp

• uv: https://docs.astral.sh/uv/

最終更新日: 2026 年 8 月