Skip to main content
Glama
deenesjakoruzh
theYahia

@theyahia/hh-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@theyahia/hh-mcp

MCP-Server für die hh.ru API — Arbeitsmarkt in Russland und der GUS. 19 Tools für Stellenangebote, Lebensläufe, Arbeitgeber, Gehaltsstatistiken, Wörterbücher, Autovervollständigung und Token-Diagnose.

Antworten werden standardmäßig als kompakte, LLM-freundliche Zusammenfassungen zurückgegeben — übergebe raw: true an ein Such-/Detail-Tool, um das vollständige hh.ru-JSON zu erhalten.

npm CI License: MIT

Teil der Russian API MCP-Serie von @theYahia.

Zwei Modi

Modus

Verfügbare Funktionen

Token erforderlich?

Ohne Token

Stellensuche, Stelle nach ID, ähnliche Stellen, Arbeitgeber, Gehaltsstatistiken, Regionen, Rollen, Branchen, U-Bahn, Wörterbücher, Vorschläge, Token-Prüfung

Nein

Mit Token

Alles oben + Lebenslauf-Suche, Lebenslauf nach ID

Ja (HH_ACCESS_TOKEN)

Hole ein Token unter dev.hh.ru/admin. Hinweis: Die Lebenslauf-Suche erfordert zusätzlich ein Arbeitgeber-Konto mit einem kostenpflichtigen Lebenslauf-Datenbank-Abonnement — Bewerber-/anonyme Tokens erhalten eine 403. Verwende validate_token, um zu prüfen, was dein Token kann.

Related MCP server: laddro-career-mcp

Installation

Claude Desktop

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "optional-oauth-token"
      }
    }
  }
}

Claude Code

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

VS Code / Cursor

{
  "servers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"]
    }
  }
}

Windsurf

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

HTTP-Modus (Streamable HTTP)

npx @theyahia/hh-mcp --http
# or
HTTP_PORT=8080 npx @theyahia/hh-mcp --http

Endpunkt: http://localhost:3000/mcp (POST) · Health-Check: http://localhost:3000/health (GET)

Der HTTP-Modus ist zustandslos und bindet standardmäßig an 127.0.0.1 mit aktivem DNS-Rebinding-Schutz. Um ihn freizugeben, setze HOST=0.0.0.0 und füge deinen Host/Origin zu HH_ALLOWED_HOSTS / HH_ALLOWED_ORIGINS hinzu, und platziere ihn hinter deiner eigenen Authentifizierung.

Umgebungsvariablen

Variable

Erforderlich

Beschreibung

HH_ACCESS_TOKEN

Nein

OAuth-2.0-Bearer-Token. Erforderlich für Lebenslauf-Endpunkte (Arbeitgeber + kostenpflichtige Lebenslauf-DB).

HH_USER_AGENT

Nein

Benutzerdefinierter HH-User-Agent (von hh.ru verlangt). Empfehlung: your-app/1.0 (you@example.com).

HTTP_PORT / PORT

Nein

Port für den HTTP-Modus (Standard: 3000).

HOST

Nein

Schnittstelle für den HTTP-Modus (Standard: 127.0.0.1).

HH_ALLOWED_HOSTS

Nein

Kommagetrennte Host-Whitelist für den HTTP-Modus (Standard: Loopback).

HH_ALLOWED_ORIGINS

Nein

Kommagetrennte Origin-Whitelist für den HTTP-Modus.

Siehe .env.example.

Tools (19)

Jedes Such-/Detail-Tool akzeptiert raw: true, um das vollständige hh.ru-JSON anstelle der kompakten Zusammenfassung zurückzugeben.

Stellenangebote

Tool

Beschreibung

Token?

search_vacancies

Suche nach Schlüsselwörtern, Region, beruflicher Rolle, Branche, U-Bahn, Arbeitgeber, Gehalt, Erfahrung, Arbeitsform / Beschäftigungsart, Datumsbereich (period oder date_from/date_to), Labels, Suchfeld, mit Sortierung und Paginierung

Nein

get_vacancy

Vollständige Stellendetails: Beschreibung, Anforderungen, Schlüsselqualifikationen, Kontakte

Nein

get_similar_vacancies

Finde ähnliche Stellen zu einer bestimmten

Nein

Lebensläufe (Arbeitgeber-Token + kostenpflichtige Lebenslauf-DB)

Tool

Beschreibung

Token?

search_resumes

Suche Kandidaten-Lebensläufe nach Schlüsselwörtern, Region, Rolle, Gehalt, Erfahrung

Ja

get_resume

Vollständiger Lebenslauf: Erfahrung, Bildung, Fähigkeiten, Kontakte

Ja

Arbeitgeber

Tool

Beschreibung

Token?

search_employers

Suche Unternehmen nach Name und Region

Nein

get_employer

Arbeitgeberprofil: Beschreibung, Branchen, Website, Anzahl offener Stellen

Nein

get_employer_vacancies

Liste aktiver Stellen für einen bestimmten Arbeitgeber

Nein

Wörterbücher & Vorschläge

Tool

Beschreibung

Token?

get_areas

Baum der Regionen und Städte (id — name)

Nein

get_areas_subtree

Regionen/Städte unter einer Bereichs-ID — leichter als der vollständige Baum

Nein

get_professional_roles

Baum der beruflichen Rollen mit IDs

Nein

get_industries

Baum der Unternehmensbranchen mit IDs

Nein

get_metro

U-Bahn-Stationen/-Linien mit IDs für eine Stadt

Nein

get_dictionaries

Alle Referenzdaten: Währungen, Beschäftigungsarten, Arbeitszeiten, Erfahrung, Labels

Nein

suggest_positions

Autovervollständigung von Berufsbezeichnungen

Nein

suggest_companies

Autovervollständigung von Firmennamen

Nein

suggest_areas

Autovervollständigung von Regions-/Städtenamen

Nein

Gehalt & Konto

Tool

Beschreibung

Token?

get_salary_statistics

Geschätzte Gehaltsverteilung (Median, P25/P75, Min/Max) für eine Rolle in einer Region, berechnet aus veröffentlichten Stellen-Gehältern. Verzerrte Stichprobe, keine offiziellen Marktdaten.

Nein

validate_token

Prüfe, ob HH_ACCESS_TOKEN gültig ist (über /me) und melde die Kontorolle

Nein

Ratenbegrenzung

Der integrierte Ratenbegrenzer respektiert das hh.ru-API-Limit von 5 Anfragen pro Sekunde. Automatischer Wiederholungsversuch mit exponentiellem Backoff bei 429- und 5xx-Fehlern (bis zu 3 Versuche). Hinweis: Der Begrenzer ist prozessglobal, sodass im gemeinsamen HTTP-Modus alle Clients ein gemeinsames Budget von 5 req/s teilen.

Demo-Prompts

Find remote Python developer jobs in Moscow paying over 300,000 RUB
Show me all open vacancies at Yandex and give me salary statistics for their top roles
Compare Senior Backend salaries in Moscow vs Saint Petersburg, and suggest similar vacancies to the best-paying one

Entwicklung

git clone https://github.com/theYahia/hh-mcp.git
cd hh-mcp
npm install
npm run build
npm test

API-Referenz

Lizenz

MIT

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • HeadHunter MCP Server

    gmen1057
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to search job vacancies, manage resumes, and apply to jobs on HeadHunter (hh.ru), Russia's largest job search platform. Includes OAuth 2.0 integration for secure job applications and an automated vacancy hunter agent with intelligent matching.
    27
    MIT

  • HuntFlow MCP Server

    theYahia
    A
    license
    B
    quality
    C
    maintenance
    Integrates with HuntFlow ATS to manage vacancies, candidates, resumes, and recruitment stages via 7 tools and 2 skill prompts.
    7
    50
    1
    MIT

  • HeadHunter API MCP Server

    sargonpiraev
    A
    license
    Not graded
    quality
    F
    maintenance
    Enables AI assistants to access and manage HeadHunter job platform data, including vacancies, resumes, negotiations, and employer settings via 167+ tools.
    85
    5
    MIT

View all related MCP servers

Related MCP Connectors

  • YouTube Transcript & Search MCP Server

    YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.

  • Human Pages

    Hire real humans for tasks agents can't do alone. 36 tools for the full hiring lifecycle.

  • Sugra API

    Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

View all MCP Connectors

Latest Blog Posts

MCP directory API

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