Botright

背景：反爬战争中的隐形斗篷

在数据采集、价格监控、账号管理等场景中，网站反爬机制越来越严格。传统 Selenium/Playwright 驱动的浏览器会被识别为机器人——网站通过检测 Canvas 指纹、WebGL 渲染特征、UA 版本、时区、语言等数百个维度，给你的访问打上"可疑"甚至"封禁"的标签。

Botright 正是为解决这一痛点而生：它让自动化浏览器"长"得像真实用户，同时内置 AI 验证码求解能力，无需付费第三方 API。

Botright 是什么

Botright 是一个构建在 Playwright 之上的高级浏览器自动化框架，诞生于 2022 年 9 月，由独立开发者 Vinyzu 主导维护，目前拥有 996 Stars 和 82 Forks。它的核心定位是：最先进 undetected（反检测）、fingerprint-changing（指纹变更）、captcha-solving（验证码求解）自动化框架。

项目的 slogan 说得清楚：Build on Playwright, as easy to use as it is to extend. 即插即用，API 与 Playwright 高度兼容，现有 Playwright 代码只需修改初始化语句即可切换到 Botright。

核心能力：三层防护 + AI 求解

1. 指纹伪装（Fingerprint Spoofing）

Botright 通过 chrome-fingerprints 库生成伪造但逻辑自洽的浏览器指纹，覆盖以下维度：

• User-Agent 伪装：匹配真实的 Chrome/Firefox 版本号
• Canvas 指纹：注入视觉噪声，使 Canvas 2D 渲染结果与真实浏览器一致
• WebGL 指纹：伪装 GPU 型号和驱动程序信息
• 时区和语言：根据代理 IP 伪造对应地区设置
• Screen 分辨率和颜色深度：模拟真实用户显示器参数

开发者实测在 SannySoft、Incolumitas（0.8-1.0分）、BrowserScan、Fingerprint.com 等主流检测平台均表现优秀，reCaptcha v3 得分可达 0.9（接近满分）。

2. 真实浏览器启动策略

v0.3 起，Botright 采用真实本地 Chromium（推荐 Ungoogled Chromium）而非无头模式启动，从根本上规避无头浏览器特征检测。结合 undetected-playwright-patch，进一步消除已知反爬检测规则。

3. 验证码 AI 求解

这是 Botright 最有价值的功能之一——免费、不依赖第三方 API 的验证码求解能力：

技术架构

Botright 采用异步架构设计，代码组织清晰：

botright/
├── botright.py              # 核心客户端，继承 AsyncObject
├── modules/
│   ├── faker.py             # 指纹 + 地区数据生成
│   ├── geetest.py           # GeeTest 求解核心逻辑
│   ├── geetest_helpers.py   # GeeTest 辅助函数（18KB）
│   ├── hcaptcha.py          # hCaptcha 求解
│   └── proxy_manager.py     # 代理管理器
└── playwright_mock/        # Playwright 对象 mock，劫持关键 API
    ├── browser.py           # 浏览器上下文伪造
    ├── page.py             # 页面对象（34KB，最大模块）
    ├── frame.py             # iframe 嵌套处理
    └── locator.py           # 元素定位器

核心依赖：

• playwright >= 1.40：浏览器驱动基础
• undetected-playwright-patch：反检测 patch
• chrome-fingerprints：指纹生成
• hcaptcha_challenger：hCaptcha AI 求解
• recognizer：reCaptcha AI 求解
• pybrowsers：浏览器安装管理
• httpx：异步 HTTP 客户端
• numpy：数值计算
• async_class：异步单例/生命周期管理
• loguru：彩色控制台日志

开发规范： 代码质量工具链完整——mypy 严格类型检查、black 格式化、isort 导入排序、flake8 lint、pytest 测试，体现良好的工程素养。

使用示例

import asyncio
import botright

async def main():
    client = await botright.Botright()
    browser = await client.new_browser()
    page = await browser.new_page()
    await page.goto('https://example.com')
    # 你的自动化逻辑
    await client.close()

asyncio.run(main())

上手门槛与局限

优势：

• 安装极简：pip install botright + playwright install 即可
• Playwright 用户零成本迁移
• 验证码求解完全免费（无 API 费用）
• 代码模块化，易于扩展自定义求解策略

局限：

• 仅支持 Python，暂无 Node.js/Rust 版本
• hcaptcha_challenger 依赖已过时（README 标注 outdated），hCaptcha 求解成功率可能下降
• GeeTest v3/v4 服务标注 Currently Not Available，相关功能暂缺
• 无 Web UI，纯 CLI 编程方式，有一定学习曲线
• 反爬检测是猫鼠游戏，维护成本较高

行业意义

Botright 代表了浏览器自动化领域的"合法灰产"方向——其核心技术（指纹伪造、验证码求解）既可用于正当地数据采集、自动化测试，也可能被用于抢票、薅羊毛等灰色场景。项目采用 GPL-3.0 许可证，商业使用需开源修改。

它与 undetected-stealth-driver（Selenium）、puppeteer-extra-plugin-stealth（Node.js）等项目共同构成了"让机器人更像人"的技术生态。2024 年后，随着 AI 验证码（reCaptcha Enterprise、hCaptcha Adaptive）增多，纯规则检测逐渐被行为分析取代，这类工具的检测绕过能力会面临更大挑战。