JobClaw — AI 帮你投简历，你只管躺平

English

       __      __    ________
      / /___  / /_  / ____/ /___ __      __
 __  / / __ \/ __ \/ /   / / __ `/ | /| / /
/ /_/ / /_/ / /_/ / /___/ / /_/ /| |/ |/ /
\____/\____/_.___/\____/_/\__,_/ |__/|__/

JobClaw — AI 帮你投简历，你只管躺平

一句话说清楚： JobClaw 是一个开源的 AI 求职 Agent——自动抓岗位、用大模型帮你匹配、一键批量投递，投完还给你发 Telegram/Discord 消息汇报。
你要做的，就是写好简历，然后等面试通知。

😩 痛点：求职为什么这么累？

每个找过工作的人都懂：

Boss直聘刷到手酸，一个个点进去看 JD，看完觉得不太行，退出来继续刷
好不容易看到一个还行的，点"立即沟通"，想半天打招呼说啥，发完又没下文
一天下来投了十几个，回复的寥寥无几，时间全花在重复劳动上
有些岗位 HR 三个月没上线了，你还在那认真写打招呼语——投了个寂寞
LinkedIn 也要刷，拉勾也要看，多平台来回切，脑子都乱了
投完之后石沉大海，哪个回了、哪个没回，全靠记忆

你的时间应该花在准备面试和提升自己上，不是当人肉投递机器。

🦀 JobClaw 帮你做什么？

步骤	人工操作	JobClaw
🔍 搜岗位	多平台来回切，关键词一个个试	自动抓取 Boss直聘 + LinkedIn
📖 看 JD	一个个点开，人肉阅读判断匹不匹配	LLM 智能匹配，打分 + 给出匹配理由
💬 打招呼	想措辞、复制粘贴、一个个发	自动生成打招呼语，支持模板变量
📤 投简历	点「立即沟通」重复 100 遍	自动批量投递高匹配岗位
🧹 过滤垃圾	全靠直觉，经常投到僵尸岗	HR 活跃度过滤，跳过僵尸岗
📊 跟进状态	Excel？备忘录？全靠脑子？	Telegram / Discord 实时通知

简单说：你配好简历和偏好，JobClaw 帮你 24 小时无休投递。

✨ 核心功能

🤖 LLM 智能匹配引擎

不是简单的关键词匹配，而是用大模型理解你的背景和岗位要求，给出匹配分数 + 匹配理由。

三种 LLM 认证方式（优先级递减）：

优先级	方式	费用	说明
🥇	Claude OAuth	免费	白嫖 Claude Code 订阅额度，零 API 费用！
🥈	Anthropic API Key	按量付费	直接调用 Claude API
🥉	OpenAI API Key	按量付费	调用 GPT 系列模型

💡 省钱秘籍： 如果你有 Claude Code 订阅（$20/月），JobClaw 可以直接复用你的 OAuth token 调用 Claude，不额外花一分钱。Token 过期会自动刷新，完全无感。

📮 Boss直聘自动投递（核心卖点）

这不是简单的 API 调用——Boss直聘没有公开投递 API。JobClaw 用 Playwright 模拟真人浏览器操作，完整复现投递流程：

打开岗位页面 → 点击"立即沟通"
输入打招呼消息 → 点击发送
等待随机延迟 → 下一个

防封策略：

⏱️ 随机延迟：每次投递间隔 3-8 秒（可配置），模拟人类节奏
📅 每日上限：默认 100 次/天，避免触发风控
👻 僵尸岗过滤：跳过 HR 超过 N 天未活跃的岗位（默认 7 天）
🔄 防重复投递：JSON 历史记录，已沟通过的自动跳过
🤖 验证码检测：遇到验证码自动暂停，发 Telegram 通知你人工处理

打招呼消息模板：

你好！我对贵公司 $title 岗位很感兴趣，$name，方便聊聊吗？

支持变量：$company（公司名）、$title（岗位名）、$name（HR 名字）

🍪 Cookie 管理

jobclaw login — 弹出浏览器，交互式登录，cookie 自动保存到 ~/.jobclaw/cookies/
jobclaw login --check — 检查已保存的 cookie 是否还有效
优先级：.env 中配置的 cookie > 持久化文件 > 提示你重新 login
支持 Boss直聘 + LinkedIn

🔔 通知

投递完成后自动汇报：

Telegram Bot — 配置 TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID
Discord Webhook — 配置 DISCORD_WEBHOOK_URL

🚀 快速开始

1. 克隆 & 安装

git clone https://github.com/VPC-byte/jobclaw.git
cd jobclaw
pip install -e .

2. 安装浏览器内核

playwright install chromium

3. 登录求职平台

# 登录 Boss直聘（弹出浏览器，手动扫码/登录）
jobclaw login --platform boss

# 登录 LinkedIn
jobclaw login --platform linkedin

# 一次性登录所有平台
jobclaw login --platform all

# 检查 cookie 是否有效
jobclaw login --platform boss --check

4. 配置环境变量

cp .env.example .env

编辑 .env，根据需要填写（详见下方配置说明）。

5. 填写求职画像

cp profiles/example.yaml profiles/me.yaml

编辑 profiles/me.yaml——你的技能、期望薪资、偏好城市等。

6. 开跑！

# 完整流程：抓取 → 匹配 → 投递 → 通知
jobclaw run --profile profiles/me.yaml --query "Python 工程师"

跑起来之后去喝杯咖啡，等 Telegram 通知就行 ☕

🔧 CLI 命令全集

`jobclaw login` — 登录平台

# 登录 Boss直聘
jobclaw login --platform boss

# 登录 LinkedIn
jobclaw login --platform linkedin

# 登录所有支持的平台
jobclaw login --platform all

# 设置登录超时（分钟）
jobclaw login --platform boss --timeout 5

# 检查 cookie 有效性（不弹浏览器）
jobclaw login --platform boss --check

`jobclaw scrape` — 只抓取，不投递

# 抓取 Boss直聘上的岗位
jobclaw scrape --platform boss --query "后端工程师" --limit 20

# 抓取 LinkedIn
jobclaw scrape --platform linkedin --query "AI Engineer" --limit 10

# 全平台抓取
jobclaw scrape --platform all --query "Python 开发" --limit 30

💡 先用 scrape 看看抓到的岗位质量，再决定要不要跑完整流程。

`jobclaw run` — 完整流程

# 基础用法
jobclaw run --profile profiles/me.yaml --query "AI 工程师"

# 指定平台 + 限制数量
jobclaw run --platform boss --profile profiles/me.yaml --query "大模型工程师" --limit 20

# 全平台
jobclaw run --platform all --profile profiles/me.yaml --query "后端开发" --limit 50

`jobclaw validate-profile` — 校验画像文件

jobclaw validate-profile --profile profiles/me.yaml

确认你的 YAML 格式没问题再跑，避免跑到一半报错。

⚙️ 配置说明

`.env` 环境变量

变量	必填	默认值	说明
核心运行时
`JOBCLAW_ENV`	否	`development`	运行环境
`JOBCLAW_LOG_LEVEL`	否	`INFO`	日志级别
`JOBCLAW_HEADLESS`	否	`true`	浏览器是否无头模式（调试时设 `false` 看操作过程）
`JOBCLAW_MAX_JOBS`	否	`30`	单次最大处理岗位数
`JOBCLAW_REQUEST_TIMEOUT`	否	`30`	网络请求超时（秒）
LLM 配置
`CLAUDE_CREDENTIALS_PATH`	否	自动检测	Claude OAuth 凭证路径（默认 `~/.claude/.credentials.json`）
`CLAUDE_MODEL`	否	`claude-sonnet-4-6`	Claude OAuth 使用的模型
`ANTHROPIC_API_KEY`	否	-	Anthropic API Key
`OPENAI_API_KEY`	否	-	OpenAI API Key
`JOBCLAW_LLM_MODEL`	否	`gpt-4o-mini`	OpenAI 使用的模型
平台 Cookie
`BOSS_COOKIE`	否	-	Boss直聘 cookie（优先于持久化文件）
`LINKEDIN_COOKIE`	否	-	LinkedIn cookie
Boss直聘专属
`BOSS_GREETING`	否	-	打招呼模板，支持 `$company` `$title` `$name` 变量
`BOSS_APPLY_DELAY_MIN`	否	`3.0`	投递间隔最小秒数
`BOSS_APPLY_DELAY_MAX`	否	`8.0`	投递间隔最大秒数
`BOSS_DAILY_LIMIT`	否	`100`	每日投递上限（1-150）
`BOSS_SKIP_INACTIVE_DAYS`	否	`7`	跳过 HR 多少天未活跃的岗位
通知
`TELEGRAM_BOT_TOKEN`	否	-	Telegram Bot Token
`TELEGRAM_CHAT_ID`	否	-	Telegram Chat ID
`DISCORD_WEBHOOK_URL`	否	-	Discord Webhook URL
网络
`HTTP_PROXY`	否	-	HTTP 代理
`HTTPS_PROXY`	否	-	HTTPS 代理

🆓 Claude OAuth 零成本方案： 安装 Claude Code CLI（npm i -g @anthropic-ai/claude-code）并登录你的订阅账号，JobClaw 会自动检测 ~/.claude/.credentials.json 中的 OAuth token，无需任何 API Key，零额外费用。Token 过期前会自动刷新。

`profiles/me.yaml` 求职画像

name: "张三"
email: "zhangsan@example.com"
years_experience: 3

summary: >
  全栈开发，擅长 AI/ML 应用、云基础设施和 DevOps。
  目前在找 AI Agent 相关的岗位。

skills:
  - Python
  - TypeScript
  - LLM/Agent 开发
  - Kubernetes
  - Docker
  - AWS/GCP

desired_roles:
  - AI Agent 开发工程师
  - 大模型应用工程师
  - 后端开发（AI 方向）

preferences:
  locations:
    - "深圳"
    - "remote"
  salary_min: 25000
  salary_max: 50000
  work_schedule: "双休"
  industries:
    - AI
    - Web3
    - Cloud
  deal_breakers:
    - "996"
    - "大小周"
    - "无社保"

🏗️ 架构

+---------------------+
|   Profile Loader    |  你的简历 / 求职画像 (YAML)
+----------+----------+
           |
           v
+---------------------+      +----------------------+
|   Scraper Layer     |----->| Unified Job Objects  |
| Boss直聘 / LinkedIn |      | (Pydantic 标准化)     |
+----------+----------+      +----------+-----------+
           |                            |
           v                            v
+---------------------+      +----------------------+
|   LLM Matcher       |----->| 匹配分数 + 匹配理由   |
| Claude OAuth/API/   |      | (SSE streaming)      |
| OpenAI              |      +----------+-----------+
+----------+----------+                 |
           |                            v
+---------------------+      +----------------------+
|  Auto Applier       |----->| 投递状态              |
| Boss直聘 / LinkedIn |      | 已投 / 失败 / 跳过    |
+----------+----------+      +----------+-----------+
           |                            |
           +------------+---------------+
                        v
              +--------------------+
              | Notification Layer |
              | Telegram / Discord |
              +--------------------+

📂 项目结构

jobclaw/
  applier/                 # 自动投递
    base.py                #   投递器基类
    boss.py                #   Boss直聘投递（打招呼 + 防封策略）
    linkedin.py            #   LinkedIn Easy Apply
    captcha.py             #   验证码检测 + 通知
    history.py             #   投递历史记录（防重复）
  auth/                    # 登录认证
    browser_login.py       #   Playwright 交互式浏览器登录
    cookie_manager.py      #   Cookie 持久化管理
    claude_auth.py         #   Claude OAuth 凭证读取
    token_refresh.py       #   OAuth token 自动刷新
  matcher/                 # LLM 匹配引擎
    llm_matcher.py         #   多 provider 匹配打分
  models/                  # Claude API 客户端
    claude_api.py          #   Claude API 封装
    streaming.py           #   SSE streaming + retry/backoff
  notifier/                # 通知
    telegram.py            #   Telegram Bot 通知
    discord.py             #   Discord Webhook 通知
  profile/                 # 画像加载
    loader.py              #   YAML 画像解析
  scraper/                 # 爬虫
    base.py                #   爬虫基类
    boss.py                #   Boss直聘抓取
    linkedin.py            #   LinkedIn 抓取
  cli.py                   # CLI 入口（Click）
  config.py                # 配置管理（pydantic-settings）
  domain.py                # 数据模型（Pydantic）
profiles/
  example.yaml             # 画像模板
docs/
  architecture.md          # 架构设计文档
tests/
  test_models.py           # 测试

📋 支持平台

平台	抓取	投递	说明
Boss直聘 (zhipin.com)	✅	✅	Playwright 模拟打招呼
LinkedIn	✅	✅	Easy Apply 自动投递
拉勾 (Lagou)	🔜	🔜	适配器开发中
前程无忧 (51Job)	🔜	🔜	适配器开发中

🤝 参与贡献

欢迎 PR！特别欢迎：

🔌 新平台适配器（拉勾、前程无忧、猎聘……）
🧠 更好的匹配策略（prompt 调优、多维度评分）
🔒 稳定性改进（反爬对抗、断点续跑）
📢 新通知渠道（微信、飞书、钉钉）

pip install -e .[dev]
pytest -q

提 PR 前请跑测试、加类型标注、更新相关文档。

⚠️ 合规声明

自动化操作求职平台可能受到平台条款和当地法律的限制。请在合法合规、个人授权范围内使用本项目。作者不对滥用行为承担责任。

📜 许可证

MIT License — 详见 LICENSE。

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
docs		docs
jobclaw		jobclaw
profiles		profiles
tests		tests
.env.example		.env.example
.gitignore		.gitignore
Justfile		Justfile
LICENSE		LICENSE
README.md		README.md
README_EN.md		README_EN.md
pyproject.toml		pyproject.toml
test_base_url.py		test_base_url.py
test_openrouter.py		test_openrouter.py
uv.lock		uv.lock

Folders and files

Latest commit

History

Repository files navigation

JobClaw — AI 帮你投简历，你只管躺平

😩 痛点：求职为什么这么累？

🦀 JobClaw 帮你做什么？

✨ 核心功能

🤖 LLM 智能匹配引擎

📮 Boss直聘自动投递（核心卖点）

🍪 Cookie 管理

🔔 通知

🚀 快速开始

1. 克隆 & 安装

2. 安装浏览器内核

3. 登录求职平台

4. 配置环境变量

5. 填写求职画像

6. 开跑！

🔧 CLI 命令全集

jobclaw login — 登录平台

jobclaw scrape — 只抓取，不投递

jobclaw run — 完整流程

jobclaw validate-profile — 校验画像文件

⚙️ 配置说明

.env 环境变量

profiles/me.yaml 求职画像

🏗️ 架构

📂 项目结构

📋 支持平台

🤝 参与贡献

⚠️ 合规声明

📜 许可证

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`jobclaw login` — 登录平台

`jobclaw scrape` — 只抓取，不投递

`jobclaw run` — 完整流程

`jobclaw validate-profile` — 校验画像文件

`.env` 环境变量

`profiles/me.yaml` 求职画像

Packages