跳到正文
全部作品

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 个城市数据,都是在这套骨架上长出来的。

只读和最小化采集也不只是合规备注,它让这个工具足够无聊,可以无人值守地跑。

35

单元测试

17

MCP 工具

461

城市

下一个项目探迹本地客户端tanji-client项目详情