Skip to main content
Glama
@theyahia/superjob-mcp

@theyahia/superjob-mcp

by theYahia

SuperJob MCP — поиск вакансий и работодателей через нейросеть

Если вы искали, как попросить ИИ подобрать вакансии на SuperJob под свои критерии, собрать выборку работодателей или следить за зарплатами в профессии без ручного листания сайта — это оно. 5 инструментов поверх SuperJob.ru API: поиск вакансий, работодатели, справочники городов и профессий.

npm License: MIT

Часть серии 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

Related MCP server: trackly-cli

Переменные окружения

Переменная

Обязательная

Описание

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

Available Tools

5 tools
get_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

    A3.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that exposes job search data from multiple boards, enabling clients to query and manage job listings via natural language.
      7
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP 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 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the WorkLink Partner API that enables searching live job vacancies and tenders in Syria.
      MIT