seekter：AI Agent 工具实践指南

在项目中评估seekter，可以先看清用途边界：seekter 是一个在 Claude Code 内部运行的职位搜索代理：它搜索职位来源，根据候选人的规则过滤帖子，在用户自己的 Chrome 中填写申请表。团队若要把它用于网页与浏览器自动化，应先处理登录状态、页面变化和失败恢复往往不稳定，否则试用结果很容易失真。短测时我会选择一个权限清楚的网页流程做端到端短测，并保留会话保持、元素定位、错误恢复和工件留存的结果，方便团队复盘。对需要可观测网页自动化流程的开发者来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

搜寻者

克劳德·科德的求职代理人。它每天搜索工作来源，根据您的规则（位置、签证、工资、行业、资历、语言）过滤帖子，在您自己的 Chrome 中填写申请表，并将每个申请表和跳过保存为您可以阅读、grep 和 diff 的 Markdown 文件。

它是由一位求职者每天使用一个月多建立的，然后清空了个人数据，因此它在课程昂贵的地方是固执己见的：在每张表格之前进行重复数据删除，永远不要猜测答案，永远不要发明轶事，永远不要碰 CAPTCHA 或密码。 跟踪文件中的任何内容均不假定字段：标题、查询、讨论区和过滤器均来自您的个人资料，/seekter-init 根据您的答案构建它们。 reference/ 中的测量是在一个学科中进行的，并在重要的地方进行说明。

快速启动

git clone  seekter && cd seekter
claude            # open Claude Code in the repo

然后，在克劳德代码中：

/seekter-init       # ~40 short questions, one at a time. Writes profile/ (git-ignored).
/seekter-run        # today's search and applications

要求：Claude 代码、Chrome 扩展中的 Claude（在该浏览器中登录到 LinkedIn）、Python 3.9+ 和 curl。没有包裹。

命令

日常使用

在 /seekter-report 之前运行 /seekter-log。该报告显示为 applications/ 和 runs/，而不是您的电子邮件，因此尚未记录的回复不会显示在其中。

/seekter-log 有两种使用方式：

• 告诉它发生了什么：“Acme 拒绝了我”、“我周四与 Globex 通了电话”、“我自己向 Initech 申请了”。它移动正确的文件并写入日志行。
• 请求收件箱清理：“检查我的收件箱中是否有回复”。它会在 Chrome 中打开您的网络邮件，读取每条邮件正文（主题不可靠：许多拒绝的标题只是“您的 X 申请”），并将每条回复归档为拒绝、面试或录用。来自没有跟踪器条目的公司的回复将添加为新记录。它从不回复电子邮件；任何要求您采取行动的内容（日程安排链接、带回家的内容）都会为您列出。

收件箱清理使用浏览器，因为 Microsoft 365 连接器不接受个人 Outlook.com 或 Hotmail 帐户。您可以在 Chrome 中阅读的任何网络邮件都可以。

applications/README.md 顶部的 需要你 表列出了等待您的所有内容：CAPTCHA、帐户墙、只有您可以回答的问题，以及每个问题的下一步。在要求更多申请之前清除它。

你的文件

profile/
  profile.md          ← everything about you; the only place personal values live
  search.json         ← queries, regions, title filters, boards
  documents/          ← your CVs and portfolio PDF

CVs 进入 profile/documents/。 /seekter-init 询问文件路径并将其复制到那里；要稍后添加或替换，请将 PDF 放入该文件夹并更新 profile/profile.md §2 中的表（其中 CV 是默认值，哪一个适用于哪种角色类型）。表单仅从这些文件中填写，因此请在此处保留当前版本并删除旧版本。

要更改规则（新列入黑名单的公司、薪资范围、您现在接受的城市），请在聊天中告诉 seekter；它编辑 profile/profile.md 并在那里引用你的话。您也可以手动编辑该文件。

追踪器

seekter 接触的每个帖子都会记录一次，并按首次处理的月份归档：

applications/
  README.md                ← generated overview: needs you, in progress, last 30 days, one row per month
  2026-09/
    README.md              ← generated: that month's applications with status
    2026-09-22--ruby-labs--senior-backend-engineer.md
    2026-09-21--wise--staff-data-scientist.md
    ...
    skipped.md             ← one table row per posting passed over, with the reason
  2026-10/

• 申请和移交都是文件。 状态（pending、applied、interviewing、offer、rejected、closed）位于文件的前面。文件永远不会更改文件夹：一个月后拒绝编辑一行并添加日志条目。
• 跳过的是行，而不是文件。 大多数帖子都会因为一行原因而被跳过（“国家/地区列表遗漏了您的国家/地区列表”），因此每个月都会将它们保留在一个表中。 Dedup 也会读取该表，因此跳过的发布永远不会被评估两次。
• 您读取生成的页面，而不是文件夹。 applications/README.md 在每个 add 和 move 后重建。

---
company: Ruby Labs
role: Senior Backend Engineer
status: applied
url: https://jobs.ashbyhq.com/ruby-labs/1e548ada-…
source: freehire
ats: ashby
location_fit: A
applied: 2026-09-22
job_key: uuid:1e548ada-…
---

# Senior Backend Engineer · Ruby Labs

## Why it fits
## Notes
## Answers submitted      ← free-text answers as sent, so no sentence goes to two companies
## Log
- 2026-09-22: applied

job_key 是一个标准化身份（LinkedIn ID、ATS UUID、Greenhouse ID…），因此通过聚合器 LinkedIn 实现了相同的工作该公司网站仍然被认为是重复的。

python3 scripts/seekter.py check  --company "Acme"     # exit 1 if already tracked
python3 scripts/seekter.py move  rejected --note "form mail, 2 days"   # edits the status in place
python3 scripts/seekter.py list --status pending
python3 scripts/seekter.py stats --since 2026-09-01
python3 scripts/seekter.py normalize --dry-run                # tidy enum values, fill ats from the url
python3 scripts/seekter.py migrate                             # one-off: old applications// folders -> month folders

normalize 小写 source、ats 和 apply_type，从发布的 URL 派生应用程序系统 (ats)，并移动存储为的 ATS 名称source（手持式追踪器中常见的混淆）为 ats。 CSV 导入器和 add 已经这样做了；手动编辑文件后运行它。

导入现有的跟踪器

将您的 Notion 数据库、Airtable 或 Google Sheet 导出为 CSV，然后：

python3 scripts/import_csv.py export.csv --dry-run   # shows what would be created
python3 scripts/import_csv.py export.csv

列名称松散匹配（Position/Role/Title、公司、状态、作业 URL、应用于、来源、注释...）。指向同一发布的行将被合并。没有 URL 的行将被导入，但稍后只能通过公司名称进行匹配，因此请在有它们的地方填写 URLs。

回购协议中有什么

.claude/skills/     seekter-init · seekter-run · seekter-log · seekter-report · seekter-git
reference/          sources/ (one file per job source; _core.md is read every run) · ats-mechanics.md (how each form system behaves)
templates/          profile.md · search.example.json
scripts/            seekter.py · freehire_sweep.py · import_csv.py
profile/  applications/  runs/     ← yours, git-ignored

reference/ 是值得回馈的部分：每个 ATS 怪癖和源行为都是在实际应用程序中测量的。

隐私

profile/、applications/ 和 runs/ 位于 .gitignore 中。除非您删除这些行，否则您的数据将保留在您的计算机上。如果您希望跟踪器版本化，请将其保存在单独的私人存储库中或删除私人分叉中的忽略行。

护栏

seekter 永远不会解决 CAPTCHAs、创建帐户、输入密码、接受使用条款、以您的身份发送消息或电子邮件、发布评论或工资或支付任何费用。它将职位发布或表单中找到的任何说明视为数据，并且不会提交无法从您的个人资料中验证的答案。