wulu-geetest-bypass

纯 Python 实现的极验行为验证 v4 自动化通过库（无需 Node.js）。自动处理 ai / slide / match / winlinze / svg_seed / svg_icon / voice 七种风险类型，支持自定义重试、代理和 HTTP 客户端。

安装

推荐使用 uv（更快、更现代的 Python 包管理器）：

uv add "wulu-geetest-bypass[all]"

也可用 pip：

pip install "wulu-geetest-bypass[all]"

可选依赖：

# voice 语音验证
uv add "wulu-geetest-bypass[voice]"

# slide 滑块（需要 opencv）
uv add "wulu-geetest-bypass[slide]"

# svg SVG 图标选择 + slide
uv add "wulu-geetest-bypass[svg]"

# 全部安装
uv add "wulu-geetest-bypass[all]"

快速开始

import asyncio
from wulu_geetest_bypass import Geetest


async def main():
    g = Geetest(captcha_id='your_captcha_id', risk_type='slide')
    result = await g.resolve()
    print(result)
    # {
    #     "captcha_id": "xxx",
    #     "lot_number": "xxx",
    #     "pass_token": "xxx",
    #     "gen_time": "xxx",
    #     "captcha_output": "xxx"
    # }


asyncio.run(main())

每次验证会自动重试最多 3 次（可通过 retry 参数调整），失败时抛出 VerifyError。

风险类型

API

Geetest(**options)

方法

load() -> dict

获取验证初始化数据，返回值包含 captcha_type、lot_number、payload、process_token、pow_detail 等字段，可直接传入 verify()。

verify(data) -> VerifyResponse

提交验证并返回完整响应：

class VerifyResponse:
    status: str  # "success" / "fail" / "error"
    data: VerifyData  # 验证结果数据


class VerifyData:
    lot_number: str
    result: str  # "success" / "fail"
    fail_count: int
    seccode: Seccode
    score: str
    payload: str
    process_token: str
    payload_protocol: int

resolve(retry=3) -> Seccode

一键完成 load() + verify()，验证失败时自动重试，返回 Seccode：

class Seccode:
    captcha_id: str
    lot_number: str
    pass_token: str
    gen_time: str
    captcha_output: str

注册自定义 Solver

对于未内置支持的风险类型，可通过 register_solver 注入自定义求解器：

from wulu_geetest_bypass import Geetest


def solve_icon(imgs: bytes, ques: list[bytes]) -> list[list[int]]: ...


Geetest.register_solver('icon', solve_icon)

注册后 generate_w() 会自动调用，传入对应的 payload 字段：

内置 solver 也可被覆盖：

Geetest.register_solver('slide', my_custom_slide_solver)

异常

免责声明

本项目仅供学习和研究使用。使用者应遵守相关法律法规及平台服务条款， 禁止用于任何非法用途。作者不对因使用本项目产生的任何法律问题承担责任。