职位搜索器 hireseeker/hireseeker-cli

HireSeeker CLI — 从 Telegram 和招聘网站搜索职位

HireSeeker 从 Telegram 频道和公司招聘网站收集职位。hireseeker-cli 帮你在终端、IDE 和 AI 智能体里找工作：选职业和地区，筛选远程、混合或坐班职位，读职位卡片，拿到链接。搜索不需要登录，也不需要 API 密钥。

HireSeeker CLI 有什么用

不同频道和网站的职位，在同一个搜索里都能找到。CLI 返回雇主、薪资和币种、工作形式、地点、描述和职位卡片链接。JSON 适合脚本和 AI 智能体；技能帮智能体挑出支持的筛选条件，并向人解释结果。

你可以用它来：

- 按职业、国家、城市和工作形式搜索职位；
- 选薪资区间，排除没有薪资或要求英语的职位；
- 从职位卡片里读职责、要求和条件；
- 翻到搜索结果的下一页，把 JSON 存下来给自己的工具用。

十个招聘来源示例

已接入的招聘来源包括：Yandex、Sber、T-Bank、Ozon、Wildberries、VK、MTS、Alfa-Bank、卡巴斯基实验室和 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 会全局安装执行该命令的同一版本，并为检测到的智能体装上说明。搜索命令不需要安装技能，也不需要跑 init。

可以用 npm view hireseeker-cli version 查看仓库里的版本。如果 npm 上还没发布，从 GitHub Actions → CLI acceptance → npm-package 下载 tarball，再用 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

下面是 2026 年 10 月 3 日真实 API 响应中一张卡片的片段。示例只展示 vacancies 数组里的部分字段；职位可能已下架或发生变更： json { "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。

装好技能后，你可以让智能体：「找一些最新的 Python 开发远程职位」。它会追问含糊的条件，执行搜索，并读取被截断的卡片。针对这张卡片的简要回答可能长这样：

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

远程工作，Санкт-Петербург。未注明薪资。

打开职位

在内容充实的筛选结果里，智能体还会列出任务、要求和条件——前提是读到的卡片里有这些内容。细节不会凭空编造；实际应用的筛选条件会显示在回答中。

筛选条件 bash 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 与分页 bash hireseeker vacancy search --category python_backend --json > page.json

stdout 输出 API 的 JSON，包含 vacancies、applied_filters、total_items、searched_at 和 next_cursor。要取下一页，复制 next_cursor： bash hireseeker vacancy search --cursor "CURSOR_ИЗ_ОТВЕТА" --json

游标有效期 10 分钟。传递游标时不要带分类和筛选条件。快照过期后需要重新搜索；命令行不会自动重启搜索。total_items 对应原始快照：职位下架后，即使还有下一页游标，页面也可能变短或为空。
错误输出到 stderr。加上 --json 后，错误也是 JSON 格式。详细信息和退出码见参考手册。

DeepSeek Harness

这个包也可以作为 DeepSeek Harness 插件安装。它直接接入公开的 MCP HireSeeker：在 Harness 聊天里就能搜索职位、查看详情，不用登录 HireSeeker。

在 Harness 中打开 Plugins → Add plugin，填入 hireseeker-cli@0.1.2，安装包，然后选择 Enable now。从终端安装： bash
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 聊天的单独方案。

DeepSeek Harness 社区插件是 DeepSeek 官网链接指向的公开仓库列表。安装 Harness 插件不会给 chat.deepseek.com 添加工具。

AI 智能体 bash 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。他人的文件或已编辑的文件会保留；命令会提示跳过，并返回非零退出码。升级 CLI 后要更新 skills，请重新运行 hireseeker skill。

通过 skills.sh 安装

只从公开 GitHub 仓库安装 skill： bash
npx skills add hireseeker/hireseeker-cli --skill hireseeker

Codex 和 Cursor 免交互选择： bash
npx skills add hireseeker/hireseeker-cli --skill hireseeker --agent codex cursor --yes

默认把 skill 装到当前项目；--global 装到用户级。这种方式使用 skills 安装器。hireseeker skill 命令安装的是 npm 包版本中的说明，并启用上文所述的用户文件保护。每个智能体只选一种安装方式。

如果 CLI 已全局安装，skill 会运行 hireseeker；否则运行 npx --yes hireseeker-cli@0.1.2。安装 skill 本身不需要全局安装 CLI。

skills.sh 目录 · skill 源码

开发与发布

开发 · 发布 · 命令与错误

许可证：MIT。