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 分