Adzuna Job Search MCP

Adzuna Jobs MCP サーバー

AI アシスタントが Adzuna Job Search API にアクセスできるようにする、Model Context Protocol（MCP）サーバーです。12 か国の求人を検索し、給与データを分析して、雇用主を調査できます。

機能

• 求人検索 - 場所、給与、雇用形態などのフィルターを使って、数百万件の求人情報を検索できます
• 給与分析 - 給与のヒストグラム、地域ごとの比較、過去の推移を確認できます
• 企業調査 - 採用人数の多い上位の雇用主を調べられます
• 複数国への対応 - 現地通貨に対応し、12 か国の求人市場にアクセスできます

対応国

コード	国	通貨
gb	イギリス	GBP £
us	アメリカ合衆国	USD $
de	ドイツ	EUR €
fr	フランス	EUR €
au	オーストラリア	AUD $
nz	ニュージーランド	NZD $
ca	カナダ	CAD $
in	インド	INR ₹
pl	ポーランド	PLN zł
br	ブラジル	BRL R$
at	オーストリア	EUR €
za	南アフリカ	ZAR R

利用可能なツール

ツール	説明
search_jobs	フィルター（キーワード、場所、給与、雇用形態）を使って求人を検索します
get_categories	国で有効な求人カテゴリのタグを取得します
get_salary_histogram	求人検索における給与分布データを取得します
get_top_companies	求人数が多い上位の雇用主を取得します
get_geodata	地域別の給与データを取得します
get_salary_history	給与の過去の推移を取得します
get_api_version	現在の Adzuna API バージョンを取得します

前提条件

• Python 3.10+
• Adzuna API の認証情報（無料）

Adzuna API の認証情報を取得する

1. Adzuna Developer Portal にアクセスします
2. 無料アカウントを登録します
3. 新しいアプリケーションを作成します
4. App ID と App Key をコピーします

インストール

オプション 1：PyPI からインストール（推奨）

pip install adzuna-mcp

または、分離された環境で実行するには uvx を使用します。

uvx adzuna-mcp

オプション 2：ソースからインストール

git clone https://github.com/folarinakinloye/adzuna-mcp.git
cd adzuna-mcp
pip install -e .

オプション 3：開発環境のセットアップ

git clone https://github.com/folarinakinloye/adzuna-mcp.git
cd adzuna-mcp
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e ".[dev]"

環境変数の設定

Adzuna の認証情報を記載した .env ファイルを作成します。

ADZUNA_APP_ID=your_app_id_here
ADZUNA_APP_KEY=your_app_key_here

使用方法

Claude Desktop で使用する

Claude Desktop の設定ファイルに追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "adzuna-jobs": {
      "command": "/path/to/adzuna-mcp/venv/bin/python",
      "args": ["/path/to/adzuna-mcp/server.py"],
      "env": {
        "ADZUNA_APP_ID": "your_app_id",
        "ADZUNA_APP_KEY": "your_app_key"
      }
    }
  }
}

設定を更新した後、Claude Desktop を再起動します。

Cursor で使用する

Cursor の MCP 設定（プロジェクト内の .cursor/mcp.json またはグローバル設定）に追加します。

{
  "mcpServers": {
    "adzuna-jobs": {
      "command": "/path/to/adzuna-mcp/venv/bin/python",
      "args": ["/path/to/adzuna-mcp/server.py"],
      "env": {
        "ADZUNA_APP_ID": "your_app_id",
        "ADZUNA_APP_KEY": "your_app_key"
      }
    }
  }
}

その他の MCP クライアントで使用する

サーバーを直接実行します。

# Activate virtual environment
source venv/bin/activate

# Run with stdio transport (default)
python server.py

# Or use FastMCP CLI
fastmcp run server.py:mcp

開発モード

FastMCP には、インタラクティブなインスペクターを使える開発モードがあります。

fastmcp dev server.py

ブラウザベースの UI が開き、ツールをテストできます。

プロンプトの例

接続後、AI アシスタントに次のように尋ねることができます。

求人検索：

• 「ロンドンで年収 £60,000 超のソフトウェアエンジニアの求人を探してください」
• 「米国でリモート勤務可能な Python 開発者の求人を検索してください」
• 「ドイツのデータサイエンス関連の求人を表示してください」

給与の調査：

• 「英国の機械学習エンジニアの一般的な給与はいくらですか？」
• 「ロンドンとマンチェスターのソフトウェアエンジニアの給与を比較してください」
• 「過去 1 年間でデータサイエンティストの給与はどのように変化しましたか？」

企業の調査：

• 「ロンドンで最も多くのソフトウェアエンジニアを採用している企業はどこですか？」
• 「ニューヨークの金融関連の求人で、主な雇用主を表示してください」

ツールの詳細

search_jobs

詳細な条件を指定して求人を検索します。

Parameters:
- country (required): Country code (e.g., "gb", "us")
- keywords: Search terms (e.g., "python developer")
- location: City, region, or postal code
- page: Page number (starts at 1)
- results_per_page: Results per page (max 50)
- salary_min/salary_max: Annual salary filter
- full_time/part_time/contract/permanent: Job type filters
- category: Category tag from get_categories
- sort_by: "date", "salary", or "relevance"
- max_days_old: Maximum listing age in days

get_categories

検索前に有効なカテゴリタグを取得します。

Parameters:
- country (required): Country code

Returns category tags like "it-jobs", "engineering-jobs", "finance-jobs"

get_salary_histogram

給与の分布を確認します。

Parameters:
- country (required): Country code
- keywords: Filter by job type
- location: Filter by location
- category: Filter by category

get_top_companies

主要な雇用主を見つけます。

Parameters:
- country (required): Country code
- keywords: Filter by job type
- location: Filter by location
- category: Filter by category

get_geodata

地域間の給与を比較します。

Parameters:
- country (required): Country code
- keywords: Filter by job type
- location: Focus on sub-regions
- category: Filter by category

get_salary_history

給与の推移を分析します。

Parameters:
- country (required): Country code
- keywords: Filter by job type
- location: Filter by location
- category: Filter by category
- months: Months of history (default 12, max ~24)

重要な注意事項

• 給与は、選択した国の現地通貨での年間額です
• まず get_categories を呼び出し、対象国で有効なカテゴリタグを取得してください
• 給与が記載されていない求人も多数あります。給与で絞り込むと、これらの求人は除外されます
• レート制限が適用されます。Adzuna API の無料プランには利用制限があります

プロジェクト構成

adzuna-mcp/
├── server.py              # Main MCP server
├── pyproject.toml         # Package configuration
├── requirements.txt       # Python dependencies
├── .env.example           # Environment template
├── .env                   # Your credentials (gitignored)
├── tests/                 # Test suite
│   ├── __init__.py
│   └── test_server.py
├── .github/
│   └── workflows/
│       ├── ci.yml         # CI pipeline
│       └── publish.yml    # PyPI publishing
├── CONTRIBUTING.md        # Contribution guide
├── LICENSE
├── .gitignore
└── README.md

トラブルシューティング

サーバーが Claude Desktop に表示されない

1. 設定の Python パスが正しいことを確認してください
2. 仮想環境にすべての依存関係がインストールされていることを確認してください
3. Claude Desktop を完全に再起動してください（Cmd+Q / Alt+F4）
4. Claude Desktop のログを確認してください：~/Library/Logs/Claude/mcp*.log

認証エラー

1. Adzuna Developer Portal で API 認証情報を確認してください
2. .env ファイルに正しい値が設定されていることを確認してください
3. MCP の設定で環境変数が渡されていることを確認してください

検索結果が返されない

1. より広い検索語を試してください
2. 国コードが有効であることを確認してください
3. 給与フィルターを削除してください（給与が記載されていない求人も多数あります）
4. 対象国でカテゴリタグが有効であることを確認してください

コントリビューション

コントリビューションを歓迎します！ガイドラインについては、CONTRIBUTING.md をご覧ください。

ライセンス

MIT License — 詳細については LICENSE をご覧ください。

謝辞

• 求人検索 API を提供している Adzuna
• MCP フレームワークを提供している FastMCP
• Model Context Protocol の仕様を提供している Anthropic