WebU

Web Utils for browsing and scraping.

Install

pip install webu --upgrade

默认安装现在只包含最基础的运行依赖：requests 和 tclogger。 浏览器自动化、FastAPI 服务、面板、代理池、验证码识别、MongoDB、Hugging Face 等重依赖都拆到了可选 extras 里，按需安装即可。

Common Installs

基础能力，适合 LLMClient、GeminiClient 这类纯 HTTP 客户端：

pip install -U webu

HTML / 搜索结果解析，适合 webu.google_api.parser、webu.gemini.parser：

pip install -U "webu[parsing]"

DrissionPage 浏览器能力，适合 webu.browsers.chrome 和 webu.searches.*：

pip install -U "webu[browser]"

嵌入向量客户端，适合 webu.embed：

pip install -U "webu[embed]"

CAPTCHA 自动解题，适合 webu.captcha：

pip install -U "webu[captcha]"
playwright install chromium

Service Installs

Google Search API 服务 ggsc：

pip install -U "webu[google-api]"
playwright install chromium

如果还需要内置 Dash 面板：

pip install -U "webu[google-api,google-api-panel]"
playwright install chromium

如果需要自动处理 reCAPTCHA 图片题，再额外加上 captcha：

pip install -U "webu[google-api,captcha]"
playwright install chromium

Google Docker / HF Spaces 工具 ggdk：

pip install -U "webu[google-docker]"
playwright install chromium

如果还需要内置 Dash 面板：

pip install -U "webu[google-docker,google-docker-panel]"
playwright install chromium

Google Hub 调度服务 gghb：

pip install -U "webu[google-hub]"

如果还需要内置 Dash 面板：

pip install -U "webu[google-hub,google-hub-panel]"

Gemini 浏览器服务端能力：

pip install -U "webu[gemini]"
playwright install chromium

Proxy API 服务 pxsc：

pip install -U "webu[proxy-api]"

WARP API 服务 cfwp：

pip install -U "webu[warp-api]"

Cloudflare Tunnel 工具 cftn：

pip install -U "webu[cf-tunnel]"

IPv6 相关能力：

pip install -U "webu[ipv6]"

安装全部功能：

pip install -U "webu[all]"
playwright install chromium

Extra Summary

Combining Extras

可以一次安装多个功能组：

pip install -U "webu[google-api,google-api-panel,captcha,google-hub]"

Notes

• playwright 只是 Python 包；首次使用浏览器相关功能后，仍需执行 playwright install chromium。
• google-api / google-hub / google-docker 现在即使未安装 Dash 也能启动服务，只是不会挂载 panel。
• import webu 和若干子包入口现在采用惰性导入，不会再因为未安装某个可选依赖就把整个包导入失败。
• 如果只需要某个轻量子模块，尽量直接安装对应 extra，不要默认使用 webu[all]。