@theyahia/superjob-mcp
This server lets AI assistants interact with SuperJob.ru via MCP to search jobs, employers, and reference data.
search_vacancies: Find job postings by keyword, town ID, and salary range (payment_from/payment_to), with configurable count up to 100.
get_vacancy: Retrieve full details for a specific vacancy by ID.
search_employers: Search companies by name and town, with paging.
get_towns: Get the SuperJob city directory; search by name, filter by country (e.g., Russia), or load all towns.
get_professions: Browse the professions/industries catalog, optionally filtered by parent category or keyword.
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., "@@theyahia/superjob-mcp найди вакансии фронтенд разработчика в Москве"
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.
SuperJob 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-mcpStreamable HTTP
npx @theyahia/superjob-mcp --http --port=3000Smithery
npx -y @smithery/cli install @theyahia/superjob-mcp --client claudeRelated MCP server: trackly-cli
Переменные окружения
Переменная | Обязательная | Описание |
| Да | API secret key (получить на api.superjob.ru) |
| Нет | Application ID |
| Нет | Устаревший вариант (fallback для SECRET_KEY) |
Инструменты (5)
Инструмент | Описание |
| Поиск вакансий по словам, городу, зарплате |
| Полная информация о вакансии по ID |
| Поиск работодателей по названию и городу |
| Справочник городов (поиск, фильтр по стране) |
| Справочник профессий и отраслей |
Скиллы (Claude Code)
Команда | Описание |
| Найди вакансии по специальности, городу, зарплате |
| Анализ зарплат по специальности |
Примеры
Найди вакансии Python в Москве от 200000
Покажи работодателей в IT в Санкт-Петербурге
Какие города есть в базе SuperJob?
Зарплаты по специальности DevOpsРазработка
npm install
npm run build
npm testЛицензия
MIT
Telegram: @vhodvai
Available Tools
5 toolsget_professionsB
Справочник профессий/отраслей SuperJob (каталог).
Inputs: parent, keyword.
get_townsC
Справочник городов SuperJob. Поиск по названию, фильтр по стране.
Inputs: all, keyword, id_country.
get_vacancyB
Полная информация о вакансии SuperJob по ID.
Inputs: id (required).
search_employersB
Поиск работодателей на SuperJob по названию и городу.
Inputs: page, town, count, keyword.
search_vacanciesB
Поиск вакансий на SuperJob по ключевым словам, городу, зарплате.
Inputs: town, count, keyword, payment_to, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a uniquely defined purpose: searching vacancies, getting vacancy details, searching employers, accessing town directory, and accessing professions directory. There is no overlap in functionality.
All tool names follow a consistent verb_noun pattern in snake_case: search_vacancies, get_vacancy, search_employers, get_towns, get_professions. The verbs 'search' and 'get' are used appropriately.
5 tools is an appropriate number for a job search API server, covering core search operations for vacancies and employers, plus supporting reference data for towns and professions.
The tool set covers the essential read operations for job searching: search and get for vacancies, search for employers, and reference lookups. While no write operations are provided (e.g., post vacancy, apply), the scope is clearly aligned with a read-only search helper, so no major gaps are apparent.
Maintenance
Related MCP Connectors
Public MCP server for discovering open jobs. Search, filter, and get application links.
GetJobzi MCP server for job search, application tracking, and career forecasting.
MCP server for Google search results via SERP API
MCP server for the Vulners.com API
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceMCP server that exposes job search data from multiple boards, enabling clients to query and manage job listings via natural language.7MIT

trackly-cliofficial
AlicenseNot gradedqualityBmaintenanceMCP server for job search and application tracking, enabling AI agents to search jobs, get details, manage applications, and find contacts across 128K+ jobs and 1,900+ companies.1,315 npm3MIT
bach-jsearchofficial
AlicenseAqualityDmaintenanceMCP server for accessing Jsearch API to search jobs, get job details, and retrieve salary estimates.4MIT- AlicenseNot gradedqualityDmaintenanceMCP server for the WorkLink Partner API that enables searching live job vacancies and tenders in Syria.MIT