hh-mcp: 52 инструмента для hh.ru

Установка

npx skillfoxx add mcp/andreytepaykin-hh-mcp

claude mcp add --transport stdio hh -- npx -y @andrey-tepaykin/hh-mcp

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

code --add-mcp '{"name":"hh","type":"stdio","command":"npx","args":["-y","@andrey-tepaykin/hh-mcp"]}'

{
  "servers": {
    "hh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

codex mcp add hh -- npx -y @andrey-tepaykin/hh-mcp

[mcp_servers.hh]
command = "npx"
args = ["-y", "@andrey-tepaykin/hh-mcp"]

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcp": {
    "hh": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "context_servers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

claude mcp add hh -- npx -y @andrey-tepaykin/hh-mcp

Что делает

Сервер оборачивает официальный API hh.ru (dev.hh.ru) в 52 инструмента. Без токена доступны поиск вакансий по ключевым словам, региону, роли, зарплате и опыту, карточка вакансии, похожие и связанные вакансии, профили и вакансии работодателей, статистика зарплат по объявлениям, а также все справочники: регионы, отрасли, метро, языки, навыки. С токеном работодателя (HH_ACCESS_TOKEN) добавляются поиск резюме, карточки откликов, воронка ATS по этапам, переписка с кандидатами и статистика по менеджерам, но поиск резюме и ATС дополнительно требуют оплаченную подписку на базу резюме, иначе hh.ru отвечает 403. Ответы по умолчанию приходят компактными сводками для LLM, параметр raw: true возвращает полный JSON hh.ru. Встроенный лимитер соблюдает 5 запросов в секунду от hh.ru и повторяет запрос при 429 и 5xx с экспоненциальной задержкой. Есть отдельный HTTP-режим со stateless-эндпоинтом и защитой от DNS-rebinding, и приложенный скилл Claude Code /job-search с готовым алгоритмом поиска и разбора откликов.

Для кого. Для соискателей, которые ищут вакансии и сравнивают зарплаты через агента, и для рекрутеров с платным доступом к hh.ru, которым нужна воронка откликов в чате.

Пример запроса к агенту

Найди удаленные вакансии Python-разработчика в Москве от 300 000 рублей и покажи медианную зарплату

MCP

Транспорт

stdio, http

Авторизация

API-ключ

Ограничения

Основано на проекте @theyahia/hh-mcp, это форк с переработкой, а не оригинальная идея. Поиск резюме и ATS требуют кроме employer-токена оплаченную подписку на базу резюме. Соискательские и анонимные токены получают 403. Встроенный лимитер общий на процесс, поэтому в HTTP-режиме с несколькими клиентами они делят один бюджет 5 запросов в секунду. HTTP-режим по умолчанию слушает только localhost, для внешнего доступа нужно самому настраивать HH_ALLOWED_HOSTS, HH_ALLOWED_ORIGINS и аутентификацию.

Как отключить. Выполните claude mcp remove hh в Claude Code или удалите блок hh из mcpServers в конфигурации клиента.

Коротко о README

README перечисляет 52 инструмента по разделам (вакансии, резюме, ATS/отклики, работодатели, справочники, зарплаты), таблицу режимов без токена и с токеном, инструкции установки для Claude Desktop, Claude Code, VS Code/Cursor, Windsurf и отдельного HTTP-режима, переменные окружения и демо-промпты. Указано, что проект основан на @theyahia/hh-mcp. Лицензия MIT.