Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@hh-vacancy-mcp Search HH.ru for frontend developer jobs matching my resume, min score 75"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Claude Code that searches HH.ru using an authenticated browser session and returns vacancies matching a resume.
TypeScript MCP server over stdio.
Playwright browser control.
Chrome/Edge CDP connection to reuse an existing logged-in session.
Persistent profile mode for Chrome, Edge, or Firefox.
Local deterministic 0–100 resume matching score.
Default minimum score: 70; change it with set_min_score or the bundled Claude Code skill.
No HH.ru credentials are collected or stored.
Related MCP server: HH MCP Server
npm install
npx playwright install chromium firefox
npm run buildAdd the built server to Claude Code's MCP configuration:
{
"mcpServers": {
"hh-vacancy-mcp": {
"command": "node",
"args": ["C:/Users/nazmi/Documents/GitHub/hh-vacancy-mcp/dist/src/index.js"]
}
}
}Close the normal browser instance, then start a separate instance with remote debugging and a dedicated profile. Example on Windows:
"C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\\Users\\<you>\\hh-mcp-profile"For Edge, use msedge.exe and set browser to edge with set_browser.
Open https://hh.ru, log in manually, then use set_browser with mode cdp and search. Cookies remain in the browser profile and are never returned by this server.
Use set_browser with mode: "persistent" and a profile directory. Open HH.ru and authenticate manually once. Firefox should use persistent mode because it does not provide the CDP connection used here.
set_browser if the default Chrome/CDP settings do not fit.
set_resume with the resume text.
set_min_score with a value from 0 to 100, or keep 70.
search_hh_vacancies with a query and optional area/page limit.
Search is read-only and limited to five result pages per call. HH.ru markup can change; if no cards are found, check the browser session and report the issue rather than guessing.
npm run typecheck
npm test
npm run buildShow current browser and resume matching settings.
Inputs: no named parameters.
Search HH.ru in the selected authenticated browser and return only vacancies meeting the configured score threshold.
Inputs: query (required), area, pageLimit.
Choose browser and session connection mode. CDP reuses an already logged-in Chrome or Edge.
Inputs: mode, cdpUrl, browser, profileDir.
Set the minimum vacancy-to-resume match score from 0 to 100. Default is 70.
Inputs: minScore (required).
Store resume text locally for matching. Do not include passwords or unrelated secrets.
Inputs: resume (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool targets a distinct concern: reading settings, updating the score threshold, choosing the browser, storing the resume, and running the search. There is no meaningful overlap between any of the five tools.
The naming follows a clear and consistent verb-based pattern: get_settings, set_min_score, set_browser, set_resume, and search_hh_vacancies. The set_ prefix is used uniformly for configuration changes, and the search tool is action-oriented.
Five tools is well-scoped for this focused MCP server. Each tool represents one essential capability for configuring and running HH.ru vacancy searches against a resume.
The tool surface covers the full workflow: configure the match threshold, select an authenticated browser, set the resume text, view current settings, and execute the search. No obvious dead ends or missing lifecycle steps are present for the stated purpose.
A job-search companion: tailor your CV to a role, score fit, fix ATS issues. Also via MCP.
Automate your job search: find jobs, upload a resume, apply automatically, and track applications.
Search jobs, review confirmed CV facts and prepare documents with scoped OAuth access.
Check a CV against Dutch hiring norms, compare it with a vacancy, and open it in WerkCV.