SkillFoxx

HH.ru MCP Server: browser auto-apply

HH.ru MCP Server

An MCP server that emulates an hh.ru browser session via Playwright for search, AI vacancy scoring and automatic applications with a daily cap

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Can automatically submit applications with an AI-generated letter without a mandatory manual review of each one
  • Uses Playwright stealth settings explicitly aimed at evading hh.ru's anti-bot defenses, which can lead to an account ban
All reasons and checks
Russian stack

vadtop/hh-mcp-serverAuthor:Vadtop

Install

Services

Manual install

git clone https://github.com/vadtop/hh-mcp-server.git && cd hh-mcp-server && pip install -r requirements.txt && playwright install chromium && cp .env.example .env

Setup from the README; on Linux you additionally need playwright install-deps.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Can automatically submit applications with an AI-generated letter without a mandatory manual review of each one
  • Uses Playwright stealth settings explicitly aimed at evading hh.ru's anti-bot defenses, which can lead to an account ban

This is third-party code. Review the repository files before installing.

What it does

After hh.ru closed its public API for job seekers on December 15, 2025, the server restores search and auto-apply through Playwright with stealth settings: a spoofed Chrome 133 user agent, a randomized viewport, anti-bot delays, with the session stored in cookies and localStorage and lasting about 30 days. Twenty MCP tools cover search and similar vacancies, applying with an AI-generated cover letter, application history, resume management, and analytics: TF-IDF, skills and salary vacancy scoring, labor market analysis, a skills-gap report, and a salary forecast after learning new skills. A SQLite applied.db prevents applying to the same vacancy twice, and MAX_APPLIES_PER_DAY caps daily applications (default 20). There's background monitoring of application statuses and an hh_health_check diagnostic tool.

Who it is for. For job seekers willing to accept the risk of automating hh.ru through browser emulation in exchange for large-scale AI-assisted auto-apply.

Good fit when

  • You're willing to accept the risk of violating hh.ru's terms in exchange for automatic applications with a daily cap
  • You need AI scoring of vacancies against your resume and market salary and skills analytics before applying
  • You need a career report: skills gap, roadmap, salary forecast

Not a fit when

  • You don't want to use stealth browser emulation that is explicitly aimed at evading hh.ru's bot defenses
  • You need only the official API with no account-ban risk: the README explicitly says usage may violate hh.ru's terms
  • You aren't willing to review cover letters before they go out: the tool can apply automatically with an AI-written letter

Example request

Find Python developer vacancies from 250,000 and score them against my resume, only apply above a score of 80

MCP

Transport
stdio, http
Authentication
not required

Environment variables

MAX_APPLIES_PER_DAY
Daily limit for automatic applications, defaults to 20.
SCORING_THRESHOLD
The minimum AI vacancy score below which an application is not sent.

Limitations

The English README states explicitly: usage may violate hh.ru's Terms of Service, the author takes no responsibility for account restrictions or bans, rate limiting or CAPTCHA, and the tool is intended for personal use only. The anti_detect.py module and Playwright's stealth settings are explicitly aimed at evading hh.ru's automation defenses. It requires a first manual login with an SMS code, and the session expires after about 30 days. The author advises setting reasonable MAX_APPLIES_PER_DAY and SCORING_THRESHOLD values and reviewing cover letters before sending.

How to disable. Stop the run_mcp.py process, remove the server from your MCP client configuration, and delete the .browser_session folder with the saved session.

FAQ

Could hh.ru ban the account for using this server?

The author explicitly warns that usage may violate hh.ru's terms and takes no responsibility for account restrictions or bans.

Can I limit the number of automatic applications per day?

Yes, with the MAX_APPLIES_PER_DAY variable, defaulting to 20, together with the SCORING_THRESHOLD AI score cutoff.

Discussion

No questions or reviews yet.

All hh.ru tools
Russian stack

A browser-based MCP server for job search on hh.ru: resume-matched vacancy recommendations, applications and statuses

MCP serverBroad access3
Russian stack

An MCP server with 52 tools over the official hh.ru API: vacancy search with no token, employer resumes and applications with one, and salary statistics

MCP serverExtended access
Russian stack

An MCP server for the employer side of the hh.ru and hh.kz API: your vacancies, applications, resume search, sourcing and webhooks through an OAuth app

MCP serverBroad access1

hh.ru MCP

hh-mcp

Russian stack

MCP server for the hh.ru API: vacancy and employer search, salary estimates, reference lists, resumes with employer access

MCP serverExtended access10
Russian stack

An MCP server that aggregates vacancies from hh.ru and the public Greenhouse, Ashby, Lever, Workable and Bayt APIs into one format without HTML scraping

MCP serverExtended access1
Russian stack

A local MCP server that controls an open Chrome session via CDP, helps apply on hh.ru, blocks payments and confirms before sending

MCP serverExtended access

README in short

The English README explains that the server restores automation after hh.ru closed its applicant API, describes an architecture with browser, services and AI layers, lists 20 tools, and gives connection instructions for opencode, VS Code and Claude Desktop. A separate Disclaimer section explicitly warns about the risk to hh.ru's terms of service and asks for responsible, personal-only use. MIT license.

README badge

Report a problem