프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요 로그인

boss-zhipin-scraper Skill

저장소 ↗

제작자: eatmoreduck★ 1,770skill 1개

설치

할 수 있는 일

Boss直聘爬虫 / BOSS直聘职位数据抓取工具,基于 Chrome CDP 协议复用真实登录态,绕过字体反爬,输出明文薪资 JSON/CSV + 薪资技能分析。A Chrome-CDP-based BOSS Zhipin job scraper/crawler.

제작자가 쓴 원문

  • 연결 방식 AI가 읽는 지시 파일
  • 계정 또는 키 README와 SKILL.md에서 키를 찾지 못했습니다
  • 분류 코딩
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/eatmoreduck-boss-zhipin-scraper.svg)](https://mcp.popnx.com/en/skills/eatmoreduck-boss-zhipin-scraper)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

제작자: morluto널리 사용됨↓ 38.9만/주★ 46.9만8일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

제작자: fallow-rs널리 사용됨↓ 244.1만/주★ 5.4천어제 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Desktop Commander

MCP server for terminal commands, file operations, and process management

제작자: wonderwhy-er널리 사용됨↓ 74만/주★ 1만그저께 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
boss-zhipin-scraper
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
제작자eatmoreduckmorlutomultica-aiGraphify-Labsharry0703
Skill 수11111
GitHub 별1,770468,733234,332150,287144,566
마지막 코드 변경2026년 11월 3일2026년 11월 19일2026년 4월 20일2026년 11월 18일2026년 11월 18일
라이선스MITMIT–Apache-2.0MIT

eatmoreduck의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

Claude CodeCodexCursorGemini CLI

제작자 README와 repo 폴더 기준

설치

안전한가요?

  • 만든 사람

    GitHub 계정 eatmoreduck(개인), 만든 지 10년

  • 사용 현황과 관리

    ★ 1,770개 · 코드 마지막 수정 2026년 11월 3일

  • 스크립트가 있나요?

    컴퓨터에서 실행할 수 있는 스크립트가 5개 있습니다: scripts/package-skill.sh, scripts/boss_cdp_raw.py, scripts/job_summary.py, tests/test_chrome_setup.py 그리고 파일 1개 더

  • 인터넷을 사용하나요?

    인터넷에 접속하는 스크립트: tests/test_chrome_setup.py, scripts/boss_cdp_raw.py

  • 컴퓨터 전체 설정을 바꾸나요?

    hook이나 컴퓨터 설정을 쓰는 동작을 찾지 못했습니다

저장소 commit 7913419의 파일을 자동으로 검사했습니다(읽기만 했고 아무것도 실행하지 않았습니다). 안전을 보증하는 것은 아니니, 직접 읽어 보고 판단하세요

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

방법 1claude.ai에 업로드(웹과 앱)

설명이 200자를 넘어서(390자) claude.ai에 업로드할 수 없습니다. 대신 "AI가 대신 설치하기"를 사용하세요

방법 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

설치할 위치
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) for all my projects, at ~/.claude/skills/boss-zhipin-scraper. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) into the project this chat is open in (at .claude/skills/boss-zhipin-scraper). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Claude Code를 다시 열고 /boss-zhipin-scraper를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

제작자가 권하는 방법

Node.js 설치 (아직 없다면)

이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter

node -v
  • 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
  • "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법

Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter

Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"

아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다

Node.js 다운로드 페이지 열기 ↗

설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v

한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다

npx skills add eatmoreduck/boss-zhipin-scraper

제작자 README에서 가져온 명령으로, 제작자 코드를 내려받아 실행해요

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 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-scraper
  3. Claude Code를 다시 열고 /boss-zhipin-scraper를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

방법 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

설치할 위치
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) for all my projects, at ~/.agents/skills/boss-zhipin-scraper. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) into the project this chat is open in (at .agents/skills/boss-zhipin-scraper). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

방법 2폴더를 직접 넣기

boss-zhipin-scraper 폴더를 ~/.agents/skills/boss-zhipin-scraper에 넣으세요

~는 홈 폴더($HOME)입니다

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 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-scraper

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

방법 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

설치할 위치
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) for all my projects, at ~/.agents/skills/boss-zhipin-scraper. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) into the project this chat is open in (at .agents/skills/boss-zhipin-scraper). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 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-scraper
  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

방법 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

설치할 위치
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) for all my projects, at ~/.cursor/skills/boss-zhipin-scraper. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill boss-zhipin-scraper from https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419) into the project this chat is open in (at .cursor/skills/boss-zhipin-scraper). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Cursor Agent 채팅에서 /를 입력하고 boss-zhipin-scraper 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 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-scraper
  3. Cursor Agent 채팅에서 /를 입력하고 boss-zhipin-scraper 선택

방법 1AI가 대신 설치하기

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · 이 문장을 복사해서 앱의 채팅에 붙여 넣으세요

설치할 위치
https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419)에서 boss-zhipin-scraper이라는 Skill을 내 모든 프로젝트에서 쓸 수 있게 ~/.claude/skills/boss-zhipin-scraper에 설치해 주세요(Codex는 ~/.agents/skills/boss-zhipin-scraper, Cursor는 ~/.cursor/skills/boss-zhipin-scraper). 먼저 모든 파일을 보여 주고 스크립트가 있는지, 컴퓨터 설정을 바꾸는지 알려 주세요. 그다음 설치할 전체 경로를 알려 주고 제가 동의할 때까지 기다려 주세요.
https://github.com/eatmoreduck/boss-zhipin-scraper(commit 7913419)에서 boss-zhipin-scraper이라는 Skill을 이 채팅에서 열려 있는 프로젝트에 설치해 주세요(.claude/skills/boss-zhipin-scraper에. Codex는 .agents/skills/boss-zhipin-scraper, Cursor는 .cursor/skills/boss-zhipin-scraper). 먼저 모든 파일을 보여 주고 스크립트가 있는지, 컴퓨터 설정을 바꾸는지 알려 주세요. 그다음 프로젝트 이름과 설치할 전체 경로를 알려 주고 제가 동의할 때까지 기다려 주세요.

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

Terminal을 쓰는 분께

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

✓ 명령 확인 2026년 11월 19일

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

처음 8,000자 표시 · 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直聘页面内注入 

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
1,770
제작자
eatmoreduck
라이선스
MIT
최근 코드 수정
2026년 11월 3일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
agent-skills, ai-agents, boss-zhipin, boss-zhipin-scraper, boss-zhipin-spider, bosszp, chrome-cdp, claude-skills, crawler, job-scraper, python, scraper