superjob-mcp

Name: superjob-mcp
Author: theYahia

本地服务

github.com/theYahia商业与营销19 周前更新

代码仓库

关于 superjob-mcp

superjob-mcp 将 SuperJob.ru API 的职位、雇主及目录查询提供给 AI 助手，需配置 API 密钥。它包含 5 个工具，支持按关键词、城市和薪资筛选职位。

主要功能

01按关键词、城市和薪资搜索职位
02查询职位详情
03按名称和城市搜索雇主
04查询城市目录
05查询职业和行业目录

适用场景

01按职位、城市和薪资条件筛选职位
02查找指定城市的雇主
03查询可用城市与职业分类

MCP 相关

它通过 5 个工具向 MCP 客户端开放 SuperJob.ru API 的职位、雇主、城市和职业查询。使用时需要配置 `SUPERJOB_SECRET_KEY`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "theyahia-superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_API_KEY": "<SUPERJOB_API_KEY>"
      }
    }
  }
}

启动命令npx -y @theyahia/superjob-mcp

需要配置的环境变量

SUPERJOB_API_KEY密钥API key for the service

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@theyahia/superjob-mcp1.0.0stdio

工具

收录的工具列表 · 更新于 4 周前

参数	类型	必填	说明
town	number	否	城市 ID（4=莫斯科，14=圣彼得堡）
count	integer	否	Количество
keyword	string	否	关键词
payment_to	number	否	最高薪资
payment_from	number	否	最低薪资

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。