Servidor MCP para la API de hh.ru — el mercado laboral de Rusia y la CEI. 19 herramientas que cubren vacantes, currículums, empleadores, estadísticas salariales, diccionarios, autocompletado y diagnóstico de tokens.
Las respuestas se devuelven como resúmenes compactos y aptos para LLM de forma predeterminada: pasa raw: true a cualquier herramienta de búsqueda/detalle para obtener el JSON completo de hh.ru.
Parte de la serie Russian API MCP de @theYahia.
Modo | Qué está disponible | ¿Token necesario? |
Sin token | Búsqueda de vacantes, vacante por ID, vacantes similares, empleadores, estadísticas salariales, áreas, roles, industrias, metro, diccionarios, sugerencias, verificación de token | No |
Con token | Todo lo anterior + búsqueda de currículums, currículum por ID | Sí ( |
Obtén un token en dev.hh.ru/admin. Nota: la búsqueda de currículums además requiere una cuenta de empleador con una suscripción de pago a la base de datos de currículums — los tokens de solicitante/anónimos reciben un 403. Usa validate_token para comprobar qué puede hacer tu token.
Related MCP server: laddro-career-mcp
{
"mcpServers": {
"hh": {
"command": "npx",
"args": ["-y", "@theyahia/hh-mcp"],
"env": {
"HH_ACCESS_TOKEN": "optional-oauth-token"
}
}
}
}claude mcp add hh -- npx -y @theyahia/hh-mcp
# With token:
claude mcp add hh -e HH_ACCESS_TOKEN=your-token -- npx -y @theyahia/hh-mcp{
"servers": {
"hh": {
"command": "npx",
"args": ["-y", "@theyahia/hh-mcp"]
}
}
}{
"mcpServers": {
"hh": {
"command": "npx",
"args": ["-y", "@theyahia/hh-mcp"]
}
}
}npx @theyahia/hh-mcp --http
# or
HTTP_PORT=8080 npx @theyahia/hh-mcp --httpEndpoint: http://localhost:3000/mcp (POST) · Comprobación de salud: http://localhost:3000/health (GET)
El modo HTTP es sin estado y se vincula a 127.0.0.1 de forma predeterminada con protección contra reenlace de DNS activada. Para exponerlo, establece HOST=0.0.0.0 y añade tu host/origen a HH_ALLOWED_HOSTS / HH_ALLOWED_ORIGINS, y colócalo detrás de tu propia autenticación.
Variable | ¿Requerida? | Descripción |
| No | Token Bearer OAuth 2.0. Requerido para los endpoints de currículums (empleador + base de datos de pago). |
| No |
|
| No | Puerto para el modo HTTP (predeterminado: 3000). |
| No | Interfaz a la que vincularse en el modo HTTP (predeterminado: |
| No | Lista de Hosts permitidos separados por comas para el modo HTTP (predeterminado: loopback). |
| No | Lista de Orígenes permitidos separados por comas para el modo HTTP. |
Consulta .env.example.
Cada herramienta de búsqueda/detalle acepta raw: true para devolver el JSON completo de hh.ru en lugar del resumen compacto.
Herramienta | Descripción | ¿Token? |
| Busca por palabras clave, región, rol profesional, industria, metro, empleador, salario, experiencia, formato de trabajo / tipo de empleo, rango de fechas ( | No |
| Detalles completos de la vacante: descripción, requisitos, habilidades clave, contactos | No |
| Encuentra vacantes similares a una dada | No |
Herramienta | Descripción | ¿Token? |
| Busca currículums de candidatos por palabras clave, región, rol, salario, experiencia | Sí |
| Currículum completo: experiencia, educación, habilidades, contactos | Sí |
Herramienta | Descripción | ¿Token? |
| Busca empresas por nombre y región | No |
| Perfil del empleador: descripción, industrias, sitio web, número de vacantes | No |
| Lista las vacantes activas de un empleador específico | No |
Herramienta | Descripción | ¿Token? |
| Árbol de regiones y ciudades ( | No |
| Regiones/ciudades bajo un id de área — más ligero que el árbol completo | No |
| Árbol de roles profesionales con IDs | No |
| Árbol de industrias de empresas con IDs | No |
| Estaciones/líneas de metro con IDs para una ciudad | No |
| Todos los datos de referencia: monedas, tipos de empleo, horarios, experiencia, etiquetas | No |
| Autocompletar títulos de puestos | No |
| Autocompletar nombres de empresas | No |
| Autocompletar nombres de regiones/ciudades | No |
Herramienta | Descripción | ¿Token? |
| Distribución salarial estimada (mediana, P25/P75, mín/máx) para un rol en una región, calculada a partir de los salarios de vacantes publicadas. Muestra sesgada, no son datos oficiales del mercado. | No |
| Comprueba si | No |
El limitador de velocidad integrado respeta el límite de la API de hh.ru de 5 solicitudes por segundo. Reintento automático con retroceso exponencial en errores 429 y 5xx (hasta 3 intentos). Nota: el limitador es global al proceso, por lo que en el modo HTTP compartido todos los clientes comparten un presupuesto de 5 req/s.
Find remote Python developer jobs in Moscow paying over 300,000 RUBShow me all open vacancies at Yandex and give me salary statistics for their top rolesCompare Senior Backend salaries in Moscow vs Saint Petersburg, and suggest similar vacancies to the best-paying onegit clone https://github.com/theYahia/hh-mcp.git
cd hh-mcp
npm install
npm run build
npm testMIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.
Hire real humans for tasks agents can't do alone. 36 tools for the full hiring lifecycle.
Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/hh-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server