HeadHunter

HeadHunter (hh.ru) is the largest job platform in Russia and the CIS. AllMCP provides 16 tools for vacancy and employer search, your own profile and resumes, job applications and recruiter chat, plus the reference data those searches need.

All providers How connecting works

Connect

HeadHunter uses OAuth2, so there is nothing to copy by hand — no API key, no token.

Ask your agent to connect HeadHunter

Tell your agent to connect the headhunter provider. It returns a secure sign-in link.
Sign in on hh.ru and approve

Open the link, sign in to your hh.ru account, and approve the request. That is the only manual step.

Tools by category

Once HeadHunter is connected, your agent can use the tools below. You don’t need to call anything by name — just describe what you want in plain language and the agent picks the right tool.

Vacancies

Tool	What it does
`headhunter_search_vacancies`	Searches hh.ru vacancies by keyword, region, professional role, employer, salary, experience level, employment type and schedule, or publication date, and sorts by relevance, salary or publication time.
`headhunter_get_vacancy`	Returns one vacancy in full — description, key skills, address, and whether it requires a cover letter or a test before you can apply.
`headhunter_list_similar_vacancies`	Returns hh.ru’s own recommendations for vacancies similar to a given one, useful for widening a thin result set.

Employers

Tool	What it does
`headhunter_search_employers`	Searches companies by name and region, optionally only those with open vacancies, sorted by name or by number of openings.
`headhunter_get_employer`	Returns one company’s profile — description, industries, and its open vacancy count.

Resumes

Tool	What it does
`headhunter_get_my_profile`	Returns the connected hh.ru user’s profile — name, email and account-type flags. Also the quickest way to confirm the connection works.
`headhunter_list_my_resumes`	Lists your own resumes with their title, region, status, visibility and last update. This is where the resume ID for an application comes from.
`headhunter_get_resume`	Returns one of your own resumes in full.

Negotiations

Tool	What it does
`headhunter_list_negotiations`	Lists your job applications and their current stage, filtered by collection, by vacancy, or to only those with unread updates.
`headhunter_get_negotiation`	Returns one application with its current state, the vacancy and the resume it was sent with.
`headhunter_list_negotiation_messages`	Lists the chat messages inside one application thread, with author, timestamp and read state.
`headhunter_send_negotiation_message`	Sends a real message to the employer inside an existing application thread.
`headhunter_apply_to_vacancy`	Submits a real job application to a vacancy with one of your resumes and an optional cover letter. Requires an explicit confirmation before it fires.

Reference

Tool	What it does
`headhunter_list_areas`	Lists hh.ru regions one level at a time — countries first, then their regions, then cities — giving the region IDs that search filters expect.
`headhunter_list_professional_roles`	Lists hh.ru’s professional-role categories and the roles inside them, giving the role IDs used to filter a vacancy search.
`headhunter_get_dictionaries`	Returns hh.ru’s reference dictionaries — experience levels, employment types, schedules, currencies and more — so filters use current values rather than guesses.

Common workflows

Here are a few things you can simply ask your agent to do once HeadHunter is connected.

Find remote Python developer jobs in Moscow paying at least 300,000 a month, highest salary first

List every open role at Ozon posted in the last week

Apply to vacancy 98765432 with my main CV and mention that I can start in two weeks

Which of my applications have new messages? Reply to the one from Yandex saying Thursday afternoon works

Show my active applications and tell me which ones got an invitation or a rejection

Good to know

Applying is real and final. Your agent asks you to confirm the vacancy, resume and cover letter before it submits, because nothing here can withdraw an application, unsend a message, or accept and decline an invitation afterwards.
Some vacancies can’t be applied to through an app. A vacancy that routes applications to the employer’s own site, or requires a test, has to be finished on hh.ru — your agent will tell you when that happens and point you to the listing.
Filters run on IDs, not names. Regions, professional roles and employers are matched by hh.ru’s own IDs, and an unrecognised value is quietly ignored rather than rejected. Your agent looks the right ID up first — which is what the reference tools are for.
This is the job-seeker side of hh.ru. Searching the paid resume database and publishing or editing vacancies as an employer are not part of this integration.
Regional sites. hh.ru covers Russia, Kazakhstan, Uzbekistan, Belarus and neighbouring markets. Narrow to a country or city with the region filter rather than expecting results to be geo-limited by default.
Deep result sets are capped. hh.ru stops paging vacancy search at about 2,000 results and employer search at about 5,000, so tighter filters beat paging further.
Roughly once a fortnight, access renews. hh.ru only lets AllMCP renew your access after the old token lapses, so there can be a few minutes where calls answer “auto-refresh in progress”. Just try again shortly — you do not need to reconnect.

All providers Browse every integration AllMCP supports.

How it works One endpoint, every integration.