About superjob-mcp
superjob-mcp connects AI assistants to SuperJob.ru for vacancy, employer, and directory searches. Its five tools cover keyword, location, and salary filters; an API key is required.
Key features
- 01Search vacancies by terms, city, and salary
- 02Retrieve vacancy details
- 03Search employers by name and city
- 04Look up city directory
- 05Look up professions and industries
Use cases
- 01Filter vacancies by role, city, and salary
- 02Find employers in a specified city
- 03Check available cities and profession categories
MCP support
It exposes SuperJob.ru vacancy, employer, city, and profession queries to MCP clients through five tools. `SUPERJOB_SECRET_KEY` is required.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @theyahia/superjob-mcpSUPERJOB_API_KEYSecretAPI key for the serviceLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
2Saved tool list · updated 4w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| town | number | No | City ID (4=Moscow, 14=Saint Petersburg) |
| count | integer | No | Количество |
| keyword | string | No | Keywords |
| payment_to | number | No | Salary up to |
| payment_from | number | No | Salary from |
Details
From the project READMESuperJob MCP — поиск вакансий и работодателей через нейросеть
Если вы искали, как попросить ИИ подобрать вакансии на SuperJob под свои критерии, собрать выборку работодателей или следить за зарплатами в профессии без ручного листания сайта — это оно. 5 инструментов поверх SuperJob.ru API: поиск вакансий, работодатели, справочники городов и профессий.
Часть серии Russian API MCP (50 серверов) by @theYahia.
Установка
Claude Desktop (stdio)
{
"mcpServers": {
"superjob": {
"command": "npx",
"args": ["-y", "@theyahia/superjob-mcp"],
"env": {
"SUPERJOB_SECRET_KEY": "ваш-ключ",
"SUPERJOB_APP_ID": "ваш-app-id"
}
}
}
}
Claude Code
claude mcp add superjob -e SUPERJOB_SECRET_KEY=ваш-ключ -e SUPERJOB_APP_ID=ваш-app-id -- npx -y @theyahia/superjob-mcp
Streamable HTTP
npx @theyahia/superjob-mcp --http --port=3000
Smithery
npx -y @smithery/cli install @theyahia/superjob-mcp --client claude
Переменные окружения
| Переменная | Обязательная | Описание |
|---|---|---|
SUPERJOB_SECRET_KEY | Да | API secret key (получить на api.superjob.ru) |
SUPERJOB_APP_ID | Нет | Application ID |
SUPERJOB_API_KEY | Нет | Устаревший вариант (fallback для SECRET_KEY) |
Инструменты (5)
| Инструмент | Описание |
|---|---|
search_vacancies | Поиск вакансий по словам, городу, зарплате |
get_vacancy | Полная информация о вакансии по ID |
search_employers | Поиск работодателей по названию и городу |
get_towns | Справочник городов (поиск, фильтр по стране) |
get_professions | Справочник профессий и отраслей |
Скиллы (Claude Code)
| Команда | Описание |
|---|---|
/find-job <специальность> | Найди вакансии по специальности, городу, зарплате |
/salary <специальность> | Анализ зарплат по специальности |
Примеры
Найди вакансии Python в Москве от 200000
Покажи работодателей в IT в Санкт-Петербурге
Какие города есть в базе SuperJob?
Зарплаты по специальности DevOps
Разработка
npm install
npm run build
npm test
Лицензия
MIT
Telegram: @vhodvai
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.