superjob-mcp について
superjob-mcpは、SuperJob.ruの求人、雇用主、各種ディレクトリを検索するMCPサーバーです。5つのツールでキーワード、都市、給与を指定でき、APIキーが必要です。
主な機能
- 01キーワード・都市・給与で求人検索
- 02求人の詳細情報取得
- 03名称・都市で雇用主を検索
- 04都市ディレクトリの検索
- 05職種・業種ディレクトリの検索
活用シーン
- 01職種・都市・給与で求人を絞り込む
- 02指定都市の雇用主を探す
- 03利用可能な都市や職種分類を確認する
MCP 対応
5つのツールを通じて、SuperJob.ruの求人、雇用主、都市、職種の検索機能をMCPクライアントに公開します。`SUPERJOB_SECRET_KEY`の設定が必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
2掲載時のツール一覧 · 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
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。