Career Kit

English | 中文

别再海投了。Career Kit 是一个 AI 职业陪练 MCP 服务：抓真实岗位 → 分析差距 → 分阶段路线图 → 可打卡任务 → 求职漏斗复盘。

接入 Claude Code / Cursor / opencode / Codex，把你的求职从「投简历碰运气」变成「有真实数据支撑、可长期追踪」的计划。

在线体验职业地图 · 示例产物 · 完整文档

上图是真实产物：一份合成样例简历经完整链路生成的交互式职业地图。勾选即打卡、进度实时更新；在线版无需安装。 示例数据为合成，不含任何真实用户简历或报告。

30 秒看懂

• 真实数据，不瞎分析：接入 BOSS / 字节 / 腾讯 / 百度 / 阿里 / 牛客 / GitHub 经验帖，AI 基于市场真实要求分析差距；差距必须锚定真实来源，否则被硬门禁拒绝。
• 拆成阶段任务：分阶段、里程碑、可打卡任务（按次 / 按天 / 按比例），随时问「下一步做什么」。
• 求职漏斗可复盘：投递 → 过筛 → 面试 → offer 全程记录（事件口径），「面试后被拒仍计入面试数」，让数据告诉你问题在简历还是面试。
• 周检视：一键生成周期复盘（打卡 / 阶段 / 漏斗 + 事实性建议），隔一段时间回来也能立刻接续。
• 可交互职业地图：一键导出自包含 HTML，勾选即打卡、进度实时更新、浏览器本地保存。
• 跟着你变，不是死计划：拿到面试触发洞察重估；换目标时已完成进度自动沉淀为能力证据。
• 顺序归产品，时间归用户：只为任务定义顺序与完成标准，不设时限。

快速开始

方式一：一行启动（推荐）

需要 uv。未安装时：

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

uvx --from career-kit career-kit-doctor   # 安装体检
uvx --from career-kit career-kit          # 启动 MCP 服务（stdio）

注册到你的 AI Agent：

如果默认镜像还没收录新版本，或安装 iv8 失败，加官方索引： uvx --from career-kit --default-index https://pypi.org/simple career-kit。

方式二：源码安装

git clone https://github.com/W7uuuuz/Career-kit.git
cd Career-kit
pip install -e .

解释器很重要：注册命令里的 python 必须是执行过 pip install -e . 的那一个。本机有多个 Python 时，裸 python 可能指向缺依赖的解释器。最稳妥是 venv 绝对路径： D:\path\to\Career-kit\.venv\Scripts\python.exe（Windows）或 .venv/bin/python（macOS/Linux）。

注册命令（把 <venv-python> 换成你的绝对路径）：

claude mcp add career-kit -- <venv-python> -m src.server
codex mcp add career-kit -- <venv-python> -m src.server

opencode 配置：

{"mcp": {"career-kit": {"type": "local", "command": ["<venv-python>", "-m", "src.server"], "enabled": true}}}

macOS 用户把 python 换成 python3。opencode 的 .opencode/config.json 不是 MCP 注册入口，改它是无效的。

方式三：一键安装脚本

# macOS / Linux
bash install.sh

# Windows PowerShell
powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会建好 .venv、装好依赖，并直接打印注册命令（使用绝对解释器路径）。

本地控制台（可选）

career-kit-serve --open
# 或
"<venv-python>" -m src.web --open

只监听 127.0.0.1，用于查看路线图、任务怎么做 / 资源 / 完成标准并直接打卡；还可以编辑任务、登记投递、按方向筛选调研报告，并通过 SSE 自动刷新。打卡写入同一份 SQLite 档案，MCP 下次运行时直接读到。

验证安装

career-kit-doctor
# 或
"<venv-python>" -m src.doctor

全部 OK 后，对新会话说「调用 start_session」，或直接敲 /career-kit——收到「欢迎使用 Career Kit」即接入成功。

常见问题

60 秒体验（不安装）

• 在线版：打开 交互式职业地图，直接勾选任务看进度变化。
• 本地版：双击 docs/examples/demo/career-map.html，或安装后运行 career-kit-demo。
• 想看完整链路：docs/examples/demo/ 里有样例简历生成的路线图、进度仪表盘和原始档案。

它怎么工作

你：我想转 AI Agent 方向
Career Kit：分析差距 → 拉取真实岗位数据 → 设计路线图 → 拆成阶段任务

你：我不知道想做什么，帮我选个方向
Career Kit：三轴定位（能力 × 兴趣 × 真实岗位数据）→ 候选方向 → 引导选定

你：这步做完了
Career Kit：打卡记录 → 沉淀能力证据 → 阶段完成自动审计

你：我拿到大厂面试了
Career Kit：事件触发洞察 → 重估计划 → 调整阶段任务

底层是 41 个 MCP 工具，覆盖建档、档案管理、数据获取（含市场调研）、分析规划、任务与漏斗、洞察产出六大类。完整清单与调用时机见工具总览。

为什么是它

隐私与数据边界

• 程序数据存储在本地 ~/.career-kit/（档案主存储为 career-kit.db，JSON 为兼容镜像），报告与路线图存储在 ~/CareerKit/，不会发送到任何外部服务器。
• 知识库是用户自有资产，不随包升级丢失。
• 抓取只读取公开岗位 / 面经页面，请遵守来源站点条款与频率限制；本项目不提供内推、保 offer 或任何就业承诺。详见 DISCLAIMER.md。

文档

• 文档地图：所有文档的唯一入口
• LLM 使用指南：工作流、规则、常见场景
• 工作流详解：各阶段前置条件、输入输出
• 工具总览：41 个 MCP 工具的唯一事实源
• 企业库：已收录企业、数据源说明
• 知识库：目录结构、文件格式
• 示例：可交互职业地图与场景示例
• 贡献指南 · 行为准则 · 安全策略

适合谁

• 适合你，如果你：在找工作或转行、会用 Claude Code / opencode 这类 AI 编程工具、想要一份「有真实岗位数据支撑、可长期追踪」的计划。
• 暂不适合你，如果你：完全没有命令行使用经验。当前形态需要安装 Python + 注册 MCP，Web / 无安装版本在规划中。

贡献

欢迎 issue、PR 和新的企业数据源。开始前请读 CONTRIBUTING.md；新增企业源请参考 src/scrapers/_template/。

如果这个项目帮你少走了弯路，点一个 Star 就是最好的支持——它会让更多正在求职的人看到它。

开源协议

MIT