全部作品
2026已交付工具
智联招聘本地客户端
zhilian-client
招聘信号进,结构化的公司线索出。
- 角色
- 设计与开发(独立)
- 年份
- 2026
- 状态
- 已交付
- 技术栈
- TypeScriptMCPOpenAPISQLite
招聘数据只解决一半问题。职位列表告诉你一家公司在招人,但不告诉你它是不是真公司、有多大、谁在管。真正有用的链路是:关键词加城市 → 职位 → 去重后的公司 → 工商信息 → 这家公司的全部在招职位。
问题
这条链在浏览器里做,就是纯手工的数据录入;用脚本做,又需要一个不会断的会话。智联的登录分两个域,数据在页面 SSR 和 fe-api 里,还有 EdgeOne 的人机验证。
做法
zhilian-client 是这个系列里的第二个只读客户端。我刻意照着 boss-client 的架构做:一个 owner 进程持有浏览器和 SQLite 缓存,CLI / REST / MCP 都只是客户端,通过本地 REST 调用;OpenAPI、MCP tools、CLI 命令从同一份操作定义生成。
17 个操作覆盖完整链:搜索、按 queryId 翻页、职位详情、去重公司列表、公司详情(含工商)、公司全部在招职位、城市注册表、缓存统计与清理。
架构要点
- 缓存:只存结构化字段(不存 HTML、cookie、验证码),列表默认 2 小时、详情 7 天,可强制刷新。
- 登录:扫码或短信一次,access 约 7 天、refresh 约 30 天自动续期。
- 反爬:EdgeOne 人机验证用中继处理,可以自动点击,也可以返回带坐标的截图交给人或 Agent。
- 全量取数:公司「全部职位」在上游是分页的,很容易被截断;这个客户端会真的取全(实测 21/21)。
学到什么
第二次实现才真正检验设计。第一个客户端已经把接缝划好——会话、适配层、缓存、契约生成——所以换一个上游、换一套分页、换一个反爬故事,都不用碰架构。35 个单测、17 个 MCP 工具、461 个城市数据,都是在这套骨架上长出来的。
只读和最小化采集也不只是合规备注,它让这个工具足够无聊,可以无人值守地跑。