第33章 配置与运行招聘网站扫描器:Career-Ops 实战指南
指导扫描招聘网站设置并运行招聘网站扫描器,自动发现新的职位空缺。本指南将带你完成 portals.yml 的搭建,并运行扫描器以自动发现新的职位空缺。
开始之前确保你已完成快速入门指南。扫描之前,必须将 cv.md 和 modes/_profile.md 准备就绪。
配置 portals.yml portals.yml 是控制扫描器查找内容和查找位置的文件。你只需使用内置模板创建一次,然后编辑它以匹配你的目标职位。
在项目文件夹中运行以下命令: Terminalcp templates/portals.example.yml portals.yml 使用任意文本编辑器打开 portals.yml。该文件包含三个部分。以下步骤将逐一介绍。
配置职位标题过滤器 职位标题过滤器决定了扫描器是否向显示某个职位。它将职位标题与两个关键词列表进行比对。
在文件顶部附近找到 title_filter 部分: portals.ymltitle_filter: positive: - "AI" - "ML" - "Product Manager" negative: - "Junior" - "Intern" seniority_boost: - "Senior" - "Staff" - "Lead" 用匹配目标职位的关键词替换 positive 列表。职位必须匹配此列表中的至少一个关键词才能通过。检查不区分大小写,因此 "AI" 也能匹配 "ai engineer"。
用排除职位的关键词替换 negative 列表。如果职位标题中包含其中任何一个关键词,该职位将被跳过——即使它匹配了 positive 关键词。
除非你想添加或移除资深级别,否则保持 seniority_boost 不变。这些关键词不会过滤掉任何职位——它们只是将匹配的职位在结果中排名更高。
示例:如果你在寻找 Rails 工程职位,你的过滤器可能如下所示: portals.ymltitle_filter: positive: - "Rails" - "Ruby" - "Full Stack" - "Backend" negative: - "Junior" - "Intern" - "PHP" - "Java" seniority_boost: - "Senior" - "Staff" - "Lead" 提示从包含三到五个关键词的小型 positive 列表开始。你随时可以稍后添加更多。列表越长,就越难看出职位通过或未通过的原因。
添加要跟踪的公司 tracked_companies 部分是你希望扫描器每次都检查的特定公司列表。扫描器将直接访问每家公司的招聘页面并读取空缺职位。
在文件底部附近找到 tracked_companies 部分。每个条目如下所示: portals.ymltracked_companies: - name: Anthropic careers_url: https://job-boards.greenhouse.io/anthropic api: https://boards-api.greenhouse.io/v1/boards/anthropic/jobs enabled: true
- name: OpenAI careers_url: https://openai.com/careers enabled: true 要添加公司,复制现有条目并修改值: 字段内容name你希望其在结果中显示的公司名称careers_url公司职位列表页面的直接 URLapi可选。如果公司使用 Greenhouse,则填写 Greenhouse API URL。如果不确定,请省略此项。enabled设为 true 以包含该公司,设为 false 以在不删除条目的情况下跳过该公司。
要找到公司的 careers_url,访问公司网站,点击“职业发展”或“职位”,并复制列出空缺职位的页面 URL。这就是要使用的 URL。
要禁用某公司而不删除其条目,请设置 enabled: false: portals.yml - name: Stripe careers_url: https://stripe.com/jobs/search enabled: false 注意tracked_companies 中的每个公司都必须有 careers_url。如果没有,扫描器将没有页面访问并会跳过该条目。
审查搜索查询 search_queries 部分执行更广泛的网络搜索,以查找你未跟踪列表中的公司职位。模板中包含许多预构建的查询。
你无需修改此部分即可开始。预构建的查询涵盖了包括 Greenhouse、Ashby 在内的主要招聘网站。
当你准备好自定义时,每个查询如下所示: portals.ymlsearch_queries: - name: Greenhouse — Rails Engineer query: 'site:job-boards.greenhouse.io "Rails Engineer" OR "Ruby on Rails" remote' enabled: true 要关闭不需要的查询,请设置 enabled: false。要添加新的查询,复制现有条目,为其赋予新名称,并更新查询文本。
运行扫描 有两种运行扫描的方式。请选择符合你需求的方式。
选项 A — 直接运行脚本 Terminalnpm run scan 在项目文件夹中运行。脚本会读取 portals.yml,直接访问每家公司的 API,并将新职位写入 data/pipeline.md。它不使用 AI tokens,耗时约 30 秒。
此选项适用于任何其职位页面运行在扫描器内置提供商支持的平台上的公司:Greenhouse、Ashby 和 Lever,以及 Workable、Workday 和 SmartRecruiters 等数十个其他申请追踪系统和招聘网站。完整列表见 SUPPORTED_JOB_BOARDS.md。没有匹配提供商的公司将被跳过,扫描报告会告知数量。
在保存之前预览结果: Terminalnpm run scan -- --dry-run 这会运行完整扫描,但不会将任何内容写入磁盘。用于在保存结果前检查你的过滤器设置。
扫描单一公司: Terminalnpm run scan -- --company Anthropic 将 Anthropic 替换为你 tracked_companies 列表中的任何公司名称。匹配不区分大小写。
扫描 Dayforce 职业网站:
位于 jobs.dayforcehcm.com 上的 Dayforce (Ceridian) 职业网站会阻止普通 Web 请求,因此 npm run scan 无法读取它们。一个单独的脚本会为它们打开真实的浏览器会话,这比主扫描更慢。在 portals.yml 的 dayforce_boards 下列出这些董事会,每家公司一个条目,包含其名称和租户(该公司在 Dayforce 地址中的代码);templates/portals.example.yml 展示了格式。然后运行:
Terminalnpm run scan:dayforce
新职位会进入 data/pipeline.md,与主扫描一样。添加 -- --dry-run 以预览而不保存,-- --tenant
选项 B — 在 Claude Code 中运行 AI 驱动的扫描 在项目文件夹中打开 Claude Code 并输入: Claude Code/career-ops scan 此版本使用浏览器直接访问每家公司的职位页面,因此即使公司没有公开 API 也能正常工作。它还会运行你 portals.yml 中的 search_queries 以查找你未跟踪列表中的公司职位。
在以下情况下使用此选项:
你列表中的某家公司使用脚本没有提供商的平台,因此脚本扫描会跳过它 你想发现新公司,而不仅仅是检查已知公司 脚本扫描漏掉了你期望看到的职位
提示选项 B 使用 AI 模型 tokens 且比脚本耗时更长。这些 tokens 是计费到 API 密钥还是计入你的订阅,取决于你的 CLI 设置(参见 FAQ)。对于快速每日检查,选项 A 更快。
阅读扫描输出 扫描完成后,你会看到类似以下的摘要: Terminal━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Portal Scan — 2026-04-13 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Companies scanned: 42 Total jobs found: 318 Filtered by title: 291 removed Duplicates: 4 skipped New offers added: 23
New offers: + Anthropic | AI Engineer | San Francisco, CA + ElevenLabs | Solutions Architect | Remote ...
→ Run /career-ops pipeline to evaluate new offers. 以下是每行的含义: 行说明含义Companies scanned从 tracked_companies 中检查了多少家公司Total jobs found在这些公司中看到的所有空缺职位,在过滤之前Filtered by title因职位标题不匹配你的 title_filter 而被移除的职位Duplicates skipped已在你的 pipeline 或 tracker 中的职位——不会再次添加New offers added通过所有过滤器且对你来说是新的职位
如果 New offers added 为 0,首先在扫描输出中查找此警告: Terminal⚠️ 1 target(s) returned zero jobs without a successful HTTP response: Acme 这意味着该公司的招聘网站未成功响应,因此零值并不证明其职位板为空。该公司被记录为 unverified_zero 在 data/portal-health.tsv 中,并计入其失败连续次数。在更改你的过滤器之前,请检查该招聘网站。
如果没有此类警告,你的职位标题过滤器可能过于严格。尝试在 positive 列表中增加一个关键词并再次运行扫描。
新职位的去向:每个新职位作为一行添加到 data/pipeline.md。这是等待评估的职位列表。
data/scan-history.tsv 的作用:扫描器看到的每个 URL——无论是添加、过滤还是跳过——都会记录在此处。这是扫描器避免在后续扫描中再次向你显示相同职位的方式。一个例外是通过你的 location_filter 或 max_posting_age_days 设置在 portals.yml 中移除的帖子。它会被记录为 skipped_location 或 skipped_age,并且一旦你更改该设置,它可能会再次出现。你不需要编辑此文件。
评估扫描得到的新职位 当扫描将新职位添加到 data/pipeline.md(你的待定职位列表)后,运行 pipeline 命令以根据你的档案评估每一个。此步骤使用 Claude 读取职位描述,将其与你的 cv.md 和 modes/_profile.md 进行比对,并为每个职位生成评分摘要。
在项目文件夹中打开 Claude Code 并输入: Terminal/career-ops pipeline Claude 读取 data/pipeline.md 中的每个待定 URL,访问每个职位并评估它。结果以批次返回。每个批次显示如下的表格: Batch 1 done (Anthropic, ElevenLabs, Mistral): #CompanyRoleScoreLegitimacy024AnthropicAI Engineer4.8/5High Confidence025ElevenLabsSolutions Architect4.1/5High Confidence — fast-growing026Mistral AIProduct Manager3.2/5Proceed w/ Caution — role closed 以下是每列的含义: 列说明含义#报告编号。用于在 reports/ 中找到完整报告——例如,报告 024 是 reports/024-anthropic-2026-04-13.mdScore职位与你档案的匹配程度,从 1 到 5Legitimacy职位是否看起来真实且有效。"High Confidence" 表示职位有效且详细信息核对无误。"Proceed w/ Caution" 表示有事项引发标记——请阅读旁边的说明。
要阅读职位的完整评估,你有两个选项:
直接打开报告文件——使用表格中的编号在 reports/ 文件夹中找到它。 使用仪表板——在项目文件夹中运行 ./dashboard/career-dashboard,在终端界面中浏览你所有的报告。你可以按评分和状态筛选,并在不离开终端的情况下打开任何报告。
下一步做什么 当 /career-ops pipeline 完成后,每个职位都有一个 1 到 5 的评分。你可以在 reports/ 文件夹中找到任何职位的完整报告。评分显示了职位与你档案的匹配程度。
使用评分作为你的起点: 评分建议操作4.5 或更高强匹配。立即运行 /career-ops apply。4.0 – 4.4良好契合。运行 /career-ops apply。你也可以先运行 /career-ops contacto 以在申请职位前联系团队中的某人。3.5 – 3.9可能往两个方向发展。运行 /career-ops deep 以在决定前了解更多。低于 3.5除非你有特定原因要申请,否则跳过。
以下是每个命令的作用:
/career-ops apply — 打开申请表并根据你的档案填写定制化答案。它在提交前停止,以便你先审查所有内容。 /career-ops contacto — 在 LinkedIn 上找到招聘经理或团队成员,并为你起草一条简短的外联信息以便发送。 /career-ops deep — 深入研究公司和职位。当你举棋不定且想在决定前获取更多信息时使用此命令。 /career-ops tracker — 显示你 pipeline 中每个职位的状态。随时运行此命令即可查看当前进展。
提示你不必按顺序进行。如果某职位评分为 4.8,但你从未听说过该公司,先运行 /career-ops deep。这些命令可以独立使用——选择适合你情况的一个即可。
这个职位值得申请吗? 在申请前做出决定。career-ops 根据你的简历和目标对职位发布进行 1 到 5 的评分,展示其推理过程,并将决定权留给你。
为职位申请 使用 career-ops 根据你的档案和目标职位填写带有定制化答案的求职申请。