Skip to content

issac-tjc/personal-job-feed

v1.1.0MIT

Self-hosted resume-aware job discovery, swipe review, and application tracking.

GitHub

Personal Job Feed

一个可独立部署的私人 ChatGPT MCP App：上传简历建立画像，从公司官网和官方 ATS 发现岗位，按自己的周期接收推荐，并通过左右滑管理兴趣状态。

功能

  • PDF、DOCX、TXT 简历上传；原件保存到部署者自己的私有 Cloudflare R2
  • 画像预览、编辑、确认、替换、下载和删除
  • 任意国家、岗位、行业、经验级别和全职/实习/合同工筛选
  • 按用户画像缓存匹配结果，职位事实与个人匹配数据分离
  • 每周日历、每天最多 3 个时段、每次 1–30 个岗位
  • 左滑感兴趣、右滑不感兴趣、Saved/已投状态和 CSV 导出
  • 简约白灰毛玻璃 UI、手机 fullscreen 和深色模式
  • Cloudflare Workers + D1 + R2 + Auth0；不需要 OpenAI API Key

每个使用者部署自己的 Worker、数据库、文件存储和 OAuth。仓库维护者不会托管或接触其他人的简历和求职数据。

快速开始

前置条件：Node.js 22+、Cloudflare 免费账户、Auth0 免费账户，以及支持私有插件和 Scheduled Tasks 的 ChatGPT 账户。

git clone <your-repository-url>
cd personal-job-feed
npm install
npm run setup

setup 会创建 D1、私有 R2 Bucket 和 Worker，暂停提示你完成 Auth0 配置，然后执行迁移、部署、健康检查并生成 dist/personal-job-feed-plugin.zip。外部账号授权仍需本人确认，脚本不会保存 Auth0 Client Secret。

部署完成后：

  1. 在 ChatGPT 创建私人 MCP 连接，URL 使用脚本打印的 /mcp 地址。
  2. OAuth scopes 填 jobfeed:read jobfeed:write jobfeed:resume。
  3. 安装生成的插件包或连接同一 MCP server。
  4. 打开 Personal Job Feed，上传简历并确认画像。
  5. 在 Settings 选择周期和岗位数，点击“保存并应用任务”。

同一 OpenAI 账号登录手机后，插件状态和 Scheduled Tasks 会同步；是否显示手机通知取决于 ChatGPT 账户能力和系统通知设置。

日常维护

npm run doctor          # 检查本机、Cloudflare、Auth0 和线上 Worker
npm run check           # 类型检查与测试
npm run upgrade         # 迁移、构建、部署并重新打包插件
npm run package:plugin  # 只重新生成私人插件 ZIP

部署状态和个性化配置保存在被 Git 忽略的 .jobfeed/；公开仓库不包含 Worker URL、D1 ID、Auth0 tenant 或用户 subject。 升级已有的私人插件时，打包器可在本地状态中保留原插件内部名称和 canonical app ID，确保“上传新版本”原位更新而不会创建重复插件；这些值不会提交到模板仓库。

隐私与成本

  • R2 Bucket 不公开；简历工具需要独立 jobfeed:resume scope。
  • D1 只保存结构化画像、限长提取文本、岗位状态和匹配缓存。
  • 替换画像后旧简历删除；未确认的临时简历最长保留 24 小时并在后续操作时清理。
  • 日常滑卡和状态更新不调用模型。
  • ChatGPT 只处理首次画像和新增/变更岗位，不访问 api.openai.com。
  • 设计目标适配 Cloudflare、R2、D1 和 Auth0 免费额度；R2 启用的是按量订阅，免费额度用尽后 Cloudflare 可能计费，请自行设置用量提醒并定期检查账单。

开发

cp .dev.vars.example .dev.vars
npm run db:migrate:local
npm run dev

生产环境始终验证 Auth0 issuer、audience、scope 和唯一 owner subject。本地认证绕过仅在 development 且 localhost 时生效。

不自动申请职位，不承诺公司会提供 sponsorship，也不会把公司历史记录描述为具体岗位承诺。