Superjob Mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.0.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面网页搜索与抓取商业与电商

概览

AI 生成的概览

让助手搜索 SuperJob.ru 的职位与雇主，并查询城市和职业目录。

可以做什么
把 SuperJob.ru API 封装为五个工具：search_vacancies 按关键词、城市和薪资搜索职位，get_vacancy 按 ID 获取职位详情，search_employers 按名称和城市搜索雇主，另有 get_towns 和 get_professions 两个目录查询。还附带用于按专业找工作和分析薪资的 Claude Code 技能。数据来自 SuperJob.ru 的招聘信息。
适用场景
适合让助手收集俄罗斯招聘信息、比较雇主，或查看某职业的薪资范围，而不必手动浏览网站。它面向求职和劳动力市场查询，而非通用网页搜索。
运行要求
以 stdio 方式在本地运行，通常通过 npx 使用 npm 包 @theyahia/superjob-mcp，因此需要 Node.js。需要来自 api.superjob.ru 的 API 密钥；清单中给出的名称是 SUPERJOB_API_KEY，而 README 显示 SUPERJOB_SECRET_KEY 为必需、SUPERJOB_APP_ID 为可选。需要访问 SuperJob.ru 的网络连接。仅支持桌面客户端。
安装前请注意
API 密钥是机密，通过环境变量传入，不要写入共享配置或日志。README 与清单对变量名不一致（SUPERJOB_SECRET_KEY 与 SUPERJOB_API_KEY），请确认所用版本实际读取哪一个。查询和结果会发送给第三方 SuperJob.ru。这些工具为只读查询，未描述付款或写入操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Superjob Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：README.md，提交 7eac43c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分