boss-cli

Español | 中文

Busca ofertas de empleo de BOSS直聘 (com.hpbr.bosszhipin) desde tu terminal o desde un agente de IA — sin dispositivo, Python puro, no necesita teléfono/emulador para ejecutarse. Reproduce la firma nativa de peticiones de la app (libyzwg.so) en Python, por lo que una simple petición HTTP es aceptada por el servidor.

$ boss search "安卓逆向" --city 北京,上海,杭州
# 12 jobs for '安卓逆向' (cities=['北京', '上海', '杭州'], page=1)
- [北京] 资深Android逆向与风控对抗专家 | 70-100K·13薪 | PureblueAI
- [上海] 移动安全/逆向工程师 | 30-60K | ...
- [杭州] android逆向开发 | 50-75K | 小算科技
...

Proyecto de investigación / educativo. Busca con el token de tu propia cuenta con sesión iniciada; eres responsable de cumplir los Términos de Servicio de BOSS直聘. No satures la API.

Características

• Búsqueda sin dispositivo — no necesita teléfono, emulador ni unidbg en tiempo de ejecución; solo Python + tu token de sesión.

• Varias ciudades en una sola llamada — --city 北京,上海,杭州, por nombre o código.

• Filtro por palabras clave — --filter 远程 / --filter 兼职 conserva solo los empleos que coinciden (título / etiquetas / empresa).

• Salida limpia o JSON — lista legible, o --json para scripts.

• Servidor MCP — expone la búsqueda como una herramienta (boss_search) para Claude / cualquier cliente MCP.

Instalación

pip install -r requirements.txt          # lz4, requests   (mcp only needed for the MCP server)

Obtén tu sesión (una sola vez)

El cliente necesita tres cosas de una app de BOSS直聘 con la sesión iniciada en un dispositivo que controlas:

Captura una petición GET https://api5.zhipin.com/api/batch/requests de la app con cualquier interceptor HTTPS (Reqable / Charles / mitmproxy; usa un script de frida SSL-unpin si la app fija el certificado), y copia esos valores en session.local.json:

cp session.example.json session.local.json    # then paste your t2 / client_info / uniqid / cardlist_defaults

session.local.json está en gitignore (contiene tu token). t2 expira — cuando las búsquedas empiecen a devolver invalid auth, obtén un t2 nuevo de la misma manera.

Uso

# by city name or code, one or several
boss search "Python"                              # default city from your session
boss search "数据分析" --city 上海
boss search "安卓逆向" --city 北京,上海,杭州        # multi-city, results tagged [city]

# filter / paginate / cap
boss search "逆向" --city 北京,上海 --filter 远程   # only jobs mentioning 远程 (remote)
boss search "Golang" --page 2 --limit 20
boss search "算法" --json                          # parsed jobs as JSON

# run without installing (module form)
python -m bosscli.cli search "AIGC" --city 深圳

Opciones: --city (nombre/código, separados por comas) · --filter <text> · --page N · --sort -1 · --limit N · --json · --token <t2> (anula) · --session <path>.

Nombres de ciudades integrados: 全国 / 北京 / 上海 / 广州 / 深圳 / 杭州 / 成都 / 南京 / 武汉 / 西安 / 苏州 / 天津 / 长沙 / 重庆 / 郑州 / 厦门 (otras: pasa el código sin procesar).

Servidor MCP

BOSS_SESSION=./session.local.json python -m bosscli.mcp_server

Regístralo en tu cliente MCP (p. ej. ~/.claude.json); la herramienta es boss_search(query, city?, page?, sort?).

Cómo funciona (versión corta)

La búsqueda de BOSS直聘 pasa por un endpoint por lotes cuyos parámetros llevan dos valores antimanipulación — sp (un blob de parámetros cifrados) y sig (una firma) — ambos generados por la librería nativa libyzwg.so. Este proyecto reproduce la firma/cifrado de esa librería en Python puro (bosscli/yzwg.py), ensambla la petición por lotes (bosscli/signer.py), la envía y descifra la respuesta (bosscli/client.py). La corrección se asegura con pruebas byte a byte contra capturas reales (tests/). Ese es todo el truco: una vez que la firma está reproducida, la búsqueda es solo una llamada HTTP.

python tests/test_yzwg.py       # native crypto — byte-exact vs real-device captures
python tests/test_signer.py     # request assembly round-trip

Estructura

bosscli/yzwg.py     signing / encryption primitives (pure Python)
bosscli/signer.py   batch-request assembly
bosscli/client.py   search: build → send → decrypt → parse
bosscli/cli.py      the `boss search ...` CLI
bosscli/mcp_server.py  MCP wrapper (tool: boss_search)
tests/              byte-exact regression tests + fixtures
session.example.json   template for your session

中文

Español | 中文

在终端或 AI agent 里搜 BOSS直聘（com.hpbr.bosszhipin） 职位 —— 纯 Python、离设备，跑的时候不需要手机/模拟器。 它把 App 的 native 请求加签库（libyzwg.so）用 Python 复现了出来，所以一条普通 HTTP 请求就能被服务器接受。

$ boss search "安卓逆向" --city 北京,上海,杭州
# 12 jobs for '安卓逆向' (cities=['北京', '上海', '杭州'], page=1)
- [北京] 资深Android逆向与风控对抗专家 | 70-100K·13薪 | PureblueAI
- [杭州] android逆向开发 | 50-75K | 小算科技
...

研究 / 学习用途。它用的是你自己登录账号的 token 去搜；请自行遵守 BOSS直聘的服务条款，别高频打接口。

功能

• 离设备搜索 —— 运行时不需要手机 / 模拟器 / unidbg，只要 Python + 你的 session token。

• 一条命令多城市 —— --city 北京,上海,杭州，支持城市名或城市码。

• 关键词筛选 —— --filter 远程 / --filter 兼职，只保留标题/标签/公司命中的岗位。

• 文本或 JSON 输出 —— 可读列表，或 --json 供脚本消费。

• MCP 服务 —— 把搜索暴露成工具（boss_search）给 Claude / 任意 MCP 客户端。

安装

pip install -r requirements.txt          # lz4、requests（MCP 服务另需 mcp 包）

获取 session（一次性）

客户端需要从一台你自己、已登录的 BOSS直聘设备上拿三样东西：

用任意 HTTPS 抓包工具（Reqable / Charles / mitmproxy；App 若做了证书绑定，配个 frida SSL unpin 脚本） 抓一条 App 发出的 GET https://api5.zhipin.com/api/batch/requests，把上面几个值填进 session.local.json：

cp session.example.json session.local.json    # 再把你的 t2 / client_info / uniqid / cardlist_defaults 粘进去

session.local.json 已被 gitignore（里面是你的 token）。t2 会过期 —— 搜索开始返回 invalid auth 时，照上面再抓一个新的即可。

用法

# 按城市名或城市码，单个或多个
boss search "Python"                              # 用 session 里的默认城市
boss search "数据分析" --city 上海
boss search "安卓逆向" --city 北京,上海,杭州        # 多城市，结果带 [城市] 标签

# 筛选 / 翻页 / 限量
boss search "逆向" --city 北京,上海 --filter 远程   # 只看提到“远程”的岗
boss search "Golang" --page 2 --limit 20
boss search "算法" --json                          # 解析后的职位 JSON

# 不安装、直接模块方式跑
python -m bosscli.cli search "AIGC" --city 深圳

参数：--city（城市名/码，逗号分隔）· --filter <文本> · --page N · --sort -1 · --limit N · --json · --token <t2>（临时覆盖）· --session <路径>。

内置城市名：全国 / 北京 / 上海 / 广州 / 深圳 / 杭州 / 成都 / 南京 / 武汉 / 西安 / 苏州 / 天津 / 长沙 / 重庆 / 郑州 / 厦门（其它城市直接传城市码）。

MCP 服务

BOSS_SESSION=./session.local.json python -m bosscli.mcp_server

在 MCP 客户端里注册（如 ~/.claude.json）；工具名 boss_search(query, city?, page?, sort?)。

原理（一句话版）

BOSS直聘的搜索走一个批量端点，参数里带两个防篡改值 —— sp（加密参数串）和 sig（签名），都由 native 库 libyzwg.so 生成。本项目把这个库的加签/加密用纯 Python 复现（bosscli/yzwg.py），装配批量请求 （bosscli/signer.py）、发出去再解密响应（bosscli/client.py）。正确性靠对真实抓包的字节级测试兜底 （tests/）。核心就这一点：加签一旦复现出来，搜索就只是一次普通 HTTP 请求。

免责声明

仅供安全研究与学习交流。请勿用于任何违反 BOSS直聘服务条款或相关法律法规的用途；因使用本项目产生的一切后果由使用者自负。