AIアシスタント・開発者向け 求人検索の API と MCP

ハローワークインフォの求人検索を、AI アシスタント（Claude・ChatGPT など）や自作のプログラムから使えます。 「新宿駅の近くで年間休日120日以上の介護の求人を探して」のように頼むと、AI が当サイトで全国のハローワーク求人を探し、要点と求人ページへのリンクで答えます。

https://hellowork.info/mcp

https://hellowork.info/api/v1

https://hellowork.info/api/v1/openapi.json

料金: 無料です（キーは要りません）。上位枠の API キーは現在発行していません。

MCP サーバーの登録のしかた

• Claude（claude.ai・デスクトップアプリ）: 設定 → コネクタ → 「カスタムコネクタを追加」で、URL に上の「MCP サーバーの URL」を入れます。
• ChatGPT: コネクタ（開発者モード）で、上の「MCP サーバーの URL」を登録します。

claude mcp add --transport http hellowork https://hellowork.info/mcp

{
  "mcpServers": {
    "hellowork": { "url": "https://hellowork.info/mcp" }
  }
}

使えるツール（どれも読み取りだけです）:

• search_jobs: 求人を探す（都道府県・市区町村・駅からの距離・職業・キーワード・賃金・年間休日・雇用形態・働き方・年齢など。20件ずつ）
• get_job: 求人1件の主な条件・近い駅・この求人のポイント・相場との比較・応募のしかた
• find_places: 駅・市区町村・都道府県の候補
• find_occupations: 「介護」「看護師」などの語から職業の候補

JSON の API

• GET /api/v1/jobs 求人を探す（パラメータは MCP の search_jobs と同じ。配列は同じ名前のくり返しかカンマ区切り）
• GET /api/v1/jobs/{求人番号} 求人1件の要点
• GET /api/v1/places?q= 駅・市区町村・都道府県の候補
• GET /api/v1/occupations?q= 職業の候補
• GET /api/v1/openapi.json OpenAPI 3.1 の説明（ChatGPT の GPTs の Actions などにそのまま登録できます）

curl "https://hellowork.info/api/v1/jobs?station=%E6%96%B0%E5%AE%BF&radius_km=3&occupation=050&min_annual_holidays=120"

応答には、条件に合う件数（total）、20件までの要点（results）、選べる値に寄せた条件（applied_filters・notes）、同じ条件の検索結果ページ（search_url）、出典（attribution）、 非公式のサイトであることの表示（notice）、データの日付（data_as_of）が入ります。同じ名前の駅や市区町村が複数あるときは、候補（candidates）つきのエラーを返します。

回数の上限

• アクセス元ごとに 1分30回・1日1,000回まで使えます（キーは要りません）。
• 上限に届くと 429 を返します（Retry-After に待つ秒数）。
• 上位枠の API キーは現在発行していません。

求人を示すときのお願い

• 出典として、応答の attribution（「出典: ハローワークインターネットサービス（厚生労働省）の公開求人情報。ハローワークインフォが整理して提供。」）を添えてください。 「ハローワークインフォ」は当サイトへのリンクにしてください（attribution は Markdown のリンクつき、attribution_link にリンクの文字と URL があります）。
• 当サイトは民間の非公式のサイトです。厚生労働省・ハローワークの公式の情報として示さないでください（応答の notice）。
• リンクは、それぞれの求人の url（当サイトの求人ページ）を使ってください。求人票の全項目や最新の内容、ハローワークの求人票へのリンクは、求人ページにあります （API・MCP はハローワークのサイトの URL を返しません）。
• 求人への応募は、ハローワークの窓口で紹介状を受け取って行います（オンライン自主応募ができる求人もあります）。当サイトは応募を取り次ぎません。

利用条件

利用規約の「API・MCP の利用」に従ってください。大量に取得して求人のデータベースを作り直すこと、取得したデータの販売、 回数の上限を避けるための工夫（アクセス元を変えるなど）は禁止しています。記録するのは、キー・入口・日ごとの回数だけで、検索の条件の中身は記録しません（プライバシーポリシー）。

データの出典は このサイトについて を、求人の情報の元は ハローワークインターネットサービス（新しいタブで開く） を見てください。