Indeed Skills

indeed-skills：AI エージェント向け Indeed 求人情報 API スキル

Indeed の求人情報をリアルタイムで取得するためのエージェントスキルです。 Claude、ChatGPT、Cursor、またはカスタムのエージェントループに求人情報 API を追加できる、すぐに使える 3 つのスキルを提供します。RolesAPI REST API を通じて、キーワードと勤務地で Indeed の求人情報を検索し、正規化された職種の詳細を取得したり、給与、職務内容、企業情報、福利厚生を参照したりできます。クリーンな JSON を返す Indeed API や Indeed データ API の代替手段をお探しなら、AI エージェントに求人データを組み込む最も手早い方法です。

無料で始められます。キーを取得すれば（登録時に 100 クレジット付与、カード不要）、2 分以内にエージェントから求人情報をリアルタイムで検索できます。

Python の標準ライブラリのみを使用しています。依存関係はありません。MIT-0 ライセンスです。

インストール

# OpenClaw (via ClawHub)
npx clawhub@latest install indeed-full

# Hermes Agent
hermes skills install skills-sh/nikhonit/indeed-skills/skills/indeed-full

# Generic agent skills (Claude Code, Cursor, Cline)
npx skills add nikhonit/indeed-skills

特定の機能に絞ったバリアントをインストールするには、indeed-full を indeed-search または indeed-salary に置き換えてください。

このリポジトリのスキル

スキル	機能	クレジット費用
indeed-full	完全なツールキット：求人情報の検索、求人キーまたは貼り付けた URL による職種の詳細取得、給与、職務内容、企業情報、福利厚生の取得、アカウント確認	呼び出しごとに 1 クレジット
indeed-search	軽量な検索：キーワードと勤務地による求人情報の検索、および本日掲載、今週掲載、リモート限定のプリセット	結果ページごとに 1 クレジット
indeed-salary	求人キーまたは貼り付けた Indeed URL による給与のみの検索	検索ごとに 1 クレジット

幅広い情報が必要なエージェントには indeed-full をインストールしてください。使用するツールを最小限にしたい場合は、特定の機能に絞ったバリアントをインストールしてください。

クイックスタート

1. rolesapi.com で登録し、rolesapi.com/app/keys でキーを作成します。無料プランでは 100 クレジットが利用でき、カードは不要です。
2. キーを環境変数に設定して、スクリプトを実行します。

export ROLESAPI_KEY="rk_live_..."
python3 skills/indeed-search/scripts/search_listings.py "registered nurse" "Chicago, IL"

実際の出力から、35 件の結果のうち 1 件を抜粋しています。

{
  "data": [
    {
      "job_key": "7dcf172c8d7fc756",
      "title": "Nursing",
      "company": { "name": "Golden Healthcare Services Inc" },
      "location": "Olympia Fields, IL 60461",
      "employment_type": "Full-time",
      "salary": { "min": 30, "max": 45, "period": "hour", "currency": "USD", "source": "employer" },
      "posted_at": "2026-06-26",
      "url": "https://www.indeed.com/viewjob?jk=7dcf172c8d7fc756"
    }
  ],
  "meta": { "count": 35 },
  "request_id": "a18e4ef88ad4b00b"
}

任意の job_key を詳細取得用スクリプトに渡せます。

python3 skills/indeed-full/scripts/get_role.py 7dcf172c8d7fc756
python3 skills/indeed-salary/scripts/get_salary.py 7dcf172c8d7fc756

詳しい手順については、rolesapi.com のクイックスタートをご覧ください。

対応環境

• Claude Code / Claude Skills：スキルフォルダーをスキルディレクトリに配置すると、Claude が SKILL.md から読み込みます。
• ChatGPT とカスタム GPT：コードインタープリターからスクリプトを呼び出すか、アクションとしてラップします。
• Cursor、Cline、その他のコーディングエージェント：スクリプトは通常の CLI ツールなので、Python を実行できるエージェントなら利用できます。
• あらゆるエージェントループ：各スクリプトは単独で動作する、標準入力を使わない CLI です。JSON を出力するため、Node、Go、Rust から簡単にシェル経由で呼び出せます。
• インストール不要のオプション：RolesAPI はホスト型の MCP サーバー https://api.rolesapi.com/mcp を提供しています。MCP クライアントから接続すれば、スクリプトを使わずに利用できます。

API 全体をモデルに渡したい場合は、llms.txt（および llms-full.txt）も利用できます。

取得できるデータ

Indeed の 60 以上の国別エディションにわたる、正規化された職種オブジェクトを取得できます。内容は、役職名、評価付きの企業情報、勤務地、雇用形態、給与（下限、上限、通貨、期間、雇用主による提示か推定か）、福利厚生、職務内容全文、掲載日、正規 URL です。すべてのレスポンスは { "data": ..., "request_id": "..." } 形式のエンベロープです。roles API ドキュメント、search API ドキュメント、listings API ドキュメント、OpenAPI 仕様をご覧ください。

一括処理向けに、API では非同期検索と、ジョブあたり最大 500 件の求人情報の一括エンリッチメントも提供しています。完了イベントは署名付き Webhook で通知されます。

認証

ROLESAPI_KEY 環境変数に RolesAPI キー（形式：rk_live_...）を設定します。

export ROLESAPI_KEY="rk_live_..."

無料キーを取得：登録時にクレジットが100付与され、カードは不要です。同じキーを、これらのスキル、ホスト型 MCP サーバー、直接の REST 呼び出しに使用できます。

料金

プラン	価格	クレジット	レート制限
無料	$0	100（登録時に1回）	20/分
月額	$5/月	1,000/月	200/分
年額	$54/年	12,000（前払い）	300/分

1クレジットで、1件の職種詳細または1ページ分の検索結果を取得できます。失敗した呼び出しには課金されません。料金の詳細：rolesapi.com/pricing。

よくある質問

Indeed の求人情報を JSON で取得するにはどうすればよいですか？ rolesapi.com で登録し、ROLESAPI_KEY をエクスポートして、GET /v1/listings?keyword=...&location=... を呼び出します（または、このリポジトリから search_listings.py を実行します）。後続の詳細取得に使える求人キーを含む、正規化された職種概要の JSON が返されます。

無料の Indeed 求人 API はありますか？ RolesAPI の無料プランでは、登録時にカード不要で100クレジットが付与され、100回の検索または職種の検索に利用できます。有料プランは、1,000クレジットで月額$5から利用できます。

料金はいくらですか？ 職種詳細または検索結果1ページにつき1クレジットです。1,000クレジットで月額$5、または12,000クレジットで年額$54です。失敗した呼び出しには課金されません。

米国以外でも利用できますか？ はい。--country（例：gb、de、in）を渡すと、60以上ある Indeed の各国版を検索できます。

特定の Indeed 求人情報の給与を取得できますか？ はい。GET /v1/roles/{job_key}/salary は、最低額、最高額、通貨、期間、およびその金額が雇用主によるものか推定値かを返します。indeed-salary スキルはこの機能をそのまま利用し、貼り付けられた Indeed URL も受け付けます。

何もインストールせずに、エージェントで利用できますか？ はい。MCP クライアントをホスト型サーバー https://api.rolesapi.com/mcp に接続すれば、インストール不要で同じ検索ツールと職種ツールを利用できます。

これは Indeed の公式 API ですか？ いいえ。RolesAPI は独立した製品です。以下の免責事項をご覧ください。

問題と貢献

CONTRIBUTING.md をご覧ください。セキュリティに関する報告：SECURITY.md。

ライセンス

MIT No Attribution。フォーク、公開、サブライセンスが可能です。帰属表示は不要です。

免責事項

RolesAPI は独立した製品であり、Indeed との提携、推奨、後援を受けていません。Indeed はその所有者の商標です。