io.github.theYahia/superjob-mcp
MCP server for SuperJob.ru API — vacancy search, employers. Requires API key.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@theyahia/superjob-mcpclaude mcp add superjob-mcp -e 'SUPERJOB_API_KEY=<your superjob_api_key>' -- npx -y @theyahia/superjob-mcp@1.0.0
{
"mcpServers": {
"superjob-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/superjob-mcp@1.0.0"
],
"env": {
"SUPERJOB_API_KEY": "<your superjob_api_key>"
}
}
}
}
متغيرات البيئة
SUPERJOB_API_KEYإلزامي سري API key for the service
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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
الأسئلة الشائعة
ما هو io.github.theYahia/superjob-mcp؟
MCP server for SuperJob.ru API — vacancy search, employers. Requires API key.
كيف أثبّت io.github.theYahia/superjob-mcp؟
يعمل على جهازك. في Claude Code: claude mcp add superjob-mcp -e 'SUPERJOB_API_KEY=<your superjob_api_key>' -- npx -y @theyahia/superjob-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.theYahia/superjob-mcp إلى مفتاح API؟
نعم. يتطلب SUPERJOB_API_KEY، وتضبطها في إعداداته.
هل io.github.theYahia/superjob-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.theYahia/superjob-mcp؟
ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.