job_radar · 中国校招/实习/社招岗位开放数据集

简体中文 | English | 日本語 | 한국어 | Español | Français | Deutsch | Русский

每天自动更新的中国岗位数据集：各公司官方招聘页 → 每天采集 → 发布成可直接查询的 SQLite。 配套 CLI / MCP / Skill，让 AI agent 不用接口、不用 API key、零服务器就能查「谁在招、招什么、什么时候截止、去哪投」。

当前数据（2026-10-24 发布） 279 个数据源 · 约 8.9 万个在招岗位（校园约 3.2 万 / 实习约 5 千 / 社招约 5.2 万）· JD 正文 99.8% 目标公司 500 家：日历/数据覆盖 494 家（其中 490 家有日历条目，4 家只有岗位数据；其余 6 家已注明不可合规覆盖），数据源覆盖 161 家 自检：uv run python scripts/release_check.py --home ~/.jobradar（8 项门槛全绿）

这是什么 / 不是什么

• ✅ 各公司官方招聘页的岗位与 JD 原文（不含第三方聚合站）
• ✅ 每天全量重采、保留历史（下架、新开、变更都能回溯）
• ✅ 招聘日历：届次、项目类型、方向、网申时间、城市、投递入口、来源
• ❌ 不是「所有公司」：500 家目标里只有 161 家能拿到岗位级数据（见已知限制）
• ❌ 不做投递、内推、面经、薪资；不绕过验证码/登录/签名

30 秒上手

pip install "jobsearchradar[mcp]"

jobradar update                        # 下载最新数据（约 20 MB + 35 MB；已是最新则秒回、0 下载）
jobradar search --company 复星 --type campus --grad-year 2027 --table

国内网络走 Gitee 镜像（失败自动回退 GitHub）：

jobradar update --mirror gitee        # 或 export JOBRADAR_MIRROR=gitee

PyPI 包名是 jobsearchradar（jobradar 已被占用），装完命令仍然是 jobradar； 数据不走 PyPI，装好后跑一次 jobradar update 从 Release / Gitee 下载。

能问什么

jobradar search --text "PyTorch 大模型" --type campus    # 全文检索：标题 + JD 原文
jobradar search --company 腾讯 --city 深圳 --category 算法 --table
jobradar search --company 喜茶 --exclude-store           # 排掉门店/零售岗（这类约 8 千条）
jobradar search --company 星巴克中国 --dedupe            # 同一岗位的多条 req 折叠成一条，带 variants
jobradar diff --days 7 --types open                     # 近 7 天新开的岗位
jobradar diff --days 7 --by category --company 腾讯      # 某公司新增按职类分布（不再混入全库）
jobradar compare 公司A 公司B --category 算法            # 取同类岗位 JD 原文对比
jobradar trends 美团 --step-days 7                      # 在招数量随时间变化
jobradar show <job_id>                                  # 单岗详情（含 JD 原文）

招聘日历（搜不到岗位时也会引导到这里）：

jobradar calendar --group 阿里巴巴 --type 秋招 --table

# data_as_of: 2026-10-24T06:12:33Z  (2 条)

阿里巴巴 · 2027届 · 秋招
  公司/产品：阿里巴巴集团
  方向：技术类（智能算法、Agent Infra 工程师…）
  网申：来源未写（不代表已截止）
  城市：北京、上海、广州、深圳、杭州、成都
  入口：https://campus-talent.alibaba.com/campus/position
  来源：阿里巴巴校园招聘官网（岗位页）
  JD：可在 search 里查到 JD

calendar 是给「官网能看到岗位、但 JD 接口被验证码/签名挡住」的大厂准备的：只发日历信息， 末尾带一句 {公司名}希望你去他们的招聘页逛一逛哦~。

搜索「字节跳动」「华为」「小米」这类只做日历的公司时，search 不再只回"数据里没有"， 而是返回 calendar 字段 + 提示 jobradar calendar --group 字节跳动 --table。

接 agent

• Claude Code：把 skill/jobradar/ 复制到 ~/.claude/skills/jobradar/，agent 会通过 CLI 查询， 并遵守回答规则（注明数据时间、附链接、company_match 为 none 时不能说"这家公司没在招"）。
• MCP 客户端（Claude Desktop / Cursor 等）：命令填 jobradar-mcp（stdio），9 个工具。 数据目录不是默认的 ~/.cache/jobradar 时，要在 MCP 配置的 env 里传 JOBRADAR_HOME， 否则 MCP 会去找默认目录并报「本地没有数据」。
• 也可以直接当库用：from jobradar.core import queries

数据文件

数据发布在 Release data-latest（Gitee 有同日镜像，大文件按 .partNN 分片）：

• 每日 UTC 19:17（北京时间 03:17）采集，采集完成后自动发布新 Release；Gitee 镜像同日同步
• 下架判定：连续 3 次成功抓取中缺席；抓取失败不会导致岗位下架
• 字段说明：skill/jobradar/references/fields.md
• 数据许可：代码 MIT；岗位内容权利归原发布方，本库只做索引（草案见 docs/DATA-LICENSE.md）

覆盖与已知限制（诚实版）

不做的事：不爬第三方聚合站、不绕过验证码/登录/签名、不伪造 UA、不在流水线里用 LLM、不持久化任何凭据。

架构

GitHub Actions（每日 UTC 19:17 = 北京时间 03:17）
  ├─ crawl        279 个源 → 适配器（北森 / 大易 / Workday / 自研站）→ SQLite
  ├─ calendar     日历库：人工条目（A/B/C 三档）+ 数据层自动条目
  ├─ release      打包 gzip 上传 Release data-latest（+ 每周归档，保留 8 周）
  └─ mirror       同步到 Gitee 发行版（国内加速）

本地
  jobradar update     ← Release / Gitee（自动回退、gzip 与 SQLite 完整性校验、增量跳过）
  jobradar <query>    ← 纯本地 SQLite 查询（CLI / MCP / Skill 共用同一套查询层）

参与贡献

uv sync --all-extras
uv run pytest                              # 504 个测试函数全绿
uv run ruff check .
uv run python scripts/check_docs_links.py  # 文档断链 / 版本 / 安装说法一致性
uv run python scripts/release_check.py --home ~/.jobradar   # 8 项发布门槛

• 新增一家北森门户公司：在 sources/beisen.yaml 加一行（id/company/params.tenant）
• 新增适配器：按 CLAUDE.md 的流程（侦察 → fixtures → 专属测试），一个适配器一次提交
• 内部过程文档（阶段验收、交接、评审处置、覆盖计划）在 docs/internal/，不面向使用者

合规

只访问公开、无需登录的页面/接口；每源 ≤1 请求/秒；每源都有 compliance 记录（robots、条款、核查日期）。 收到来源方的删除/停止请求会先停用再沟通。详见 COMPLIANCE.md。

文档

FAQ · 施工规范 · 路线图 · 发布门槛 · 日历字段规范 · 日历来源规则 · PyPI 发布 · 数据许可 · 评测集 · 变更日志 · 文档索引