Superjob Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search SuperJob.ru job vacancies and employers, and look up city and profession directories.

What you can do
Wraps the SuperJob.ru API in five tools: search_vacancies for keyword, city and salary filters, get_vacancy for full details by ID, search_employers by name and city, plus get_towns and get_professions reference lookups. It also ships Claude Code skills for finding jobs and analyzing salaries by specialty. Results come from SuperJob.ru listings.
When to use it
Use it when you want an assistant to gather Russian job postings, compare employers, or look at salary ranges for a profession without browsing the site by hand. It is aimed at job search and labor-market lookups rather than general web search.
Requirements
Runs locally over stdio, typically via npx with the npm package @theyahia/superjob-mcp, so Node.js is needed. An API key from api.superjob.ru is required; the manifest names SUPERJOB_API_KEY, while the README shows SUPERJOB_SECRET_KEY as required and SUPERJOB_APP_ID as optional. Network access to SuperJob.ru is needed. Desktop client only.
Before you install
The API key is a secret passed by environment variable; keep it out of shared configs and logs. The README and manifest disagree on the variable name (SUPERJOB_SECRET_KEY versus SUPERJOB_API_KEY), so confirm which one your build reads. Queries and results go to SuperJob.ru, a third party. The tools are read-only lookups; no payments or writes are described.

Installation

In SourceWeft

  1. Open Superjob Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

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

[npm] [License: MIT]

Часть серии Russian API MCP (50 серверов) by @theYahia.

Установка

Claude Desktop (stdio)

json
{  "mcpServers": {    "superjob": {      "command": "npx",      "args": ["-y", "@theyahia/superjob-mcp"],      "env": {        "SUPERJOB_SECRET_KEY": "ваш-ключ",        "SUPERJOB_APP_ID": "ваш-app-id"      }    }  }}

Claude Code

bash
claude mcp add superjob -e SUPERJOB_SECRET_KEY=ваш-ключ -e SUPERJOB_APP_ID=ваш-app-id -- npx -y @theyahia/superjob-mcp

Streamable HTTP

bash
npx @theyahia/superjob-mcp --http --port=3000

Smithery

bash
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

Разработка

bash
npm installnpm run buildnpm test

Лицензия

MIT

Telegram: @vhodvai

Source: README.md at commit 7eac43c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts