drission

Rust 浏览器自动化库，以及面向本地脚本和 AI 客户端的 drs CLI / MCP 服务。

简体中文 · English · API 文档 · 更新日志

drission 提供基于 tokio 的异步浏览器控制 API，默认通过 Chrome DevTools Protocol 驱动 Chrome、Edge、Brave、Chromium 和 Electron。仓库内的 drs 则把相同能力提供为命令行、 JSON 协议和本地 MCP 服务，适合测试工具、数据处理脚本和 AI 编程客户端调用。

[!IMPORTANT] 本项目仅用于您拥有或已获明确授权的系统。请遵守适用法律、网站条款、访问控制、 robots.txt 和频率限制。不得用于绕过身份验证或安全控制、未授权访问账户、采集受保护数据， 或实施攻击与骚扰。完整边界见负责任使用和 LICENSE。

选择入口

快速开始

Rust 库

当前是 0.6.0，默认 Chromium / CDP。crates.io 已同步：

cargo add drission

[dependencies]
drission = "0.6"
tokio = { version = "1", features = ["full"] }

use drission::prelude::*;

#[tokio::main]
async fn main() -> drission::Result<()> {
    let browser = Browser::launch(BrowserOptions::new().headless(true)).await?;
    let ctx = browser.context("account_001").await?;
    let tab = ctx.new_tab(Some("https://example.com")).await?;

    println!("title: {:?}", tab.title().await?);
    println!("h1: {:?}", tab.ele_text("h1").await?);

    browser.quit().await?;
    Ok(())
}

运行仓库内的最小示例：

cargo run --example cdp_demo

默认会探测本机已安装的 Chromium 系浏览器。浏览器选择、自动下载和服务器部署方式见 Chrome 自动下载与服务器部署。

drs CLI 与 MCP

drs 现在是 0.3.3。crates.io 可以直接装：

cargo install drission-cli --bin drs

不想装 Rust 的，从 GitHub Releases 或 GitCode Releases 下对应平台的预编译文件。 仓库 install/ 里也有脚本，用之前先看一眼内容。

drs ensure-serve --backend cdp --headless
drs --json open https://example.com
drs --json snapshot
drs --json context use account_001
drs --json open https://example.com --context account_001
drs listen start /api/ --xhr-only --method POST
drs --json network mock /api/user --body '{"ok":true}'
drs --json profile list

接入 MCP 客户端前可先预览配置变更：

drs setup --dry-run
drs setup

drs setup 会合并 Cursor 项目配置和 Codex 用户配置，不覆盖其中的其他 MCP 服务。 服务默认连接本机常驻浏览器进程，使标签页和浏览器配置可以跨 MCP 进程重启保留。 完整命令、JSON 响应格式、MCP 工具列表与手动配置方法见 CLI / MCP 文档 和持久浏览器说明。

0.6.0 加了什么

库：

• browser.context("account_001")：按名字隔离 Cookie / 代理 / UA / 时区。同名复用，关 Context 才拆。
• ProfileManager：磁盘 profiles/<id>/{manifest.json,chrome/}，登录态跨进程还在。
• tab.network().filter("/api/").method("POST")：listen / block / mock / rewrite / record。旧的 listen / intercept 没删。
• ChromiumPool::acquire()：领一个带许可的浏览器再 context / new_tab。

drs：

MCP 默认 DRS_MCP_TOOLS=core，只有开页 / snapshot / 点按 / 截图那一组。Context 和 network_* 在 browser 或 all 里。

完整命令见 CLI.md，分层说明见 运行时分层.md。

核心能力

• 异步控浏览器：导航、定位、点击、输入、键盘、滚动、上传、iframe、Shadow DOM、多标签。
• Context / Profile：进程内账号隔离，磁盘 profile 保登录。
• 网络：XHR 监听、拦截、mock、改写、HAR；控制台和 WebSocket 也能看。
• 给脚本和 AI 用的：drs CLI、JSONL daemon、stdio MCP；snapshot 比整页 HTML 轻。
• 池、代理健康检查、重试、断点；identity 那套租赁 / 冷却 / ledger 还在。
• OCR、滑块缺口识别是可选 feature，只该用在自己的或已授权的测试环境。

Features

示例配置：

# 默认 CDP，加上 OCR
drission = { version = "0.6", features = ["ocr"] }

# 只用 Camoufox
# drission = { version = "0.6", default-features = false, features = ["camoufox"] }

各 feature 的依赖关系与构建要求以 Cargo.toml 和 API 文档为准。

CDP 与 Camoufox 两个后端的逐条能力对照与选型建议,见后端能力矩阵。

兼容性

无桌面环境可使用 headless 模式。容器及 Linux 系统依赖见服务器部署。

文档与示例

• 文档索引：架构、部署、网络监听、并发池和 API 映射。
• CLI / MCP：drs 命令、JSON 协议、MCP 工具与配置。
• 示例索引：按功能分类的可运行示例与命令。
• DrissionPage API 映射：从 Python API 查找 Rust 对应写法。
• API 参考：类型、方法和 feature 标记。
• 更新日志：发布版本的功能与兼容性变化。
• 贡献指南与安全策略。

负责任使用

浏览器自动化可能处理登录状态、个人信息、受版权保护的内容或会产生真实业务影响的操作。 在部署前，请至少确认以下事项：

1. 仅访问您拥有或已获得明确书面授权的系统、账户与数据。
2. 遵守适用法律、合同、平台条款、robots.txt、访问控制和频率限制。
3. 不绕过付费墙、身份验证、验证码或其他安全控制，不规避封禁或冒充他人身份。
4. 不采集无权处理的个人、机密、受版权保护或其他受限制数据；遵循数据最小化原则。
5. 对写入、发布、购买、删除等操作使用隔离测试环境、最小权限和人工确认。
6. 妥善保护浏览器 profile、Cookie、日志、截图和导出文件，避免把敏感数据提交到版本库。

可选的 OCR、图像分析、浏览器配置和网络观测能力不构成访问任何第三方系统的授权。 项目名称及文档中提及的第三方商标归各自权利人所有，不代表其认可、合作或担保。

本节是项目使用边界说明，不构成法律意见，也不能替代针对具体业务和司法辖区的专业评估。 如发现安全问题，请按 SECURITY.md 使用私密渠道报告。

许可证

本项目采用自定义的 source-available、非商业许可，不是 OSI 认可的开源许可证。 个人学习和合法非盈利使用须同时满足 LICENSE 的全部条款；商业使用、付费再分发、 将本项目作为付费产品或服务的核心等情形，需要事先取得版权持有人的书面授权。

使用者应自行评估其具体用途是否合规。许可证与免责声明不能排除适用法律下不可排除的责任。

致谢

• DrissionPage：API 设计参考。
• Camoufox：可选浏览器后端。
• ddddocr：OCR 模型来源。
• tract：Rust ONNX 推理引擎。

由极数本源维护。