Adzuna Job Search MCP

🚀 Adzuna Jobs MCP Server

このModel Context Protocol (MCP) サーバーは、AIアシスタントが Adzuna Job Search API にアクセスできるようにします。12か国にまたがる求人検索、給与データの分析、および雇用主の調査が可能です。

✨ 主な機能

• 求人検索 - 場所、給与、職種などのフィルターを使って、数百万件の求人を検索できます。
• 給与分析 - 給与のヒストグラム、地域別の比較、および過去のトレンドを取得できます。
• 企業調査 - 採用数で上位の雇用主を見つけることができます。
• 複数国サポート - 12か国の求人市場にアクセスでき、現地通貨に対応しています。

対応国

利用可能なツール

前提条件

• 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  # 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クライアントでの使用

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

# 仮想環境をアクティブ化
source venv/bin/activate

# stdioトランスポートで実行（デフォルト）
python server.py

# またはFastMCP CLIを使用
fastmcp run server.py:mcp

開発モード

FastMCPは、インタラクティブなインスペクター付きの開発モードを提供します。

fastmcp dev server.py

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

サンプルプロンプト

接続後、AIアシスタントに以下のような質問をすることができます。 求人検索:

• "ロンドンで年収60,000ポンド以上のソフトウェアエンジニアの求人を探して"
• "米国でのリモートPython開発者のポジションを検索して"
• "ドイツでのデータサイエンスの求人を見せて"

給与調査:

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

企業調査:

• "ロンドンで最も多くのソフトウェアエンジニアを採用している企業はどれか？"
• "ニューヨークでの金融関連の求人で上位の雇用主を見せて"

ツールの詳細

search_jobs

包括的なフィルターを使って求人を検索します。

パラメータ:
- country (必須): 国コード（例: "gb", "us"）
- keywords: 検索用語（例: "python developer"）
- location: 都市、地域、または郵便番号
- page: ページ番号（1から始まります）
- results_per_page: 1ページあたりの結果数（最大50）
- salary_min/salary_max: 年収のフィルター
- full_time/part_time/contract/permanent: 職種のフィルター
- category: get_categoriesからのカテゴリータグ
- sort_by: "date", "salary", または "relevance"
- max_days_old: 掲載日からの最大日数

get_categories

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

パラメータ:
- country (必須): 国コード

"it-jobs", "engineering-jobs", "finance-jobs" などのカテゴリータグを返します。

get_salary_histogram

給与の分布を理解します。

パラメータ:
- country (必須): 国コード
- keywords: 職種でフィルター
- location: 場所でフィルター
- category: カテゴリーでフィルター

get_top_companies

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

パラメータ:
- country (必須): 国コード
- keywords: 職種でフィルター
- location: 場所でフィルター
- category: カテゴリーでフィルター

get_geodata

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

パラメータ:
- country (必須): 国コード
- keywords: 職種でフィルター
- location: サブ地域に焦点を当てる
- category: カテゴリーでフィルター

get_salary_history

給与のトレンドを分析します。

パラメータ:
- country (必須): 国コード
- keywords: 職種でフィルター
- location: 場所でフィルター
- category: カテゴリーでフィルター
- months: 過去の月数（デフォルト12、最大約24）

重要な注意事項

• 給与は選択した国の現地通貨での年収です。
• 最初に get_categories を呼び出して、あなたの国の有効なカテゴリータグを取得してください。
• 多くの求人には給与が記載されていません - 給与フィルターを使用すると、これらの求人は除外されます。
• レート制限が適用されます - Adzuna APIには無料プランの使用制限があります。

プロジェクト構造

adzuna-mcp/
├── server.py              # メインのMCPサーバー
├── pyproject.toml         # パッケージの設定
├── requirements.txt       # Pythonの依存関係
├── .env.example           # 環境テンプレート
├── .env                   # あなたの資格情報（gitignored）
├── tests/                 # テストスイート
│   ├── __init__.py
│   └── test_server.py
├── .github/
│   └── workflows/
│       ├── ci.yml         # CIパイプライン
│       └── publish.yml    # PyPIへの公開
├── CONTRIBUTING.md        # コントリビューションガイド
├── 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 を参照してください。

謝辞

• Adzuna が求人検索APIを提供してくれたことに感謝します。
• FastMCP のMCPフレームワークに感謝します。
• Anthropic がModel Context Protocolの仕様を提供してくれたことに感謝します。