📦 无浏览器（unbrowser）

安装 pip install pyunbrowser # 或使用 pipx 以获得隔离的 CLI： pipx install pyunbrowser # 或使用 uv： uv tool install pyunbrowser 轮子在内部包含特定于平台的本机二进制文件，并在 $PATH 上注册 unbrowser 脚本 macOS（arm64/x86_64）和 Linux（x86_64）得到支持；其他平台必须从源代码构建（cargo install --git https://github.com/protostatis/unbrowser） PyPI 分发名称是 pyunbrowser，而不是 unbrowser，这是由于 PyPI 名称审查；二进制文件和导入名称仍然是 unbrowser

快速入门（RPC over stdio） unbrowser 在 stdin 上读取 JSON-RPC 命令，并在 stdout 上写入响应 每个会话一个进程 — cookie、解析的 DOM 和 JS 状态在命令之间保持 unbrowser <<'EOF' {"jsonrpc":"2.0","id":1,"method":"navigate","params":{"url":"https://news.ycombinator.com"}} {"jsonrpc":"2.0","id":2,"method":"query","params":{"selector":".titleline > a"}} {"jsonrpc":"2.0","id":3,"method":"close"} EOF 导航返回 {status, url, bytes, blockmap, challenge} blockmap 是您的单次定向有效负载 — 使用它来计划查询，然后提取原始 HTML

快速入门（Python） from unbrowser import Client with Client() as ub： r = ub.navigate("https://news.ycombinator.com") if r.get("challenge"): # bot墙 — 升级到托管浏览器 raise RuntimeError(f"被 {r['challenge']['vendor']} 阻塞；升级") if r["blockmap"]["density"].get("likely_js_filled"): # SSR shell — 尝试 JSON 存储，否则升级 ... for s in ub.query(".titleline > a")[:5]: print(s["text"], s["attrs"]["href"])

RPC 方法（摘要） navigate {url} — 使用 Chrome 指纹的 TLS 的 GET、解析并返回 blockmap + 挑战检测 query {selector} — querySelectorAll 支持标签/ID/类/属性（= ^= $= *= ~=）、所有四个组合器和：first-child / :last-child / :first-of-type / :last-of-type / :nth-child(N|odd|even) / :nth-of-type(N|odd|even) / :only-child / :only-of-type 不支持：:not()、:has()、An+B text {selector?} — 第一个匹配的 textContent（默认 body） body — 最后导航的原始 HTML blockmap — 在 eval 后的 JS 修改 DOM 后重新计算 click {ref} — 在 ref 元素上分派点击（例如 e:142） 自动跟随 type {ref, text} — 设置值，触发输入 + 更改 submit {ref} — 收集 GET 表单字段，导航到操作 URL cookies_set / cookies_get / cookies_clear — cookie jar；用于重放从托管浏览器获得的清除 cookie eval {code} — 会话中的任意 JS close — 退出

决策规则 — 故障模式分类 技能的价值不是通过率，而是知道何时放弃 在每次导航之后，分支