Skip to main content
Glama
boss-job
by gro83j

dsh-boss-job

CI npm license

用 AI 帮你在 Boss 直聘上快速筛岗位——给已经知道要投什么的人:多轮访谈定偏好 → 复用你本机已登录的 Chrome 采集 → 硬筛 + AI 评分 → 输出可投递清单。

它不是爬虫框架,也不伪造浏览器指纹——它只负责拉起一个独立的 Chrome profile,让你自己扫码登录,然后把「搜索 / 看 JD / 导出报告」这些脏活交给 CLI 或 MCP,判断交给你正在用的 AI。

  • 零运行时依赖(只要 Node ≥ 20 和本机 Chrome)

  • 三个入口同一套核心:Skill(给 agent 的工作流)、CLI(人也能用)、MCP(给 Claude Code / DSH 等宿主)

  • 只读、限速、单轮详情 ≤ 60,绝不自动打招呼或投递

适合谁,不适合谁

适合:已经有目标岗位方向(比如「杭州/上海的美妆、食品电商运营」),想把这个方向上的岗位快速翻一遍、筛出可投清单,把时间花在投递和面试上的人。

不适合:还没想清楚要做什么的人。这个项目的核心是「筛」,不是「规划」。AI 对具体行业、岗位和就业市场的判断会有偏差,靠低成本的信息收集消不掉这个偏差;方向错了,筛得再快也是白费。

如果你还没定方向,建议先做一次付费职业咨询,或找目标行业的在职前辈聊 1–2 小时,把方向定下来再回来用这个工具。项目里有一个克制的入口分流:没方向时会建议你先去咨询,最多帮你把已有信息整理成一张表(事实整理,不是职业建议),不会替你规划职业,也不会给「你最适合××」的结论。

Related MCP server: boss-zhipin-mcp

为什么这样做

Boss 直聘的风控覆盖 TLS 指纹、__zp_stoken__、字体混淆和多层验证码。2025–2026 年能长期稳定工作的方案只有一种:用真实浏览器、真实登录态,而不是在 Node 里模拟浏览器。本项目因此把浏览器层做薄:

  1. 启动专用 Chrome(~/.dsh-boss-job/chrome-profile),不碰你日常用的 profile;

  2. 通过 CDP 复用页面里的真实 cookie,搜索走站点自己的 joblist 接口,薪资是明文;

  3. 详情页补 JD、公司信息与招聘者活跃状态,全程只读。

安装

需要 Node ≥ 20 与本机 Google Chrome。

# 方式一:直接用(不需要全局安装)
npx dsh-boss-job doctor

# 方式二:装成 DSH 插件(Skill + MCP 自动挂载)
dsh plugin --profile desktop add dsh-boss-job

# 方式三:给 Claude Code / Codex 装 Skill 并打印 MCP 配置
npx dsh-boss-job setup --host claude

三步开始

  • 定位是筛岗工具,不是职业规划:先问「是不是学生」「有没有心仪岗位」;没方向时建议你先咨询,项目只做信息整理,不替你规划。

  • 城市与岗位方向都可多选:支持跨地区、多城市、多方向并行搜索,城市名自动解析。

  • 所有筛选条件都来自偏好访谈,代码里没有默认城市、薪资或行业;访谈没问到的,就不筛。

npx dsh-boss-job doctor      # 自检:Chrome、端口、数据目录、登录态
npx dsh-boss-job login       # 弹出专用 Chrome,用手机验证码/微信登录
npx dsh-boss-job search --query 美妆运营 --pages 2

然后在支持 Skill 的 agent 里说一句:

帮我找工作,我想做美妆或食品方向的电商运营,杭州,7K 以上,不要纯投流和服装。

agent 会按 skills/boss-job/references/flows/ 里的五阶段流程执行:环境 → 访谈 → 计划确认 → 采集 → 报告。

CLI

命令

作用

doctor

自检 Chrome、端口、数据目录、登录态

login

打开专用 Chrome,等待用户登录(检测 wt2 cookie)

search --query <词> [--pages 2] [--city 101210100]

搜索并落盘职位列表

detail --input <jobs.json> [--limit 15]

抓 JD 详情(限速、失败重试、异常中止)

filter --input <details.json>

本地硬筛:组长/主管、助理、主播客服销售、无关类目、年限过高

export --input <details.json> --evaluation <eval.json>

渲染 Markdown 报告(含 AI 评分)

setup [--host dsh|claude|codex|cursor|auto]

链接 Skill 到宿主,并打印 MCP 配置

mcp

以 MCP stdio server 运行

MCP 工具

boss_doctor、boss_login、boss_search、boss_detail、boss_prefs_get、boss_prefs_set、boss_export。

Claude Code / 其他宿主配置:

{
  "mcpServers": {
    "boss-job": { "command": "npx", "args": ["-y", "dsh-boss-job", "mcp"] }
  }
}

数据与隐私

  • 所有数据只写在 ~/.dsh-boss-job/(可用 BOSS_JOB_HOME 覆盖):profile、jobs、reports、preferences。

  • 不上传任何数据;没有账号体系、没有 API key、没有遥测。

  • 专用 profile 与你的日常 Chrome 完全隔离,退出后不影响原浏览器。

边界与合规

  • 只读浏览,不自动投递、不自动打招呼、不发消息。

  • 详情限速 2.5–4.5 秒、单轮 ≤ 60,遇到安全验证立即停止并提示。

  • 请遵守 Boss 直聘的用户协议;本项目用于个人求职辅助,不建议高频、批量或商业采集。

常见问题

Chrome 打不开 / 端口被占用? Windows 保留端口段 9201–9300 会自动跳过;仍失败时设置 BOSS_JOB_PORT。

提示未登录? 确认登录的是本项目弹出的专用窗口,而不是日常 Chrome;再跑一次 login。

为什么不直接用 Playwright? 真实登录态 + 真实浏览器指纹最稳;Playwright 反而更容易被识别为自动化环境。

路线图

  • 自动打招呼 / 投递简历(开发中):作者正在逐步完善,敬请期待。原则不变——逐条让你确认、限速、随时可停,不做无人值守的群发;只在平台规则允许的范围内实现。当前版本仍是严格只读,不自动打招呼、不自动投递。

  • 筛岗质量:更多筛选维度、JD 结构化抽取、从 JD 反推面试问题。

  • 想要什么功能,欢迎直接提:805947599@qq.com 或 GitHub Issue。

关于作者与声明

  • 本项目由 大肥鱼 一个人 + AI 协作完成(solo project),没有团队、没有商业支持。

  • 这是作者第一次把产品打包发布到 GitHub / npm,经验不足,代码质量、文档和边界处理难免有疏漏,质量问题可能存在,欢迎提 Issue 指正,也请使用者多点包容。

  • 建议先小范围试用、自己检查输出,再用于重要决策。

反馈与联系

使用中遇到问题、有改动建议、想加功能,都欢迎联系作者:805947599@qq.com(也可以在 GitHub 提 Issue)。

开发

npm test          # node:test,零依赖
node src/cli.mjs --help

目录:src/core/*(Chrome/CDP/搜索/详情/筛选/报告)、src/mcp.mjs、skills/boss-job/(Skill 与五阶段流程)、cordis.patch.yml(DSH bundle)。

License

MIT

致谢

职业方向探索(phase0.5)的方法论参考了 MIT 许可的 career-coach;本项目未复制其文本,只借鉴了「证据优先、先诊断再给方向」的流程。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to drive a logged-in BOSS Zhipin recruiter account through the Model Context Protocol, running multi-keyword candidate searches, capturing Canvas-rendered resume screenshots, extracting permanent share links, auto-filtering and scoring candidates, sending greetings, and exporting Markdown reports. Results persist in a local database so interrupted pipelines can resume without losing data.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to automate BOSS Zhipin recruiter workflows through a logged-in Chrome browser. It supports batch candidate search with multi-keyword deduplication, resume screenshot capture, filtering/scoring, persistent candidate database, greetings, and Markdown report export.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to drive a logged-in BOSS Zhipin recruiter account through Chrome, batch-searching candidates across multiple keywords, capturing Canvas-rendered resumes as screenshots, extracting permanent share links, greeting candidates, and filtering/scoring them from a local database. It also exports Markdown candidate reports and supports resumable pipelines via YAML-configured criteria.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to automate BOSS Zhipin recruiter workflows by batch-searching candidates, viewing resumes through browser screenshots, extracting permanent share links, filtering and scoring applicants, exporting Markdown reports, and sending greetings via a logged-in Chrome session.
      -