hh-mcp-ru
API de hh.ru en asistente de IA: vacantes, respuestas, currículos, estadísticas de salarios. 133 métodos, la escritura solicita confirmación.
Documentación
hh-mcp-ru
API hh.ru para asistentes de IA: vacantes, respuestas e invitaciones, currículums, directorios, estadísticas de salarios. Catálogo de la especificación oficial, cada método con su clase de acceso.
El catálogo se recopila de la fuente original (la especificación oficial api.hh.ru/openapi/specification/public) y se encuentra en el repositorio como
hh_mcp/endpoints.yaml: 133 métodos, de los cuales 92 de lectura,
32 de escritura y 9 irreversibles. El servidor ejecuta exactamente este archivo,
por lo que la tabla siguiente no puede diferir del código.
Instalación
uvx hh-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"hh-mcp": {
"command": "uvx",
"args": ["hh-mcp-ru"],
"env": { "HH_TOKEN": "...", "HH_APP_NAME": "..." }
}
}
}
Claves
dev.hh.ru → Mis aplicaciones → crear aplicación → access token. HH_APP_NAME se completa obligatoriamente: hh rechaza solicitudes sin un User-Agent claro, y esta es la primera causa de errores 400 inexplicables.
| variable | secreto | qué es |
|---|---|---|
HH_TOKEN | sí | Token de aplicación hh.ru (dev.hh.ru → Mis aplicaciones). |
HH_APP_NAME | no | Nombre de la aplicación y email de contacto para el encabezado HH-User-Agent: sin él, hh rechaza las solicitudes. |
Las claves no tienen que estar en el entorno: el servidor admite cuentas y las guarda en
~/.ru-mcp/cabinets.json con permisos 600, fuera del repositorio.
Mapa de métodos
| sección | métodos | lectura | escritura | irreversible |
|---|---|---|---|---|
| Empleador y gerentes | 30 | 23 | 5 | 2 |
| Vacantes | 21 | 12 | 7 | 2 |
| Directorios generales | 14 | 6 | 7 | 1 |
| Sugerencias | 11 | 11 | 0 | 0 |
| Respuestas e invitaciones | 10 | 5 | 5 | 0 |
| Búsquedas guardadas | 6 | 2 | 3 | 1 |
| Estadísticas de salarios | 5 | 5 | 0 | 0 |
| Webhooks | 4 | 1 | 2 | 1 |
| Comentarios al candidato | 4 | 1 | 2 | 1 |
| Currículums | 3 | 3 | 0 | 0 |
| Llamadas | 3 | 3 | 0 | 0 |
| Regiones | 3 | 3 | 0 | 0 |
| Tokens | 2 | 0 | 1 | 1 |
| Instituciones educativas | 2 | 2 | 0 | 0 |
| Locales | 2 | 2 | 0 | 0 |
| Metro | 2 | 2 | 0 | 0 |
| Usuario actual | 1 | 1 | 0 | 0 |
| Cuentas de gerentes | 1 | 1 | 0 | 0 |
| Sectores | 1 | 1 | 0 | 0 |
| Diccionarios | 1 | 1 | 0 | 0 |
| Roles profesionales | 1 | 1 | 0 | 0 |
| Idiomas | 1 | 1 | 0 | 0 |
| Habilidades | 1 | 1 | 0 | 0 |
| Clickme | 1 | 1 | 0 | 0 |
| Distritos | 1 | 1 | 0 | 0 |
| Plantillas de mensajes | 1 | 1 | 0 | 0 |
| Condiciones de publicación de vacantes | 1 | 1 | 0 | 0 |
| total | 133 | 92 | 32 | 9 |
Cómo se ve en el chat
Usted: búsqueda de vacantes
hh_search_methods("поиск вакансий")
hh_get_vacancies GET /vacancies чтение
hh_get_vacancies_related_to_vacancy GET /vacancies/{vacancy_id}/related_vacancies чтение
hh_get_vacancies_similar_to_vacancy GET /vacancies/{vacancy_id}/similar_vacancies чтение
hh_describe_method("hh_get_vacancies")
Поиск по вакансиям
GET api.hh.ru/vacancies
параметры: page, per_page, text, search_field, experience, employment, schedule, area и ещё 36
класс доступа: чтение
hh_call_method("hh_get_vacancies", {"page": "...", "per_page": "..."})
Tres herramientas en lugar de 133 funciones: el agente busca el método con palabras, lee su tarjeta y lo invoca. Las acciones de escritura e irreversibles piden confirmación.
Lo que suele pedirse:
- Exportar sus vacantes y respuestas por período y resumirlas en una tabla.
- Consultar estadísticas de salarios por rol antes de publicar una vacante.
- Encontrar vacantes de competidores por región y rol profesional.
- Responder a candidatos con una plantilla, mostrando la lista a la persona antes de enviarla.
Seguridad
El servidor funciona en la máquina del usuario, las claves no salen al exterior. Los métodos tienen tres clases de acceso: la lectura se ejecuta de inmediato, la escritura y las acciones irreversibles requieren confirmación. El encabezado de autorización no sale de los dominios del servicio incluso al invocar una ruta arbitraria.
Verificar la instalación
uvx hh-mcp-ru doctor
Imprime cuántos métodos se cargaron, si se encontraron las claves y de dónde. No muestra
secretos. Con --live realiza una llamada real de lectura de bajo costo.
Familia
El núcleo está extraído en schema-mcp-core. Servidores vecinos: vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Los marketplaces viven por separado: marketplaces-mcp-ru.
MIT. Autor Ilya Utov.
Todos los proyectos en una lista, clasificados por propósito: ilyautov.github.io.