Сервис больших данных о найме

Этот MCP-сервис предоставляет возможности поиска компаний по ключевым словам, поиска вакансий, построения профиля найма работодателя, анализа потребностей в персонале, анализа зарплат по вакансиям и анализа тенденций найма, помогая пользователям проводить исследования рынка труда, анализ работодателей и принимать решения о найме.

Основные функции

• 🏢 Поиск компаний по краткому наименованию и ключевым словам

• 🔍 Поиск вакансий компании

• 🏢 Анализ профиля найма работодателя

• 👥 Анализ потребностей компании в персонале

• 💰 Запрос зарплат по вакансиям

• 📈 Обзор тенденций найма компании

Related MCP server: PayHub MCP Server

Примечания по проектированию сервиса

• Сервис предоставляет 6 инструментов (Tool) в соответствии с реальными бизнес-сценариями, а не раскладывает инструменты по количеству вышестоящих API.

• Если пользователь указывает только краткое наименование компании, сначала используйте recruitment_enterprise_search, чтобы получить полное наименование или стабильный ID компании.

• Два Product ID — для деталей найма и статистики найма — повторно используются инструментами в разных сценариях.

• recruitment_demand_analysis выбирает детали или статистику через view и за один вызов обращается только к одному Product ID.

• Внешний слой постраничных результатов содержит только total и resultList; максимальное значение pageSize — 50.

• Длинные списки в профиле и статистике ограничиваются параметром listLimit: по умолчанию 50, максимум 200.

• recruitment_trend возвращает только количество вакансий, статистику за последние три месяца, частоту обновления и среднюю зарплату, чтобы не дублировать длинные списки профиля.

Требования к окружению

• 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.

5. Настройка MCP в Cursor / Cherry Studio

{
  "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 (необязательный): количество записей на странице, по умолчанию 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 (необязательный): количество записей на странице, по умолчанию 50, максимум 50.

Возвращает: total и resultList; workingSalary может содержать валюту, минимальную и максимальную зарплату.

6. recruitment_trend

Функция: запрос обзора тенденций найма компании; не возвращает помесячный временной ряд.

Основные параметры:

• matchKeyword (обязательный): наименование компании, ID компании, регистрационный номер или единый код социального кредита.

• keywordType (необязательный): тип идентификатора компании.

Возвращает:

• recruitingCurrentCount: текущее количество нанимаемых сотрудников.

• recruitingLastThreeMonthCount: количество нанимаемых сотрудников за последние три месяца.

• recruitingLastThreeMonthNo: количество должностей за последние три месяца.

• recruitingAvgUpdate: средняя частота обновления вакансий.

• recruitingAvgWorkingSalary: средняя зарплата по вакансиям.

Сценарии использования

1. Идентификация компании: подтверждение полного наименования и стабильного идентификатора компании по краткому наименованию или бренду.

2. Исследование потребностей в персонале: просмотр должностей, которые нанимает целевая компания, и направлений подбора персонала.

3. Анализ работодателя: изучение городов найма, льгот, ключевых слов должностей и активности найма компании.

4. Сравнение зарплат: сравнение зарплатных диапазонов разных компаний или должностей.

5. Оценка тенденций найма: анализ текущего масштаба найма, масштаба за последние три месяца и средней частоты обновления.

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 — это обзор текущего периода и последних трёх месяцев, а не помесячный временной ряд.

Примеры запросов

recruitment_enterprise_search (поиск по ключевым словам компании)

1. Какой компании соответствует «Xiaomi»?

2. Найдите точное наименование компании и ID компании по запросу «JD.com».

recruitment_job_search (поиск вакансий)

1. Какие должности в настоящее время открыты в Xiaomi Technology Co., Ltd.?

2. Найдите последние вакансии Beijing JD Century Trading Co., Ltd.

recruitment_employer_profile (профиль найма работодателя)

1. Проанализируйте города найма, льготы и профиль должностей Xiaomi Technology Co., Ltd.

2. Какова средняя зарплата по вакансиям Gree Electric Appliances, Inc. of Zhuhai?

recruitment_demand_analysis (анализ потребностей в найме)

1. Обобщите структуру потребностей в персонале какой-либо компании.

2. Перечислите конкретные потребности в должностях целевой компании.

recruitment_salary (запрос зарплат по вакансиям)

1. Посмотрите диапазон зарплат по вакансиям Xiaomi Technology Co., Ltd.

2. Каков уровень зарплат по должностям Gree Electric Appliances, Inc. of Zhuhai?

recruitment_trend (обзор тенденций найма)

1. Какова текущая активность найма и тенденция за последние три месяца у Xiaomi Technology Co., Ltd.?

2. Запросите недавнее количество нанимаемых сотрудников, количество должностей и среднюю зарплату JD.com.

Тестирование и проверка

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

Модульные тесты используют имитированные (Mock) HTTP-ответы и не обращаются к реальному интерфейсу найма HandaaS.