採用ビッグデータサービス

このMCPサービスは、企業キーワード検索、求人検索、雇用主の採用プロファイル、人材ニーズ、職位給与、採用トレンド分析の機能を提供し、ユーザーの人材市場調査、雇用主分析、採用判断を支援します。

主な機能

• 🏢 企業略称・キーワード検索

• 🔍 企業の採用求人検索

• 🏢 雇用主の採用プロファイル分析

• 👥 企業の人材ニーズ分析

• 💰 採用職位の給与照会

• 📈 企業の採用トレンド概要

Related MCP server: PayHub MCP Server

サービス設計の説明

• サービスは実際のビジネスシーンに基づいて6つのツールを提供し、上流APIの数に応じてツールをそのまま並べることはありません。

• ユーザーが企業略称のみを提供する場合、まず recruitment_enterprise_search を使用して企業の正式名称または安定したIDを取得します。

• 採用明細と採用統計の2つのProduct IDは、異なるシナリオのツールで再利用されます。

• recruitment_demand_analysis は view で明細または統計を選択し、1回のアクセスで1つのProduct IDのみにアクセスします。

• ページング結果のビジネス外層には total と resultList のみが含まれ、pageSize の最大値は50です。

• プロファイルと統計内の長いリストは listLimit で制限され、デフォルトは50、最大は200です。

• recruitment_trend は採用数、直近3か月の統計、更新頻度、平均給与のみを返し、プロファイルの長いリストを重複して返すことを避けます。

環境要件

• Python 3.10+

• 依存パッケージ：python-dotenv、requests、mcp

ローカルでのクイックスタート

1. プロジェクトディレクトリに移動

cd recruitment-mcp-server

2. 仮想環境を作成し依存パッケージをインストール

python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. 環境変数を設定

環境変数テンプレートをコピー：

cp .env.example .env

.env ファイルを編集：

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

HANDAAS_REQUEST_TIMEOUT はオプション設定で、単位は秒、デフォルト値は30です。

4. Streamable HTTP サービスを起動

python server/mcp_server.py streamable-http

サービスのデフォルトアドレスは http://localhost:8000/mcp です。

起動スクリプトも使用できます：

./start_mcp_server.sh streamable-http

stdio、sse、streamable-http の3つの起動方式に対応しています。

5. Cursor / Cherry Studio MCP 設定

{
  "mcpServers": {
    "recruitment-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

STDIO版のインストールとデプロイ

{workdir} を recruitment-mcp-server の絶対パスに置き換えます：

{
  "mcpServers": {
    "recruitment-mcp-server": {
      "command": "{workdir}/mcp_env/bin/python",
      "args": [
        "{workdir}/server/mcp_server.py",
        "stdio"
      ]
    }
  }
}

INTEGRATOR_ID、SECRET_ID、SECRET_KEY は HandaaS にログインして登録し、コネクタを開通した後に取得する必要があります。実際の認証情報はローカルの .env またはデプロイメントキーにのみ保存してください。

利用可能なツールとProduct ID

1. recruitment_enterprise_search

機能：企業略称、ブランド、製品、その他のキーワードで候補企業を検索します。

主要パラメータ：matchKeyword 必須；pageIndex デフォルト1；pageSize デフォルト10、最大50。

戻り値：候補企業の total/resultList。候補を確認したら、企業の正式名称、企業ID、または統一社会信用コードを採用ツールに渡します。

2. recruitment_job_search

機能：指定した企業の採用求人明細を照会します。

主要パラメータ：

• matchKeyword（必須）：企業名、企業ID、登録番号、または統一社会信用コード。

• keywordType（オプション）：企業識別タイプ。name、nameId、regNumber、socialCreditCode に対応。

• pageIndex（オプション）：ページ番号。1から始まります。

• pageSize（オプション）：1ページあたりの件数。デフォルト50、最大50。

戻り値：total と resultList。求人明細には、職位名、都市、学歴、給与、勤務年数、掲載日、勤務地などのフィールドが含まれます。

3. recruitment_employer_profile

機能：福利厚生、採用都市、職位キーワード、平均給与など、企業の採用プロファイルを照会します。

主要パラメータ：

• matchKeyword（必須）：企業名、企業ID、登録番号、または統一社会信用コード。

• keywordType（オプション）：企業識別タイプ。

• listLimit（オプション）：プロファイルリストフィールドが最大で何件返されるか。デフォルト50、最大200。

戻り値：企業の採用統計とプロファイル。リストが切り詰められた場合は truncatedFields を返します。

4. recruitment_demand_analysis

機能：企業の人材ニーズを分析します。職位明細または企業統計ビューを選択できます。

主要パラメータ：

• matchKeyword（必須）：企業識別子。

• view（オプション）：details は職位明細、statistics は企業統計。デフォルトは statistics。

• keywordType（オプション）：企業識別タイプ。

• pageIndex、pageSize（オプション）：details ビューのみで使用。pageSize の最大値は50。

• listLimit（オプション）：statistics ビューのみで使用。デフォルト50、最大200。

戻り値：明細ビューは total と resultList を返します。統計ビューは企業の採用プロファイルと統計フィールドを返します。

5. recruitment_salary

機能：企業の採用職位の給与範囲を照会し、職位・人材市場の給与比較に使用します。

主要パラメータ：

• matchKeyword（必須）：企業名、企業ID、登録番号、または統一社会信用コード。

• keywordType（オプション）：企業識別タイプ。

• pageIndex（オプション）：ページ番号。1から始まります。

• pageSize（オプション）：1ページあたりの件数。デフォルト50、最大50。

戻り値：total と resultList。workingSalary には通貨、最低給与、最高給与が含まれます。

6. recruitment_trend

機能：企業の採用トレンド概要を照会します。月次の時系列は返しません。

主要パラメータ：

• matchKeyword（必須）：企業名、企業ID、登録番号、または統一社会信用コード。

• keywordType（オプション）：企業識別タイプ。

戻り値：

• recruitingCurrentCount：現在の採用人数。

• recruitingLastThreeMonthCount：直近3か月の採用人数。

• recruitingLastThreeMonthNo：直近3か月の採用職位数。

• recruitingAvgUpdate：職位の平均更新頻度。

• recruitingAvgWorkingSalary：平均採用給与。

利用シーン

1. 企業の特定：略称やブランド名で企業の正式名称と安定した識別子を確認します。

2. 人材ニーズ調査：対象企業が現在募集している職位と人材の方向性を確認します。

3. 雇用主分析：企業の採用都市、福利厚生、職位キーワード、採用の活発度を把握します。

4. 給与比較：異なる企業や職位の給与範囲を比較します。

5. 採用トレンドの判断：現在および直近3か月の採用規模と平均更新頻度を分析します。

6. 競合情報：採用ニーズの変化から企業の事業拡大の方向性を判断します。

使用上の注意

1. 略称の処理：企業略称で直接照会できない場合は、まず recruitment_enterprise_search を呼び出します。

2. 企業識別子：候補を確認したら、企業IDまたは統一社会信用コードの使用を推奨します。

3. ページング制限：pageIndex は1から始まり、pageSize は1〜50の間である必要があります。

4. リスト制限：listLimit は1〜200の間である必要があります。

5. ビュー選択：職位レコードが必要な場合は view=details を使用し、集計プロファイルが必要な場合は view=statistics を使用します。

6. トレンドの基準：recruitment_trend は現在と直近3か月の概要であり、月次の時系列ではありません。

使用質問の例

recruitment_enterprise_search（企業キーワード検索）

1. 「小米」はどの企業に対応しますか？

2. 「京东」で正確な企業名と企業IDを検索します。

recruitment_job_search（採用求人検索）

1. 小米科技有限责任公司は現在どのような職位を募集していますか？

2. 北京京东世纪贸易有限公司の直近の採用求人を照会します。

recruitment_employer_profile（雇用主の採用プロファイル）

1. 小米科技有限责任公司の採用都市、福利厚生、職位プロファイルを分析します。

2. 珠海格力电器股份有限公司の平均採用給与はどうですか？

recruitment_demand_analysis（採用ニーズ分析）

1. ある企業の人材ニーズ構造を集計します。

2. 対象企業の具体的な職位ニーズを一覧表示します。

recruitment_salary（職位給与照会）

1. 小米科技有限责任公司の採用職位の給与範囲を確認します。

2. 珠海格力电器股份有限公司の職位給与水準はどうですか？

recruitment_trend（採用トレンド概要）

1. 小米科技有限责任公司の現在の採用活発度と直近3か月のトレンドはどうですか？

2. 京东の直近の採用人数、職位数、平均給与を照会します。

テスト検証

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

単体テストはMock HTTPレスポンスを使用し、実際のHandaaS採用APIを呼び出しません。