SkillFoxx

hh-ru-apply skill

Job search automation for hh.ru: vacancy collection, LLM-scored CV matching, cover letters and applications

  • 199 ★ on the repository
  • Last commit
  • MIT
Skill

Broad access

Why this level

  • Automates applications on your behalf, which may lead to hh.ru account restrictions under its rules
  • Stores the browser session and CV locally, and sends vacancy and CV text to an external LLM via OpenRouter
All reasons and checks
Russian stack

steev193/hh-ru-applyAuthor:Steev193

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/hh-ru-apply

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

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

  • Automates applications on your behalf, which may lead to hh.ru account restrictions under its rules
  • Stores the browser session and CV locally, and sends vacancy and CV text to an external LLM via OpenRouter

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

What it does

A Node.js and Playwright project automates a job seeker's own hh.ru search. Scripts collect vacancies by keyword, score them via an LLM (OpenRouter) on three axes (relevance, CV match, overall), generate personalized cover letters in your own style, and insert them into the application form. A web dashboard lets you review the queue and edit letters before sending, there is Telegram-channel vacancy scanning, and a separate hh-fill-letter mode that only fills the text without auto-sending. The browser session is saved locally so you do not need to log in again. The author explicitly warns that mass actions may violate hh.ru's rules and lead to account restriction.

Who it is for. For job seekers on hh.ru who want to automate vacancy screening and cover letter writing for their own resume.

Good fit when

  • You are job hunting on hh.ru and want an LLM to score vacancies against your CV
  • You want personalized cover letters in your own style without writing each one by hand
  • You want to review and edit a letter in the dashboard before sending it, not send blindly

Not a fit when

  • You are not willing to risk hh.ru account restrictions from automated mass actions
  • You are looking for a tool to pitch outside companies, not to search for a job yourself
  • You have no CV in a supported .md, .txt or .pdf format for the LLM to score

Example request

Collect fresh Python developer vacancies in Moscow, score them against my CV, and prepare cover letters for the top five

Limitations

The author explicitly warns that automated applications and mass actions may violate hh.ru's rules and lead to account restriction, so use is at your own risk. Vacancy scoring via OpenRouter needs an API key, with a free model used by default. Applications only go through your own logged-in browser profile, not hh.ru's official API.

How to disable. Delete the hh-ru-apply folder and the local browser profile in data/session, or stop Docker Compose with docker compose down.

FAQ

Are applications sent automatically?

There is a separate hh-fill-letter command that only fills the letter without sending, and npm run apply for the full cycle; it is the user's choice.

Do I need a paid OpenRouter plan?

No, a free model is used by default; paid models are enabled with the OPENROUTER_ALLOW_PAID=1 flag.

How is hh-ru-apply different from ordinary auto-apply tools for hh.ru?

The Node.js and Playwright project job hunts on your behalf: it collects vacancies by keywords, scores them against your CV through an LLM (OpenRouter), writes cover letters and prepares applications.

How do I install hh-ru-apply and does it send applications by itself?

Clone the repository with git clone https://github.com/Steev193/hh-ru-apply.git and install dependencies per the README. Applications go out from your account, so check letters before sending. Risk is high. It fits Cursor.

Discussion

No questions or reviews yet.

All hh.ru tools
Russian stack

A Node.js and Playwright script suite that searches hh.ru vacancies, scores them with an LLM, drafts cover letters and opens the application in a browser

CLIBroad access2
Russian stack

An MCP server that parses an hh.ru vacancy, researches the candidate's GitHub, writes a 150-220 word cover letter, and preps 12 HR answers

MCP serverExtended access
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 that emulates an hh.ru browser session via Playwright for search, AI vacancy scoring and automatic applications with a daily cap

MCP serverBroad access1
Russian stack

An HH.ru vacancy monitor: Telegram alerts for every new listing, on-demand Mistral analysis behind a button, and MCP tools for DeepSeek Harness

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

README in short

The Russian README openly warns about the risk of account restriction from automation and describes eight npm commands: session login, vacancy search, LLM harvesting and scoring, a web dashboard, Telegram scanning, letter filling without sending, chat replies, and Playwright selector generation via Codegen. It gives two run modes, local and Docker Compose with the dashboard on port 3849, and detailed setup for the CV, letter template, and OpenRouter and Telegram bot keys.

README badge

Report a problem