接入 AI Agent

OpenCareer 的 Agent 能力不是额外复制一份数据，而是让浏览器、MCP、REST API 和 CLI 共用同一套本地服务层。选择哪种入口，取决于你的 Agent 和自动化方式。

MCP：推荐的本地接入方式

在 OpenCareer 根目录运行：

python opencareer/app.py --data-dir .career-data mcp

客户端可以使用类似下面的配置：

{ "command": "python", "args": [ "opencareer/app.py", "--data-dir", ".career-data", "mcp" ] }

连接后，建议 Agent 先读取：

career://agent-guide career://openapi

这两个资源会说明当前可用操作、数据模型、限制和接口定义。让 Agent 先读规则，再执行读取或写入，能减少把字段当成自由文本乱改的情况。

Streamable HTTP MCP

本地网页服务运行期间，也可以使用：

http://127.0.0.1:8721/mcp

如果启动脚本因为端口占用选择了其他端口，以终端显示的实际地址替换 8721。

REST API 与 OpenAPI

服务运行后可访问：

• REST API：http://127.0.0.1:8721/api
• Swagger UI：http://127.0.0.1:8721/api/docs
• ReDoc：http://127.0.0.1:8721/api/redoc
• OpenAPI JSON：http://127.0.0.1:8721/api/openapi.json

支持 OpenAPI 的 Agent 或自动化工具可以根据当前接口定义发现操作。写操作需要本次本地运行周期生成的 Token：

1. 从 /api/session 获取当前 Token；
2. 在请求头中使用 X-Job-Token；
3. 不要把 Token 长期写入脚本或提交到仓库。

CLI

CLI 适合终端、脚本和本地批处理：

python opencareer/app.py --data-dir .career-data doctor python opencareer/app.py --data-dir .career-data record list jobs python opencareer/app.py --data-dir .career-data record list applications python opencareer/app.py --data-dir .career-data backup

给 Agent 的边界

可以把整理岗位、提取 JD 要点、更新标签、生成下一步计划交给 Agent；涉及以下动作时，保留人工确认：

• 向企业提交申请；
• 发送邮件或站内消息；
• 上传真实简历和证件；
• 修改已经核验的职业事实；
• 访问需要登录的外部招聘网站。