job-search-tool

它做什么

• companies.yaml 直查 ATS API（Greenhouse、Ashby、Workable、Lever、SmartRecruiters）噪音低；aggregators.yaml 走关键词聚合（Adzuna、Remotive）覆盖广——都是文件驱动，改文件即改方向；filters.yaml 管标题、地点与技术栈规则，无需改代码
• profile.yaml 按设计进 gitignore、永不提交；profile.sample.yaml 示范了每条经历该量化到什么程度
• AI 步骤可选、按候选计费：python -m app.ai_evaluate --dry-run 不入队也不花钱，--limit 20 先试评分质量与成本；结果按匹配度排序写进 data/scored_candidates.csv
• make web 启动 Next.js 看板，直接读写 data/seen_jobs.sqlite3——没有导出导入环节；Remotive 免鉴权但只有远程岗，Adzuna 需要免费开发者密钥

什么时候用

跑数周定向求职的工程师：每次运行自动浮出真正匹配的新职位、没有招聘网站的噪音——并且在投出一份申请之前先拿到一份书面的匹配理由。

如何上手

git clone https://github.com/fedorchenko-juli/job_search_tool.git
cd job_search_tool
pip install -r requirements.txt
cp .env.example .env                    # 填入所需密钥
cp profile.example.yaml profile.yaml    # 再填入自己的经历
python -m app.main                      # 抓取 + 过滤 + 去重
python -m app.ai_evaluate --dry-run     # 预览 AI 步骤，不花钱
make web                                # 评审看板跑在 localhost:3000

注意事项

仓库出厂即按作者本人的求职配置（加拿大阿尔伯塔、Python/JS 技术栈）——第一次运行前先改 companies.yaml、aggregators.yaml、filters.yaml 与 profile.yaml，否则抓来的是别人的搜索。AI 评分按候选收费。各公司 ATS 端点与聚合源 API 可能不经通知就变化。MIT。