BOSS Zhipin Job Scraper
Scrapes BOSS直聘 (zhipin.com) job listings through Chrome CDP and exports structured JSON/CSV with plaintext salaries plus a job-market summary.
Data & AnalyticsIntermediate★ 1,470⑂ 186AI score 8/10Last updated: Sep 17, 2026
What it does
- Attaches to a logged-in Chrome instance via the DevTools Protocol, calls BOSS直聘's search API, and returns plaintext salary strings that bypass the site's font-based anti-scraping.
- Searches by keyword, city, company size, salary band, experience and degree, and can fetch full job descriptions.
- Writes structured JSON plus Excel-friendly UTF-8 BOM CSV, with
job_idde-duplication and page-by-page incremental writes so an interrupted run loses nothing. job_summary.pyaggregates results into a market overview and a prompt for improving your application materials.- Uses an isolated
~/.boss-zhipin-scraper/chrome-profileand only stops that profile's browser, never your main Chrome.
Who it's for
- Job seekers and researchers studying the Chinese tech job market.
- Anyone who wants real data on salary bands, required experience and skill keywords.
- Intermediate users comfortable with the terminal and Python environments.
Examples
--keyword "AI Agent" --city 上海 --pages 3 --format csvto pull dozens of listings and chart salaries in Excel.--detail --max-details 8 --analysisto fetch full JDs and extract the most requested skills.job_summary.py --top 15to summarize top postings and generate resume-tuning prompts.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/eatmoreduck/boss-zhipin-scraper/HEAD/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the SKILL.m folder from the GitHub repo eatmoreduck/boss-zhipin-scraper into my ~/.claude/skills/boss-zhipin-scraper/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/eatmoreduck/boss-zhipin-scraper.git && mkdir -p ~/.claude/skills/boss-zhipin-scraper && cp -r boss-zhipin-scraper/SKILL.md boss-zhipin-scraper/scripts boss-zhipin-scraper/data ~/.claude/skills/boss-zhipin-scraper/⚠ This is a third-party skill. Check the source repository before installing.
- Prerequisites: Chrome (or Edge) installed and Python 3.10+ — check with
python3 --version. - Clone the repo:
git clone https://github.com/eatmoreduck/boss-zhipin-scraper.git - Copy it into your skills folder:
mkdir -p ~/.claude/skills/boss-zhipin-scraper && cp -r boss-zhipin-scraper/SKILL.md boss-zhipin-scraper/scripts boss-zhipin-scraper/data ~/.claude/skills/boss-zhipin-scraper/(Hermes users: copy under~/.hermes/skills/data-science/). - Install dependencies:
pip install websocket-client requests(oruv add websocket-client requests). - Run the environment check:
python3 ~/.claude/skills/boss-zhipin-scraper/scripts/boss_cdp_raw.py --check --cdp-port 9222 - If CDP isn't reachable, run
--setup-chrome --cdp-port 9222and log in to zhipin.com in the dedicated Chrome window that opens. - Restart Claude Code, then ask something like "scrape 3 pages of AI jobs in Shanghai from BOSS直聘".
View source on GitHub ↗License: MIT