English Français العربية

io.github.theYahia/superjob-mcp

Official registry Search and web

MCP server for SuperJob.ru API — vacancy search, employers. Requires API key.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @theyahia/superjob-mcp
Claude Code 
claude mcp add superjob-mcp -e 'SUPERJOB_API_KEY=<your superjob_api_key>' -- npx -y @theyahia/superjob-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "superjob-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/superjob-mcp@1.0.0"
            ],
            "env": {
                "SUPERJOB_API_KEY": "<your superjob_api_key>"
            }
        }
    }
}

Environment variables

  • SUPERJOB_API_KEY required secret API key for the service

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. SuperJob MCP — поиск вакансий и работодателей через нейросеть
  2. Установка
  3. Переменные окружения
  4. Инструменты (5)
  5. Скиллы (Claude Code)
  6. Примеры
  7. Разработка
  8. Лицензия

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-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

Frequently asked questions

What is io.github.theYahia/superjob-mcp?

MCP server for SuperJob.ru API — vacancy search, employers. Requires API key.

How do I install io.github.theYahia/superjob-mcp?

It runs on your machine. In Claude Code: claude mcp add superjob-mcp -e 'SUPERJOB_API_KEY=<your superjob_api_key>' -- npx -y @theyahia/superjob-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.theYahia/superjob-mcp need an API key?

Yes. It expects SUPERJOB_API_KEY, which you set in its configuration.

Is io.github.theYahia/superjob-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.theYahia/superjob-mcp?

It is published by theYahia. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.