zhilian-client
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
zhilian-client
智联招聘 Web 的本地只读客户端
一次性登录 · 独立浏览器会话 · SQLite 缓存 · CLI / REST / MCP / SKILL 四通道
快速开始 · 能力矩阵 · 三种接入方式 · 文档 · 实测数据

本项目与智联招聘官方无关。仅使用本人账号或已授权账号做低频、只读查询(不投递、不沟通、不改简历、不收藏),请遵守平台服务条款与当地法律。
当前状态:v0.1.1 · 已实现并本机常驻运行。REST 监听 127.0.0.1:8791,/v1/health 毫秒级、登录态 logged_in;35 个单测通过,OpenAPI/MCP/CLI 生成物与实现同源。
🎯 这是什么
把智联招聘 Web(登录域 passport.zhaopin.com + 数据域 www.zhaopin.com)封装成本机常驻的只读客户端:
用真实浏览器会话(cloakbrowser + 独立 profile)保住登录态;
把页面 SSR / fe-api 的数据结构化成职位、公司、工商信息、城市;
通过 CLI / REST / MCP / SKILL 四种形态交给 Agent 与业务系统,全程只读。
它适合这样的场景:招聘信号 → 公司线索 → 工商信息核验,例如把「某城市 + 某关键词」的在招职位批量转成公司名单,再逐家补齐工商信息。
Related MCP server: dayuan-lite
✨ 核心特性
特性 | 说明 | |
🕹️ | 真浏览器会话 | cloakbrowser 指纹环境 + 独立 profile;扫码/短信登录一次, |
🧠 | 结构化输出 | 17 个操作统一 envelope( |
🗄️ | 本地 SQLite 缓存 | 结构化缓存(不落 HTML、cookie、验证码),搜索/详情/公司默认 2h~7d TTL,可 |
🛡️ | 只读安全 | 无投递/沟通/简历写操作;REST 仅监听 |
🤖 | Agent 友好 | 17 个 MCP tools、SKILL 工作流、CLI 都可直接用;MCP 默认代理常驻 REST,不抢 profile |
🔁 | 反爬中继 | EdgeOne 30 天 token;验证码/人机验证支持「截图+坐标中继」与「自动点击」两种模式 |
🧭 架构

flowchart LR
subgraph UP["智联招聘(上游)"]
P["passport.zhaopin.com<br/>扫码 / 短信登录"]
W["www.zhaopin.com<br/>SSR + fe-api"]
end
subgraph LOCAL["zhilian-client(本机常驻)"]
B["cloak browser session<br/>独立 profile"]
C[("SQLite 缓存<br/>queries / jobs / companies")]
S["Service 层<br/>17 个操作"]
A["CLI · REST :8791<br/>MCP stdio · SKILL"]
end
U["Agent / 业务系统 / 人"]
P <-->|"登录 / 会话续期"| B
W <-->|"页面内 fetch SSR + fe-api"| B
B <--> C
B --> S
S --> A
A --> U只读:不投递、不沟通、不改简历、不收藏、不写 CRM;
采集最小化:页面内
fetchSSR 文档并解析__INITIAL_STATE__;职位详情优先position-detailv3API;不落敏感数据:缓存只存结构化字段;二维码/验证码/cookie/token 不写长期日志;
单实例:浏览器 profile 由文件锁保护,同一时间只有一个进程使用。
🖥️ 界面预览
REST 文档页(真实运行截图,http://127.0.0.1:8791/docs):

REST:
/docs自包含 HTML、/openapi.json(OpenAPI 3.1)、/mcp-tools.jsonCLI:
zhilian --help全命令自文档化MCP:17 个
zhilian_*tools,可直接接入 Claude Desktop / Cursor / 其他 MCP 客户端
🚀 快速开始
# 0) 前置:Node ≥ 22.5,且本机 cloak-env 可用
~/cloak-env/bin/cloak-env-info
# 1) 安装
git clone https://github.com/CindyRIng/zhilian-client.git
cd zhilian-client
npm install
cp .env.example .env # 至少把 ZHILIAN_API_TOKEN 改成随机值
npm run build
npm test # 35 个单测,不启动浏览器
# 2) 登录(首次 / 掉线后各一次)
bin/zhilian-run login # 智联 APP 扫码(默认)
bin/zhilian-run login --sms # 或短信验证码
# 3) 查询
bin/zhilian-run status
bin/zhilian-run search jobs --keyword 外贸 --city 565 --pages 2
bin/zhilian-run jobs detail --number CCL1316344860J40974823208
bin/zhilian-run companies list --query-id q_...
bin/zhilian-run companies detail --number CZL1316344860
bin/zhilian-run companies jobs --number CZL1316344860
bin/zhilian-run cities list
# 4) 常驻 REST 服务
node dist/main.js serve --port 8791
# 打开 http://127.0.0.1:8791/docs建议把
bin/zhilian-run软链到~/.local/bin/zhilian,之后直接用zhilian ...:ln -sf "$PWD/bin/zhilian-run" ~/.local/bin/zhilian
mkdir -p ~/.config/systemd/user
cp systemd/zhilian-client.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now zhilian-client
systemctl --user status zhilian-client
journalctl --user -u zhilian-client -f🧩 能力矩阵
能力 | CLI | REST | MCP |
健康检查 |
|
|
|
登录态/模式/会话/风控 |
|
|
|
扫码 / 短信登录 |
|
|
|
人机验证中继 |
|
|
|
关键词 + 城市搜索 |
|
|
|
按 queryId 翻页 |
|
|
|
职位详情 |
|
|
|
去重公司列表 |
|
|
|
公司详情(含工商) |
|
|
|
公司全部在招职位 |
|
|
|
城市注册表 |
|
|
|
缓存统计 / 清理 |
|
|
|
🔌 三种接入方式
1)CLI
zhilian --help
zhilian search jobs --keyword 外贸 --city 565 --pages 2 --format table
zhilian jobs detail --number CCL1316344860J40974823208 | jq '.data.title'2)REST(默认 http://127.0.0.1:8791)
除 /v1/health 与文档端点外都需要 Bearer:
export ZHILIAN_API_TOKEN="$(grep '^ZHILIAN_API_TOKEN=' .env | cut -d= -f2)"
curl -s -X POST http://127.0.0.1:8791/v1/search/jobs \
-H "Authorization: Bearer $ZHILIAN_API_TOKEN" \
-H 'content-type: application/json' \
-d '{"keyword":"外贸","cityCode":"565","pages":2}' | jq '{ok, queryId: .data.query.queryId, jobs: (.data.jobs|length)}'
curl -s -H "Authorization: Bearer $ZHILIAN_API_TOKEN" \
http://127.0.0.1:8791/v1/companies/CZL1316344860 | jq '.data.business'所有响应统一 envelope:
{ "ok": true, "data": {}, "meta": { "schemaVersion": "1.0", "mode": "logged_in", "cached": false }, "error": null }3)MCP(默认代理到常驻 REST)
{
"mcpServers": {
"zhilian": {
"command": "/path/to/zhilian-client/bin/zhilian-run",
"args": ["mcp"],
"env": {
"ZHILIAN_CLIENT_URL": "http://127.0.0.1:8791",
"ZHILIAN_API_TOKEN": "<从 .env 读取>"
}
}
}
}MCP 工具共 17 个,命名为 zhilian_*,参数与 REST/CLI 同源;SKILL 见 skills/zhilian/SKILL.md。
⚙️ 常用配置(完整见 docs/03)
变量 | 默认 | 说明 |
|
| REST/MCP 认证 token,必须修改 |
|
| 仅允许 loopback |
|
| headless 只读;首次短信登录需 headful |
|
| 默认城市码(石家庄) |
|
| 默认排序 |
|
| EdgeOne 自动点击开关(也可走 |
| 2h / 7d | 列表 / 详情缓存时间 |
📚 文档
文档 | 内容 |
文档索引与阅读路径 | |
背景、用户结论、探路结论、命名/端口/默认值决策 | |
目标/非目标、架构、功能需求、风控、验收 | |
envelope、错误码、17 个操作、数据模型、上游字段映射 | |
安装、配置、登录、CLI/REST/MCP、systemd、排障 | |
cloak-env/FHS、profile、DISPLAY、权限、FAQ | |
2026-11-14 探路与联调实测(含登录、EdgeOne、分页) |
🧪 实测数据(2026-11-14,真实账号)
验证项 | 结果 |
登录态 |
|
搜索 | 石家庄「外贸」20 条; |
职位详情 |
|
公司详情 | 含工商信息(USCC、法人、注册资本、经营范围);EdgeOne 中继后成功 |
公司全部职位 | 21/21 全量(fe-api 分页接口, |
城市 | 461 个城市(含直辖市,默认石家庄 565) |
测试与生成物 | 35 个单测通过;OpenAPI 16 paths / 73 schemas;MCP 17 tools |
🔒 安全与合规
REST 仅监听
127.0.0.1:8791,Bearer 鉴权;profile / cache / log 权限600/700。二维码、验证码、短信码、cookie/token 不落长期日志;登录与验证中继仅在本机进行。
只读、低频、单账号;不做账号共享、批量导流或商业转售。
请遵守智联招聘用户协议与当地法律;使用产生的账号/合规风险由使用者承担。
📁 项目结构
zhilian-client/
├── src/ # 实现:domain / adapters / session / cache / api / transports
├── tests/ # 35 个单元测试
├── spec/ # 自动生成:OpenAPI / MCP tools / CLI commands / schemas
├── docs/ # 设计、接口、部署、环境文档 + assets 图片素材
├── exploration/ # 上游探路与联调实测记录
├── skills/zhilian/ # SKILL 工作流
├── systemd/ # systemd user unit
└── bin/zhilian-run # cloak-env FHS 包装启动器❤️ 致谢
架构与工程约定参考同机 boss-client(MIT,© CindyRIng)。
视觉素材:
hero-banner/logo/architecture-illustration/social-preview由 MiniMax-H3-Image 生成;rest-docs.png为真实运行截图。上游数据归智联招聘所有;本项目仅做本地个人用途的只读读取。
License
MIT © 2026 CindyRIng
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Chinese company registry, litigation, IP and credit data for AI agents. Read-only remote MCP server.
15Agent-driven search: build, import, tune, search, and score result quality — all over MCP.
Search, read, and act on the web. The Stophy MCP server for agents.
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables MCP hosts to search and retrieve job listings from nowcoder.com through public API/RSS, with keyword, location, remote, date, and limit filters plus read-only job detail lookup.MIT
- AlicenseAqualityBmaintenanceEnables agents to perform authorized read-only WeCom queries for group searches, chat message searches, document search/content, and meeting lists/details through stdio MCP, with browser login and automatic token renewal.63MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to search, count, and read open jobs from employer career sites and hiring platforms, with pay information and links to original postings, including through a no-account public endpoint.MIT
- AlicenseBqualityBmaintenanceEnables MCP clients to search job listings, read complete job descriptions, manage local search presets and candidate pools, and prepare application or message drafts. Optional session-backed chat reading and human-confirmed single-action execution are also supported.23MIT