RecruitBridge MCP

面向 Agent 的招聘采集工具：发现主动投递或推荐人才，向 Odoo 查重，采集新人的可见简历和可用 PDF，生成 HTML 报告，再交付 Odoo。

不需要本地人才数据库或工作台。每次采集保存为独立任务；同公司、同人、同岗位已有档案就跳过，不覆盖资料、不追加版本。Agent 通过 15 个标准 stdio MCP 工具完成流程。

安装与初始化

需要 Node.js 24、Google Chrome，以及管理员提供的 Odoo 招聘接口地址、数据库名称、公司引用、connector 引用和 API Key。

Windows PowerShell：

npx.cmd --yes --ignore-scripts @heyjianhang/[email protected] init

macOS 终端：

npx --yes --ignore-scripts @heyjianhang/[email protected] init

初始化引导配置 Odoo、打开招聘专用 Chrome 登录，并生成 ~/.config/recruit-bridge/mcp-client.json。把该文件中的 MCP 条目合并到 WorkBuddy 等客户端即可使用；初始化不会改动客户端现有配置。Key 隐藏输入，只存本机受限配置，不放进客户端配置或报告。

初始化后运行同一包的 doctor --live 核验连接，或 login zhaopin 单独登录。详细命令、Windows 虚拟机注意事项和首次验收步骤见安装说明。

当前范围

版本 0.1.0-preview.2 使用 npm preview 标签，供试用验收。

• 智联：macOS 上已完成主动投递/寻访名单、Odoo 查重、可见正文、平台 PDF、HTML 与 Odoo 上传的真实单人及多人验证；重放不会重复建档。
• Windows：已加入初始化、路径和权限适配，等待 Windows 实机/虚拟机独立验收；不能据 macOS 测试推断 Windows 业务链路已经通过。
• 猎聘暂停；BOSS、外聘网、前程无忧尚未开放正式业务链路。五个平台的能力会分别返回，不把未支持的功能伪装为空结果。
• 智联精确投递日期、推荐续批及间歇平台错误仍有限制。“本次发现”不冒充“今日投递”。

采集仅使用当前账号正常可见资料和可用附件。账号登录、验证码由用户操作；工具不自动发招呼、索要附件或购买权益。没有提供或无权下载的附件会注明原因。

数据与运行

Node.js、TypeScript、官方 MCP SDK/Zod、stdio；必要时由共享 Playwright 会话执行平台操作。MCP 客户端管理进程，无须另起后台。专用 Chrome 和登录状态在用户目录中持久保存，更新程序不会清除登录。

Odoo 负责业务档案和去重。任务工作区保存 JSON、PDF 和离线 HTML；只上传业务字段和附件，不传输招聘平台 Cookie。每份记录保留来源平台、岗位、账号作用域和平台定位链接；打开链接可能需要在当前浏览器登录。

同一账号由一个执行进程持有。出现浏览器占用时，断开另一客户端的招聘 MCP 后再试。

开发与验证

源码仓库使用 Node.js 24 和 npm 锁文件：

npm ci --ignore-scripts
npm run check:delivery
npm run check:package

生产包只包含编译产物、安装说明、元数据和依赖锁；不含测试、运行账号、Key、浏览器配置或简历。原开发说明保留于源码仓库 docs/development-overview.md，最新业务证据见各里程碑和交付文档。

npm 包公开下载不代表开放源代码许可证，当前授权标记为 UNLICENSED。