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
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
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
Install
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 .envSetup from the README; on Linux you additionally need playwright install-deps.
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 80Limitations
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.
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. |
Security check
- 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
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.
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.
Related
A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI