liepin-cli — 猎聘招聘者端自动化 CLI | 人才搜索 · 简历查看 · AI Agent 友好

liepin-cli（@viyzhu/liepin-cli）是开源的 猎聘招聘者端（lpt.liepin.com）自动化命令行工具。基于 Puppeteer / CDP 协议驱动本机 Chrome，把招聘者端的核心操作搬进终端：人才搜索、简历查看、推荐 / 人才库管理、主动打招呼、聊天记录查看、职位管理。

每条命令都设计为无状态、单步可重入，输出结构化文本；批量筛选、多步流程由调用方（脚本或 Claude / GPT / Gemini 等 AI Agent）循环编排，搭建半自动化招聘流水线。

npm install -g @viyzhu/liepin-cli
liepin help

为什么选择 liepin-cli？

场景	命令
猎聘人才搜索	`liepin search 前端工程师`
猎聘简历预览	`liepin resume <简历ID>`
猎聘候选人筛选	`liepin recommend` / `liepin talent`
主动打招呼	`liepin greet <resume_id> --ejobId <jobId> --message "您好，方便发作品集看看吗？"`
索要手机号 / 简历	`liepin request-phone <resume_id>` / `liepin request-resume <resume_id>`
聊天记录查看	`liepin chatlist` / `liepin chatmsg <对方imId>`
AI Agent 集成	子进程调用，每条命令输出结构化文本，可直接被 Agent 解析
数据本地化	无中间层服务，cookie 与截图仅存在 `~/.liepin-cli/`

不适用场景

仅做公开页面信息抓取（无需登录态）→ 用 web fetch / 通用爬虫更合适
Boss 直聘 同类需求 → 走 boss-cli
投递后的面试日程 / ATS 流转 → 那是 ATS / 招聘系统 skill 的事

安装

要求：Node.js ≥ 20，本机已安装 Chrome / Chromium。

npm install -g @viyzhu/liepin-cli
liepin help

macOS / Linux 全局安装权限问题：系统 Node 默认全局前缀在 /usr/local，当前账户无写权限。建议先把全局前缀挪到用户目录（一次性配置）：
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
# macOS 默认 shell 是 zsh
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
# macOS bash / Linux
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.zshrc  # 或 source ~/.bashrc
使用 fnm / nvm / volta 的用户可跳过此步。Windows 用户无需此步。

Windows / Linux 找不到 Chrome：自动探测覆盖 Chrome / Edge 的常见安装路径，若未命中请手动设置 CHROME_PATH（见下方「环境变量」）。

命令一览

命令	说明
`liepin search <关键词>`	搜索人才
`liepin chatlist`	查看聊天列表
`liepin chatmsg <对方imId>`	查看与某候选人的聊天记录
`liepin recommend`	查看推荐候选人
`liepin talent`	查看人才库
`liepin resume <简历ID>`	查看简历详情（传 search / recommend / talent 返回的 resume_id）
`liepin greet <resume_id 或 user_id> [--ejobId <职位ID>] [--message <消息>]`	主动打招呼：发起沟通，传 `resume_id` 时可补发自定义消息
`liepin request-phone <resume_id>`	向候选人索要手机号（需先 `greet` 建会话）
`liepin request-resume <resume_id>`	向候选人索要简历（需先 `greet` 建会话）
`liepin joblist`	查看职位列表
`liepin quit`	关掉常驻的浏览器（登录态保留）

完整用法与参数：liepin help

search --city 按候选人现居住地过滤（对应猎聘搜索的"现居住地"条件）；候选人的期望城市在 JSON 输出的 want_city 字段。

退出码：0 成功；1 一般错误；2 登录态失效（先跑 liepin login）；3 触发风控/安全异常（立即停止自动化，人工在浏览器完成验证）。脚本和 Agent 按退出码分支即可，无需解析报错文案。

快速上手

# 1. 登录招聘者端（弹出浏览器扫码，cookie 本地持久化）
liepin login

# 2. 搜索人才
liepin search 前端工程师 --city 北京 --experience 3-5年

# 3. 查看某候选人简历（resume_id 来自 search / recommend / talent 结果）
liepin resume <简历ID>

# 4. 查看推荐候选人
liepin recommend

# 5. 查看聊天列表 / 某会话记录（im_id 来自 chatlist）
liepin chatlist
liepin chatmsg <对方imId>

# 6. 主动打招呼（resume_id / user_id 来自 search / recommend / talent；ejobId 来自 joblist）
liepin greet <resume_id> --ejobId <jobId> --message "您好，方便发一份作品集看看吗？"

# 7. 会话建立后索要联系方式与简历（候选人同意后，手机号会出现在 chatmsg 输出里）
liepin request-phone <resume_id>
liepin request-resume <resume_id>

login 默认复用现有登录态：还有效就直接返回、不重启浏览器，也不用重新扫码。确实要重来一遍用 liepin login --force。同一天反复重登会被猎聘判「行为异常」，所以 24 小时内超过 3 次交互式登录会被拦下（同样可用 --force 放行）。

与 AI Agent 集成

liepin-cli 的每条命令都输出结构化纯文本，AI Agent 可直接解析并编排多步流程。

# Agent 调用示例
result=$(liepin search 前端工程师 --city 北京 --limit 5 --json)
echo "$result" | jq '.[0].title'

聊天消息来源

liepin chatmsg <对方imId> --json 保留 sender/content/time/type，新增 source、 ext_type、biz_type、biz_key；表格输出也显示 source。type: "txt" 只表示正文格式，交换请求和普通聊天都可能是文本，不能按正文判断是否点击过快捷按钮。

`source`	协议依据	含义
`chat`	`extType=1`，`bizType="1"` 或空字符串	普通聊天消息；可能由人工、CLI 或其他客户端发送，不证明人工键入
`exchange_request`	`extType=206`（`ASK_EXCHANGE`）	索要/交换请求，包括微信、手机和简历；不能单靠此值判断交换的对象
`exchange_result`	`extType=207`（`RESULT`）	交换结果消息
`system`	`extType=200`（`SYSTEM`）	平台系统消息
`unknown`	缺失、无法解析或尚未识别的协议码	无法确认；不会根据文案补成已知来源

ext_type 来自 payload.ext.extType，biz_type 来自 payload.ext.extBody.bizType， biz_key 来自 payload.ext.extBody.bizData.bizKey。三个码统一输出为字符串，缺失或类型异常时为 null。未识别的码仍保留，便于日志分析；不透传整个 bizData。消息 biz_type 与快捷按钮接口的 bizType 不是同一套枚举，不要混用。

例如，微信交换请求可输出以下字段；同文普通聊天则是 source: "chat"、ext_type: "1"、 biz_type: "1"，无扩展信息则是 source: "unknown"：

{
  "type": "txt",
  "content": "为了方便联系，可以交换微信号吗？",
  "source": "exchange_request",
  "ext_type": "206",
  "biz_type": "6",
  "biz_key": "10001"
}

协议依据（2026-10-20 核对）：猎聘公开 IM 脚本 fe-imb-pc 4.12.8 vendors 中的 extType 枚举、payload 解码和默认发送参数，以及 common 的消息渲染映射。上例结构也见于既有联系人 lastPayload 抓包；测试中的同文普通聊天按默认发送协议合成，未为验证而向真实候选人发消息。此字段识别消息的协议类别，不记录实际点击者或客户端。

Claude Code 集成（Agent Skills）

# 把 liepin-cli 注册为 Agent Skill
liepin skill install

卸载目前不支持子命令，手动删除目录即可：rm -rf ~/.agents/skills/liepin-cli。

安装后默认复制到 ~/.agents/skills/liepin-cli/（Windows：%USERPROFILE%\.agents\skills\liepin-cli）。重启 Claude Code 后，在对话中说"用 liepin 搜前端"即可触发。

其他兼容 Agent（Codex、Pi、OpenCode、MiniMax Code、WorkBuddy、Cherry Studio）请参考各自文档的 skills 目录位置，复制同一份 SKILL.md 即可，无需改写。

环境变量

变量名	说明	默认值
`CHROME_PATH`	Chrome/Edge 可执行文件路径；Windows / macOS / Linux 常见安装路径会自动检测	-
`LIEPIN_USER_DATA_DIR`	用户数据目录	`~/.liepin-cli/user-data`
`LIEPIN_SCREENSHOT_DIR`	截图目录	`~/.liepin-cli/screenshots`
`RECRUIT_BROWSER_HIDDEN`	招聘工具链共读的统一覆盖开关（boss-cli / liepin-cli / DSH 面板都认）；设 `true` 让窗口隐藏。不设时各 CLI 用自己的默认	不设（默认有头）
`LIEPIN_HEADLESS`	本 CLI 专属覆盖项，优先级高于 `RECRUIT_BROWSER_HIDDEN`	跟随上一行
`LIEPIN_BROWSER_REMOTE_DEBUGGING_PORT`	固定 CDP 调试端口（浏览器跨命令常驻靠它）	`53471`
`LIEPIN_SPAWN_BREAKAWAY`	仅 Windows：经 WMI 拉起浏览器，使其脱离调用方的 Job Object（AI Agent 后台任务里必需，见下方常见问题）。设 `false` 回退到普通 spawn	`true`
`LIEPIN_PROXY`	代理服务器	-
`LIEPIN_DEBUG`	调试模式	`false`

浏览器默认可见，怎么把它藏起来？

默认有头（与 boss-cli 一致）。代价是有头窗口一启动就抢走键盘焦点，会打断你手上的事；想藏起来：

RECRUIT_BROWSER_HIDDEN=true liepin recommend   # 共读开关，boss / liepin / 面板都认
LIEPIN_HEADLESS=true liepin recommend          # 只影响 liepin-cli，优先级更高

⚠️ 但先读下一节再决定要不要藏——无头的 UA 会自报 HeadlessChrome。

注意：换了变量不会让已经在跑的那只浏览器换模式。端口上已有实例会被直接复用，得先 liepin quit，下条命令才会按新模式重启。

想看浏览器在做什么但不要窗口抢焦点，用 recruiting-copilot 的 DSH「招聘浏览器」面板（默认折叠、默认只读，操作请走 CLI）。

为什么默认有头（2026-09-21 翻的默认，此前是无头）

无头的 User-Agent 里带 HeadlessChrome/<ver>，等于每个请求都自报「我是自动化工具」。本 CLI 刻意不覆盖 UA（伪造的 UA 与 sec-ch-ua Client Hints、真实平台互相矛盾，本身就是更明显的指纹），所以这条没法靠改 UA 绕过。BOSS 侧正是踩了它：账号被限制 web 端登录 24 小时，页面文案写「系统检测到您的账号存在使用第三方招聘管理系统、插件、外挂、软件等辅助工具」；另一个团队用默认有头长期无事，AI 擅自改走无头之后当天封号。
2026-09-20 猎聘侧实测：连续无头调用后账号被判「行为异常」，302 到 safe.liepin.com/.../captchaPage_PC，业务接口开始静默拦截（第二种风控形态）。

⚠️ 这不等于已证明「无头是唯一成因」——调用频次、issue #21 的重登循环都可能有份。但 UA 自报是确定存在的送分题，先摘掉。

0819 定无头时的另一条结论仍然成立：猎聘安全脚本在页面加载瞬间检测该页签的 CDP 会话是否启用着 Runtime 域，启用则把页面清成 about:blank——这条与有头/无头无关，照旧由 safeGoto 在导航期间临时关闭 Runtime 规避。

RECRUIT_BROWSER_HIDDEN 的语义仍是统一覆盖开关而不是「提供默认值」：不设时两个 CLI 各用自己的默认（现在两家都是有头），显式设了才把两家拉平。

浏览器跨命令常驻

命令结束只断开 CDP，不关浏览器：下条命令直连同一只实例（同一登录态、同一标签），省掉反复启动的开销，DSH 面板的镜像也才有东西可连。

跑完招聘想释放内存就 liepin quit。判断在跑的那只是什么模式：

curl http://127.0.0.1:53471/json/version   # User-Agent 含 HeadlessChrome 即无头

常见问题

Chrome 未找到（自动探测失败时手动指定）

# macOS
export CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
# Linux
export CHROME_PATH="/usr/bin/google-chrome"
# Windows (PowerShell)
$env:CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"

登录失败 / 登录态失效

重新跑 liepin login，在弹出的浏览器里扫码登录招聘者端
确认 LIEPIN_USER_DATA_DIR 目录正确（cookie 持久化在此）
命令报"返回了 HTML / 反爬挑战"多为登录态过期，重新 liepin login 即可

提示「检测到您当前网络地址在境外」

猎聘封境外 IP。先关 VPN / 代理（含 Outline、Clash TUN 模式这类整机隧道），或将 *.liepin.com 分流为直连，再重跑命令。用 VPN 期间即使能扫码登录，BFF 接口也会拦截。

页面被清空为 about:blank

0.2.4 起已根治：猎聘安全脚本会在页面加载瞬间检测 CDP 会话的 Runtime 域并清页，现在所有导航在加载期间临时关闭 Runtime（safeGoto）。旧版本遇到请升级。

Windows：浏览器窗口自己关掉 + 每次启动弹「Chrome 未正确关闭」

0.2.6 起已修复（issue #21）。根因不在 CLI 的关闭逻辑，而在进程归属：从 AI Agent 的后台任务里调用 CLI 时，宿主通常把整棵进程树放进一个 KILL_ON_JOB_CLOSE 的 Job Object，而 spawn({ detached: true }) 只是新建进程组、逃不出 Job——CLI 一结束，Chrome 就被连带终止，于是窗口"自己关了"、profile 留下 exit_type: Crashed、下次启动弹恢复气泡。

现在 Windows 上改经 WMI Win32_Process.Create 拉起浏览器（进程归 WmiPrvSE，不在调用方的 Job 里），并加 --hide-crash-restore-bubble 兜底。要回退到旧行为设 LIEPIN_SPAWN_BREAKAWAY=false。

顺带说明为什么它会连累登录：_e_ld_auth_ / XSRF-TOKEN 都是会话 cookie（is_persistent=0），浏览器进程一没就等于退出登录，于是又得重新扫码——而重新扫码以前每次都会再关一次浏览器。这个自我强化的循环正是账号被判「行为异常」的主因，0.2.6 一并断掉了（见下一条）。

账号被猎聘判「行为异常」，弹安全验证

页面会被 302 到 safe.liepin.com/.../captchaPage_PC。此时所有业务接口都被静默拦截， resume 这类命令只会收到一个没有任何说明的 {"flag":0}——那不是简历权益不足，是风控。

0.2.6 起 CLI 直接识别这两种形态并以退出码 3 立即失败，附「请勿重试」提示，不再让脚本误判成权限问题、也不再对着验证页干等到超时；
处理办法只有人工过验证：liepin login（会切出有头窗口），在窗口里点「点击验证」完成滑块；
不要反复重登。login 默认复用现有会话，24 小时内超过 3 次交互式登录会被拦下。

被检测为自动化

如频繁被风控拦截，请开 issue 带上 liepin --debug 输出，maintainer 协助排查。

开发

git clone https://github.com/Viy1204/liepin-cli.git
cd liepin-cli
npm install
npm run build && npm test

发版：在 main 上 npm version patch（自动 bump + 打 tag）后 git push --tags，GitHub Actions 经 npm Trusted Publishing (OIDC) 自动发布，无需 npm token（见 .github/workflows/publish.yml）。

许可证

GPL-3.0，详见 LICENSE。

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
scripts		scripts
skills/liepin-cli		skills/liepin-cli
src		src
.gitignore		.gitignore
AGENTS.md		AGENTS.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Navigation Menu

Repository navigation

About

Repository files navigation

liepin-cli — 猎聘招聘者端自动化 CLI | 人才搜索 · 简历查看 · AI Agent 友好

为什么选择 liepin-cli？

不适用场景

安装

命令一览

快速上手

与 AI Agent 集成

聊天消息来源

Claude Code 集成（Agent Skills）

环境变量

浏览器默认可见，怎么把它藏起来？

为什么默认有头（2026-09-21 翻的默认，此前是无头）

浏览器跨命令常驻

常见问题

Chrome 未找到（自动探测失败时手动指定）

登录失败 / 登录态失效

提示「检测到您当前网络地址在境外」

页面被清空为 about:blank

Windows：浏览器窗口自己关掉 + 每次启动弹「Chrome 未正确关闭」

账号被猎聘判「行为异常」，弹安全验证

被检测为自动化

开发

许可证

相关项目

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

liepin-cli — 猎聘招聘者端自动化 CLI | 人才搜索 · 简历查看 · AI Agent 友好

为什么选择 liepin-cli？

不适用场景

安装

命令一览

快速上手

与 AI Agent 集成

聊天消息来源

Claude Code 集成（Agent Skills）

环境变量

浏览器默认可见，怎么把它藏起来？

为什么默认有头（2026-09-21 翻的默认，此前是无头）

浏览器跨命令常驻

常见问题

Chrome 未找到（自动探测失败时手动指定）

登录失败 / 登录态失效

提示「检测到您当前网络地址在境外」

页面被清空为 about:blank

Windows：浏览器窗口自己关掉 + 每次启动弹「Chrome 未正确关闭」

账号被猎聘判「行为异常」，弹安全验证

被检测为自动化

开发

许可证

相关项目

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages