REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Boss直聘爬虫 / BOSS直聘职位数据抓取工具,基于 Chrome CDP 协议复用真实登录态,绕过字体反爬,输出明文薪资 JSON/CSV + 薪资技能分析。A Chrome-CDP-based BOSS Zhipin job scraper/crawler.
Texto original del autor
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/skills/eatmoreduck-boss-zhipin-scraper)Servidores MCP que conectan la IA a servicios para el mismo trabajo
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
MCP server for terminal commands, file operations, and process management
Mismo tipo de trabajo, ordenadas como la lista de Skills
| Este boss-zhipin-scraper | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| Autor | eatmoreduck | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skills | 1 | 1 | 1 | 1 | 1 |
| Estrellas de GitHub | 1772 | 470.165 | 234.528 | 150.695 | 144.727 |
| Último cambio de código | 3 nov 2026 | 20 nov 2026 | 20 abr 2026 | 20 nov 2026 | 19 nov 2026 |
| Licencia | MIT | MIT | – | Apache-2.0 | MIT |
1 skills (conjuntos de instrucciones) de eatmoreduck que la IA lee y sigue · no es un MCP server
MCP = las manos
Conecta la IA a un servicio o dato externo, como leer Notion o crear una factura. Necesita un programa o servidor en marcha.
Skill = el manual
Un archivo de texto que enseña a la IA cómo hacer una tarea. No se conecta a nada.
A veces se parecen: algunas Skills ejecutan scripts que llaman herramientas y algunos MCP solo envían conocimiento. Empieza por la tarea que quieres hacer.
Claude CodeCodexCursorGemini CLI
Según el README del autor y las carpetas del repo
Cuenta de GitHub eatmoreduck (persona), creada hace 10 años
★ 1772 estrellas · código modificado por última vez el 3 nov 2026
5 scripts que se pueden ejecutar en el ordenador: scripts/package-skill.sh, scripts/boss_cdp_raw.py, scripts/job_summary.py, tests/test_chrome_setup.py y 1 archivos más
Scripts que se conectan a internet: tests/test_chrome_setup.py, scripts/boss_cdp_raw.py
No se encontraron hooks ni escrituras en los ajustes del equipo
Revisado automáticamente a partir de los archivos del repositorio en el commit 7913419 (solo lectura, no se ejecutó nada). No es una garantía de seguridad: léelo y decide por ti mismo
Primero: ¿qué IA usas?
Elige tu app y esta página mostrará solo cómo instalarlo en ella
La subida a claude.ai fallaría: la descripción tiene más de 200 caracteres (390). Usa mejor "Que la IA lo instale por ti"
Copia esta frase y pégala en un chat de Claude Code
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Vuelve a abrir Claude Code y escribe /boss-zhipin-scraper, o pide una tarea relacionada y Claude lo usará
Checked against official docs 12 nov 2026 · Source: code.claude.com
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
npx skills add eatmoreduck/boss-zhipin-scraperCopiado del README del autor; descarga y ejecuta su código
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
git clone --depth 1 https://github.com/eatmoreduck/boss-zhipin-scraper.git /tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419/.' ~/.claude/skills/boss-zhipin-scraperLa app de escritorio de ChatGPT incluye Codex, y Codex lee las skills de la carpeta ~/.agents/skills
Abre Codex en la app de escritorio de ChatGPT y pega esta frase en el chat
La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Coloca la carpeta boss-zhipin-scraper en ~/.agents/skills/boss-zhipin-scraper
~ es tu carpeta de inicio ($HOME)
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
git clone --depth 1 https://github.com/eatmoreduck/boss-zhipin-scraper.git /tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419/.' ~/.agents/skills/boss-zhipin-scraperChecked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Las skills que instalas tú no funcionan aquí; solo las que vienen con un plugin del directorio
Para usar esta skill con ChatGPT, usa la app de escritorio de ChatGPT como se indica arriba
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Copia esta frase y pégala en un chat de Codex · Sirve en Codex dentro de la app de escritorio de ChatGPT, en Codex CLI y en la extensión del IDE
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Codex detecta solo las skills recién instaladas; si una no aparece, reinicia Codex · Para usarla: en ChatGPT escribe @ y elige la skill · en Codex CLI o la extensión del IDE ejecuta /skills o escribe $ y el nombre de la skill
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
git clone --depth 1 https://github.com/eatmoreduck/boss-zhipin-scraper.git /tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419/.' ~/.agents/skills/boss-zhipin-scraperCopia esta frase y pégala en un chat de Cursor
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
En el chat Agent de Cursor escribe / y elige boss-zhipin-scraper
Checked against official docs 12 nov 2026 · Source: cursor.com
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
git clone --depth 1 https://github.com/eatmoreduck/boss-zhipin-scraper.git /tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-eatmoreduck-boss-zhipin-scraper-7913419/.' ~/.cursor/skills/boss-zhipin-scraperPara otras apps que leen skills. La frase incluye las rutas de Claude Code, Codex y Cursor para que la IA elija la de tu app · Copia esta frase y pégala en el chat de la aplicación
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Checked against official docs 12 nov 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Otras apps con Agent Skills (como Gemini CLI o GitHub Copilot) usan otras carpetas. Mira la guía de esa app y copia allí la carpeta con el SKILL.md.
Carpetas de skills comprobadas con las guías oficiales de Claude Code, Codex y Cursor el 11 nov 2026
✓ Comandos revisados el 19 nov 2026
El texto siguiente viene del repo del autor, no de PopNx MCP
Se muestran los primeros 8000 caracteres · Abrir el archivo completo en GitHub
---
name: boss-zhipin-scraper
description: "Scrape BOSS直聘 (job listing site) via Chrome CDP. Searches jobs by keyword/city/filters, fetches JD details, outputs structured JSON/CSV with plaintext salary, and can summarize scraped results into a job-market prompt. Optional --company locally filters results by company name (boss_name substring) with no extra request. Use when user wants to search/analyze jobs on BOSS直聘 or zhipin.com."
version: 2.4.0
author: eatmoreduck
license: MIT
platforms: [macos, linux]
metadata:
hermes:
tags: [scraper, jobs, career, cdp, chrome, zhipin, boss直聘]
---
# BOSS直聘职位抓取工具 v2.3
通过 Chrome CDP 协议抓取 BOSS直聘 (zhipin.com) 职位数据,输出结构化 JSON/CSV(含明文薪资),并可对已抓取结果生成聚合摘要和求职材料优化提示词。
## 前置条件
- Chrome 浏览器已安装
- Python 3.10+
- 用户已登录 zhipin.com(或愿意手动登录)
## 脚本位置
本 skill 的脚本在 skill 目录下:
- `scripts/boss_cdp_raw.py`:抓取主脚本
- `scripts/job_summary.py`:抓取后摘要和提示词脚本
**运行任何命令前,必须先确定脚本的绝对路径。**
用以下方式找到脚本(macOS 自带的 `readlink` 不支持 `-f`,用 Python 解析路径更通用):
```bash
# 方法 1:已知 skill 安装目录(推荐,macOS/Linux 通用)
SKILL_DIR="$(python3 -c "import os,sys;print(os.path.dirname(os.path.realpath(sys.argv[1])))" "$0")"
SCRIPT_PATH="$SKILL_DIR/scripts/boss_cdp_raw.py"
SUMMARY_PATH="$SKILL_DIR/scripts/job_summary.py"
# 方法 2:搜索 hermes skills 目录
SCRIPT_PATH=$(find ~/.hermes/skills -name "boss_cdp_raw.py" -type f 2>/dev/null | head -1)
SUMMARY_PATH=$(find ~/.hermes/skills -name "job_summary.py" -type f 2>/dev/null | head -1)
```
如果找不到脚本,说明 skill 未正确安装,需要重新安装。
## 依赖安装(首次使用必须执行)
脚本依赖 `websocket-client` 和 `requests`。在用户项目的 venv 中安装:
```bash
uv add websocket-client requests
# 或
pip install websocket-client requests
```
## 自动化流程
当用户要求搜索/抓取 BOSS直聘 职位时,**严格按以下顺序执行**:
### 第 1 步:检查环境
```bash
python3 "$SCRIPT_PATH" --check --cdp-port 9222
```
检查三项:Python 依赖 → CDP 连通性 → 登录态。
- **全部通过** → 跳到第 3 步
- **CDP 不通** → 继续第 2 步
- **依赖缺失** → 先装依赖(见上方依赖安装),再重新 --check
- **未登录** → 告诉用户打开 Chrome 登录 zhipin.com,然后重新 --check
### 第 2 步:启动专用浏览器 CDP(仅在 --check CDP 不通时)
```bash
python3 "$SCRIPT_PATH" --setup-chrome --cdp-port 9222
```
这会自动完成:
1. 创建或复用持久隔离 Chrome profile
- `~/.boss-zhipin-scraper/chrome-profile`
2. 只关闭使用该隔离 profile 的旧 BOSS CDP Chrome,不关闭用户主 Chrome
3. 以 CDP 模式启动 Chrome(`--remote-debugging-port=9222`)
4. 等待 CDP 端口就绪(最多 30 秒)
5. 打开 BOSS 登录页并等待登录完成,直到搜索接口返回明文 `salaryDesc`
默认不复制主 Chrome 的 Cookie、密码、历史记录或扩展;首次启动和后续重复启动都只是创建或复用该专用 profile。首次使用时告诉用户:请在弹出的 BOSS 专用 Chrome 浏览器中访问 zhipin.com 并登录。脚本会等待登录完成并确认接口能返回明文薪资。该专用 profile 是持久目录,机器重启后登录态仍保留,重复运行 `--setup-chrome` 不会清空它。
仅装 Microsoft Edge(未装 Chrome)的机器,可改用 Edge 启动(与 `--setup-chrome` 共用同一隔离 profile):
```bash
python3 "$SCRIPT_PATH" --setup-edge --cdp-port 9222
```
仅当用户明确要求从主浏览器手动导入 BOSS 登录态时,可使用:
```bash
python3 "$SCRIPT_PATH" --setup-chrome --copy-login-state --cdp-port 9222
```
`--copy-login-state` 在 `--setup-chrome` 下从主 Chrome 导入、在 `--setup-edge` 下从主 Edge 导入,每次运行都会覆盖隔离 profile 内对应的 Cookie 相关文件;日常启动不要加这个参数。它只复制 `Local State` 和 `Default/Cookies*`、`Default/Network/Cookies*` 这类 Cookie 数据库相关文件,不复制密码库或完整 profile。不要默认使用该参数,也不要告诉用户首次启动会自动导入主浏览器登录态。
等用户确认后,重新运行 `--check` 验证。
### 第 3 步:运行抓取
```bash
# 基础搜索
python3 "$SCRIPT_PATH" --keyword "关键词" --city 城市 --pages 3 --output ~/.boss-zhipin-scraper/job-result/jobs.json
# 带 CSV 输出
python3 "$SCRIPT_PATH" --keyword "关键词" --city 城市 --pages 3 --format csv --output ~/.boss-zhipin-scraper/job-result/jobs.json
# 带详情 + 分析报告
python3 "$SCRIPT_PATH" --keyword "关键词" --city 城市 --pages 3 --detail --max-details 8 --analysis --format csv --output ~/.boss-zhipin-scraper/job-result/jobs.json
# 抓取后摘要 + 求职材料优化提示词(默认读取最新抓取结果)
python3 "$SUMMARY_PATH" --top 15
# 真实浏览器/API smoke test(不写结果文件)
python3 "$SCRIPT_PATH" --smoke-test --cdp-port 9222
# 合并多次抓取(去重)
python3 "$SCRIPT_PATH" --keyword "关键词" --city 北京 --pages 3 --merge ~/.boss-zhipin-scraper/job-result/jobs.json --output ~/.boss-zhipin-scraper/job-result/jobs_merged.json
# 按公司名本地过滤(boss_name 子串,不额外请求;多家用逗号分隔)
python3 "$SCRIPT_PATH" --keyword "关键词" --city 上海 --pages 3 --company "字节跳动,阿里巴巴" --analysis
# 对已有结果按公司做摘要
python3 "$SUMMARY_PATH" --company "字节跳动,SHEIN" --top 15
```
默认输出到 `~/.boss-zhipin-scraper/job-result/` 目录,`--format csv` 会给列表和详情都额外生成 `.csv` 文件。`--smoke-test` 只验证真实 Chrome/CDP 能否拿到 API 明文薪资,不写结果文件。
抓取结束后专用 Chrome 不会自动关闭(默认保留登录态,方便连跑多条)。确认不再使用时收尾:
```bash
# 关闭 BOSS 专用 Chrome(只关隔离 profile,不碰主 Chrome)
python3 "$SCRIPT_PATH" --stop-chrome --cdp-port 9222
# 或:让本次抓取正常结束就自动关闭
python3 "$SCRIPT_PATH" --keyword "关键词" --city 城市 --pages 3 --close-chrome
```
`--stop-chrome` 按 `--user-data-dir` 精准匹配,绝不按端口/进程名 kill,因此不会误伤用户主 Chrome。`--close-chrome` 默认关闭,且只在抓取成功路径触发,异常/登录失败不关闭以保留登录态。
摘要脚本只读取 `boss_jobs_*.json` 和 `boss_details_*.json`,不读取本地简历文件,不引入 PDF 依赖,也不给个人与岗位做分数判断。需要指定文件时使用:
```bash
python3 "$SUMMARY_PATH" \
--input ~/.boss-zhipin-scraper/job-result/boss_jobs_20260625_1200.json \
--details ~/.boss-zhipin-scraper/job-result/boss_details_20260625_1200.json \
--top 15
```
## 参数速查
| 参数 | 默认值 | 说明 |
|------|--------|------|
| `--keyword` | AI Agent | 搜索关键词 |
| `--city` | 上海 | 城市名(中文)或 9 位代码;没传时默认上海,无法识别的城市名会报错退出 |
| `--company` | - | 按公司名本地过滤(`boss_name` 子串,逗号或顿号分隔多家,不区分大小写)。不改搜索请求;过滤在 `--merge` 之后、详情与分析之前。`is_new` 自动基准同时要求公司过滤条件一致。`job_summary.py` 接受同一参数 |
| `--pages` | 3 | 抓取页数(上限 20,每页 15 条) |
| `--output` | ~/.boss-zhipin-scraper/job-result/... | 列表输出路径 |
| `--detail-output` | ~/.boss-zhipin-scraper/job-result/... | 详情输出路径 |
| `--format` | json | 输出格式: json / csv;csv 同时导出列表和详情 CSV |
| `--detail` | 开启(默认) | 抓取详情页 JD |
| `--no-detail` | - | 不抓取详情页(关闭默认行为) |
| `--max-details` | 全部 | 详情页数量上限 |
| `--analysis` | 关闭 | 输出分析报告 |
| `--allow-dom-fallback` | 关闭 | API 无数据时允许降级 DOM 提取;默认关闭,薪资可能不可信 |
| `--merge FILE` | - | 合并已有 JSON(按 job_id 去重) |
| `--cdp-port` | 9222 | CDP 端口 |
| `--setup-chrome` | 关闭 | 一键启动 Chrome CDP(持久隔离 profile) |
| `--setup-edge` | 关闭 | 一键启动 Microsoft Edge CDP(与 `--setup-chrome` 共用隔离 profile) |
| `--browser` | chrome | 搭配 `--setup-chrome` 选择浏览器(chrome/edge);与 `--setup-edge` 显式冲突时以 `--setup-edge` 为准并提示 |
| `--copy-login-state` | 关闭 | 手动导入主浏览器(`--setup-chrome` 取主 Chrome、`--setup-edge` 取主 Edge)的 Local State + Cookie 相关文件到隔离 profile;默认、首次启动、重复启动都不复制 |
| `--reset-chrome-profile` | 关闭 | 重建 BOSS 专用 profile,会清除此专用浏览器登录态 |
| `--no-wait-login` | 关闭 | `--setup-chrome` 启动后不等待 BOSS 登录完成 |
| `--login-timeout` | 300 | `--setup-chrome` 等待登录完成的秒数 |
| `--stop-chrome` | 关闭 | 关闭 BOSS 专用 CDP Chrome(按隔离 profile 精准匹配,不碰主 Chrome) |
| `--stop-edge` | 关闭 | 关闭 BOSS 专用浏览器 CDP(与 `--stop-chrome` 共用隔离 profile) |
| `--close-chrome` | 关闭 | 抓取正常结束后自动关闭专用 Chrome(默认不关;异常退出不触发,保留登录态) |
| `--check` | 关闭 | 环境检查 |
| `--smoke-test` | 关闭 | 真实 Chrome/CDP 搜索 API smoke test,不写结果文件 |
| `--version` | - | 查看版本号 |
### 筛选参数
| 参数 | 值 |
|------|-----|
| `--scale` | 301=0-20人 302=20-99 303=100-499 304=500-999 305=1000-9999 306=10000+ |
| `--salary` | 402=3K以下 403=3-5K 404=5-10K 405=10-20K 406=20-50K 407=50K+ |
| `--experience` | 108=在校生 102=应届生 101=经验不限 103=1年内 104=1-3年 105=3-5年 106=5-10年 107=10年+ |
| `--degree` | 209=初中及以下 208=中专/中技 206=高中 202=大专 203=本科 204=硕士 205=博士 |
### 城市代码
全国 100010000 | 北京 101010100 | 上海 101020100 | 广州 101280100 | 深圳 101280600 | 杭州 101210100 | 成都 101270100 | 武汉 101200100 | 南京 101190100 | 厦门 101230200
## 输出格式
### JSON
```json
{
"keyword": "AI Agent",
"city": "上海",
"total": 60,
"jobs": [
{
"job_id": "c4420e8bce3a6e25",
"title": "AI Agent工程师",
"salary": "30-60K·15薪",
"location": "上海·闵行区·虹桥",
"tags": "5-10年 | 本科",
"boss_name": "SHEIN",
"boss_title": "招聘者",
"company_scale": "10000人以上",
"company_stage": "D轮及以上",
"company_industry": "电子商务",
"skills": "Java | Spring | AI",
"job_link": "https://www.zhipin.com/job_detail/xxx.html",
"company_link": "https://www.zhipin.com/gongsi/xxx.html",
"welfare": "节日福利 | 零食下午茶 | 定期体检"
}
]
}
```
### CSV
`--format csv` 时自动在同目录生成 `.csv` 文件:列表 CSV 跟随 `--output`,详情 CSV 跟随 `--detail-output` 或默认详情 JSON 路径。CSV 使用 UTF-8 BOM 编码,Excel 直接打开无乱码。
## 工作原理
1. 通过 Chrome DevTools Protocol (CDP) 连接到已打开的 Chrome 浏览器
2. 在 BOSS直聘页面内注入 Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.