Skip to main content
Glama
deenesjakoruzh
theYahia

@theyahia/hh-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@theyahia/hh-mcp

hh.ru API용 MCP 서버 — 러시아 및 CIS 구인구직 시장. 19개의 도구로 채용공고, 이력서, 고용주, 급여 통계, 사전, 자동완성, 토큰 진단을 다룹니다.

응답은 기본적으로 간결하고 LLM 친화적인 요약으로 반환됩니다. 전체 hh.ru JSON을 얻으려면 검색/상세 도구에 raw: true를 전달하세요.

npm CI License: MIT

@theYahia의 Russian API MCP 시리즈의 일부입니다.

두 가지 모드

모드

사용 가능한 기능

토큰 필요?

토큰 없음

채용공고 검색, ID로 채용공고, 유사 채용공고, 고용주, 급여 통계, 지역, 직무, 산업, 지하철, 사전, 자동완성, 토큰 확인

아니요

토큰 있음

위의 모든 기능 + 이력서 검색, ID로 이력서

예 (HH_ACCESS_TOKEN)

토큰은 dev.hh.ru/admin에서 받을 수 있습니다. 참고: 이력서 검색은 유료 이력서 데이터베이스 구독이 있는 고용주 계정이 추가로 필요합니다. 지원자/익명 토큰은 403 오류가 발생합니다. validate_token을 사용하여 토큰으로 무엇을 할 수 있는지 확인하세요.

Related MCP server: laddro-career-mcp

설치

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 모드 (Streamable HTTP)

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

엔드포인트: http://localhost:3000/mcp (POST) · 상태 확인: http://localhost:3000/health (GET)

HTTP 모드는 상태가 없으며 기본적으로 127.0.0.1에 바인딩되고 DNS 리바인딩 보호가 켜져 있습니다. 외부에 노출하려면 HOST=0.0.0.0을 설정하고 HH_ALLOWED_HOSTS / HH_ALLOWED_ORIGINS에 호스트/오리진을 추가한 후 자체 인증 뒤에 두세요.

환경 변수

변수

필수

설명

HH_ACCESS_TOKEN

아니요

OAuth 2.0 Bearer 토큰. 이력서 엔드포인트(고용주 + 유료 이력서 DB)에 필요합니다.

HH_USER_AGENT

아니요

사용자 지정 HH-User-Agent (hh.ru에서 필수). your-app/1.0 (you@example.com) 형식을 권장합니다.

HTTP_PORT / PORT

아니요

HTTP 모드용 포트 (기본값: 3000).

HOST

아니요

HTTP 모드에서 바인딩할 인터페이스 (기본값: 127.0.0.1).

HH_ALLOWED_HOSTS

아니요

HTTP 모드용 쉼표로 구분된 Host 허용 목록 (기본값: 루프백).

HH_ALLOWED_ORIGINS

아니요

HTTP 모드용 쉼표로 구분된 Origin 허용 목록.

.env.example를 참조하세요.

도구 (19)

모든 검색/상세 도구는 raw: true를 받아 간결한 요약 대신 전체 hh.ru JSON을 반환합니다.

채용공고

도구

설명

토큰?

search_vacancies

키워드, 지역, 전문 직무, 산업, 지하철, 고용주, 급여, 경력, 근무 형태/고용 형태, 날짜 범위(period 또는 date_from/date_to), 라벨, 검색 필드로 검색하며 정렬 및 페이지네이션 지원

아니요

get_vacancy

전체 채용공고 상세: 설명, 요구사항, 핵심 기술, 연락처

아니요

get_similar_vacancies

주어진 채용공고와 유사한 채용공고 찾기

아니요

이력서 (고용주 토큰 + 유료 이력서 DB)

도구

설명

토큰?

search_resumes

키워드, 지역, 직무, 급여, 경력으로 지원자 이력서 검색

예

get_resume

전체 이력서: 경력, 학력, 기술, 연락처

예

고용주

도구

설명

토큰?

search_employers

이름과 지역으로 회사 검색

아니요

get_employer

고용주 프로필: 설명, 산업, 웹사이트, 채용공고 수

아니요

get_employer_vacancies

특정 고용주의 활성 채용공고 목록

아니요

사전 및 자동완성

도구

설명

토큰?

get_areas

지역 및 도시 트리 (id — name)

아니요

get_areas_subtree

하나의 area id 아래의 지역/도시 — 전체 트리보다 가벼움

아니요

get_professional_roles

ID가 있는 전문 직무 트리

아니요

get_industries

ID가 있는 회사 산업 트리

아니요

get_metro

도시의 ID가 있는 지하철 역/노선

아니요

get_dictionaries

모든 참조 데이터: 통화, 고용 형태, 근무 일정, 경력, 라벨

아니요

suggest_positions

직무 제목 자동완성

아니요

suggest_companies

회사 이름 자동완성

아니요

suggest_areas

지역/도시 이름 자동완성

아니요

급여 및 계정

도구

설명

토큰?

get_salary_statistics

추정 급여 분포 (중앙값, P25/P75, 최소/최대)를 지역의 직무에 대해 제공하며, 게시된 채용공고 급여로 계산됩니다. 편향된 표본이며 공식 시장 데이터가 아닙니다.

아니요

validate_token

HH_ACCESS_TOKEN이 유효한지 (/me를 통해) 확인하고 계정 역할을 보고합니다

아니요

속도 제한

내장 속도 제한기는 hh.ru API의 초당 5회 요청 제한을 준수합니다. 429 및 5xx 오류 시 지수 백오프로 자동 재시도합니다 (최대 3회). 참고: 속도 제한기는 프로세스 전역이므로 공유 HTTP 모드에서는 모든 클라이언트가 하나의 초당 5회 요청 예산을 공유합니다.

데모 프롬프트

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

개발

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

API 참조

라이선스

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