HireSeeker CLI — поиск вакансий из Telegram и карьерных сайтов

HireSeeker собирает вакансии из Telegram-каналов и карьерных сайтов компаний. hireseeker-cli помогает искать работу из терминала, IDE и AI-агента: выбрать профессию и географию, отфильтровать удалённые, гибридные или офисные вакансии, прочитать карточку и получить ссылку на неё. Для поиска вход и API-ключ не нужны.

Зачем нужен HireSeeker CLI

Вакансии из разных каналов и сайтов доступны в одном поиске. CLI возвращает работодателя, зарплату и валюту, формат работы, место, описание и ссылку на карточку. JSON подходит для скриптов и AI-агентов; skill помогает агенту выбрать поддерживаемые фильтры и объяснить результат человеку.

Используйте его, чтобы:

• искать вакансии по профессии, стране, городу и формату работы;
• выбирать диапазоны зарплаты, исключать вакансии без зарплаты или на английском;
• читать обязанности, требования и условия из карточки;
• получать следующие страницы выдачи и сохранять JSON для своих инструментов.

Десять примеров карьерных источников

Среди подключённых карьерных источников: Яндекс, Сбер, Т-Банк, Ozon, Wildberries, VK, МТС, Альфа-Банк, Лаборатория Касперского и X5. Список показывает примеры известных работодателей; актуальные роли и условия проверяйте поиском.

HireSeeker также собирает вакансии из Telegram-каналов. CLI обращается к базе HireSeeker, а сбор вакансий выполняет сервис.

Установка

Требуется Node.js ≥22.12. CLI работает на Linux, macOS и Windows.

npm install -g hireseeker-cli
hireseeker --version
hireseeker professions list

Без глобальной установки:

npx --yes hireseeker-cli@0.1.2 vacancy search --category python_backend --json
npx --yes hireseeker-cli@0.1.2 init

init устанавливает глобально ту же версию, которая выполняет команду, и инструкции для обнаруженных агентов. Поисковые команды не требуют установки skills или запуска init.

Версию в реестре можно проверить командой npm view hireseeker-cli version. Если выпуск ещё не появился в npm, скачайте tarball из GitHub Actions → CLI acceptance → npm-package и установите его через npm install -g ./hireseeker-cli-0.1.2.tgz. Для установки инструкций из tarball используйте hireseeker skill.

Быстрый старт

hireseeker professions list
hireseeker locations search "Москва" --country RU
hireseeker vacancy search --category python_backend --schedule remote --limit 5
hireseeker vacancy read 10056013

Последний ID — пример. Для чтения используйте ID из своей выдачи. Категорию выбирайте из текущего каталога: специализация python_backend, группа backend или надгруппа developers.

CLI показывает краткое описание. Если оно обрезано, прочитайте карточку через vacancy read; подробное описание тоже может иметь предел. Контакты возвращаются с гостевыми правами: при contact_access=restricted доступ предоставляется на сайте.

Что возвращает поиск

npx --yes hireseeker-cli@0.1.2 vacancy search --category python_backend --schedule remote --limit 2 --json

Ниже фрагмент одной карточки из реального ответа API от 3 октября 2026 года. Пример показывает часть полей из массива vacancies; вакансия может быть снята или изменена:

{
  "id": 9983095,
  "title": "Python (AI-native) разработчик",
  "employer": "сёрф",
  "salary": null,
  "schedule": "remote",
  "location": "Санкт-Петербург",
  "open_url": "https://hireseeker.ru/vacancy/9983095-python-ai-native-razrabotchik?utm_source=chatgpt&utm_medium=mcp&utm_campaign=hireseeker_plugin",
  "contact_access": "available"
}

salary: null означает, что зарплата не указана. Ссылка open_url ведёт к карточке HireSeeker. Текстовый режим показывает эти сведения в терминале; JSON сохраняет поля API. Полный ответ поиска также содержит applied_filters, total_items, searched_at и next_cursor.

С установленным skill можно попросить агента: «Найди свежие вакансии Python-разработчика с удалённой работой». Он уточнит неоднозначные условия, выполнит поиск и прочитает обрезанные карточки. Краткий ответ по этой карточке может выглядеть так:

Python (AI-native) разработчик — сёрф

Удалённая работа, Санкт-Петербург. Зарплата не указана.

Открыть вакансию

В содержательной подборке агент также приводит задачи, требования и условия, если они есть в прочитанной карточке. Детали не выдумываются; применённые фильтры показываются в ответе.

Фильтры

hireseeker filters guide
hireseeker vacancy search --category backend --period 14 \
  --schedule remote,hybrid --country RU,KZ \
  --salary-bucket 150_249k,250_349k --no-without-salary --no-english

По умолчанию: 7 дней, 5 вакансий, включены английские вакансии, вакансии без зарплаты и автоподнятия. Размер страницы — до 20. Период и сортировка используют появление в выбранной категории, включая автоподнятия; published_at остаётся датой источника.

Свободный текст, грейд и точный порог зарплаты API не поддерживает. Диапазоны зарплаты совпадают с витриной сайта. Неизвестные опции отклоняются, фильтры не игнорируются молча.

JSON и пагинация

hireseeker vacancy search --category python_backend --json > page.json

stdout содержит JSON API с vacancies, applied_filters, total_items, searched_at и next_cursor. Для следующей страницы скопируйте next_cursor:

hireseeker vacancy search --cursor "CURSOR_ИЗ_ОТВЕТА" --json

Курсор живёт 10 минут. Передавайте его без категории и фильтров. Истёкший снимок требует нового поиска; CLI не перезапускает его автоматически. total_items относится к исходному снимку: после снятия вакансий страница может стать короче или пустой при наличии следующего курсора.

Ошибки идут в stderr. С --json они тоже имеют JSON-формат. Подробности и коды завершения — в справочнике.

DeepSeek Harness

Пакет также устанавливается как плагин DeepSeek Harness. Он подключает публичный MCP HireSeeker напрямую: поиск вакансий и подробности доступны в чате Harness без входа в HireSeeker.

В Harness откройте Plugins → Add plugin, укажите hireseeker-cli@0.1.2, установите пакет и выберите Enable now. Для установки из терминала:

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add hireseeker-cli@0.1.2
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web

Плагин использует доступ к модели, настроенный пользователем в Harness. Инструкция и примеры запросов объясняют подключение, ограничения и отдельный сценарий для обычного чата DeepSeek.

Community plugins DeepSeek Harness — публичный список репозиториев по ссылке с официального сайта DeepSeek. Установка плагина Harness не добавляет инструменты в chat.deepseek.com.

AI-агенты

hireseeker skill
hireseeker skill --agent codex,cursor

Поддерживаются Claude Code, Codex, Cursor, OpenCode, Gemini CLI и Antigravity. Без --agent выбираются обнаруженные агенты. Явный выбор позволяет создать каталог skill для ещё не настроенного агента. Установка учитывает CODEX_HOME, CLAUDE_CONFIG_DIR, XDG_CONFIG_HOME.

Skills копируются из установленного пакета и сохраняются после удаления кеша npx. Повторная установка обновляет собственный неизменённый skill. Чужие или отредактированные файлы сохраняются; команда сообщает о пропуске и возвращает ненулевой код. Для обновления skills после обновления CLI повторите hireseeker skill.

Установка через skills.sh

Установить только skill из публичного GitHub-репозитория:

npx skills add hireseeker/hireseeker-cli --skill hireseeker

Для Codex и Cursor без интерактивного выбора:

npx skills add hireseeker/hireseeker-cli --skill hireseeker --agent codex cursor --yes

По умолчанию skill устанавливается в текущий проект; --global устанавливает его для пользователя. Этот способ использует установщик skills. Команда hireseeker skill устанавливает инструкции из версии npm-пакета и применяет описанную выше защиту пользовательских файлов. Выберите один способ установки для каждого агента.

Skill запускает hireseeker, если CLI установлен глобально, или npx --yes hireseeker-cli@0.1.2. Установка самого skill не требует глобальной установки CLI.

Каталог skills.sh · Исходный skill

Разработка и выпуск

Разработка · Выпуск · Команды и ошибки

Лицензия: MIT.