
invisible_puppeteer
改一行 import,pyppeteer 脚本直接跑在隐身 Firefox 上
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-03 · 当前星标 ★ 155
使用教程
环境要求
- Python 3.11 或更高版本
- 操作系统:Windows x86_64 / ARM64,或 Linux x86_64 / arm64
- 需要能联网下载补丁版 Firefox(首次一次性下载)
- 不要与 pyppeteer 同时安装,本包已实现其 API
安装与启动步骤
-
1安装库
使用 pip 安装 invisible-puppeteer,建议在虚拟环境中进行,避免与旧依赖冲突。
pip install invisible-puppeteer -
2下载补丁版Firefox
首次使用需执行一次该命令下载打过补丁的 Firefox 引擎,下载后会做 sha256 校验。
python -m invisible_puppeteer fetch -
3改写导入语句
把原有基于 pyppeteer 的脚本中的 launch 导入改为从 invisible_puppeteer 导入,其余代码不用改。
from invisible_puppeteer import launch -
4运行示例脚本
编写并运行一个最小脚本:启动浏览器、打开页面、点击链接,并打印 seed 以便复现本次运行。
import asyncio from invisible_puppeteer import launch async def main(): browser = await launch() page = await browser.newPage() await page.goto("https://example.com") await page.click("a") print("seed =", browser.seed) await browser.close() asyncio.run(main())
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
browser.seed | 否 | 每次会话的指纹种子,记录后可用于复现同一次运行 | print("seed =", browser.seed) |
如何确认成功
脚本能正常启动浏览器、打开 https://example.com 并点击链接,且成功打印出 seed 值,即表示部署成功。
常见问题
Q:装完之后还需要手动配置浏览器吗?
A:不需要。执行 python -m invisible_puppeteer fetch 会自动一次性下载打好补丁的 Firefox 并做 sha256 校验。
Q:我的旧 pyppeteer 脚本要改多少代码?
A:几乎不用改,只需要把 from pyppeteer import launch 换成 from invisible_puppeteer import launch,launch、Browser、Page、ElementHandle 等 API 保持一致。
Q:可以同时安装 pyppeteer 吗?
A:不可以。README 明确说明本包已实现 pyppeteer 的 API,不要与它一起安装。
Q:运行结果如何复现?
A:每次会话都会生成独立指纹,把 browser.seed 打印并记录下来,之后可用它复现同一次运行。
注意事项
- 要求 Python 3.11 及以上版本,低版本无法运行。
- 支持的平台为 Windows x86_64 / ARM64(x86_64 引擎运行在 Windows 自带模拟层下)和 Linux x86_64 / arm64。
- 首次必须执行 python -m invisible_puppeteer fetch 下载补丁版 Firefox,否则无法启动浏览器。
- 不要同时安装 pyppeteer,避免 API 冲突。
核心亮点
- API 与 pyppeteer 高度兼容,迁移成本极低,基本只需改 import
- 基于补丁版 Firefox 并内置确定性 stealth profile,指纹比默认 Chromium 更不易被识别
- 语言为 Python,与现有爬虫和自动化脚本生态无缝衔接
不足之处
- 项目星标仅 202,属于早期阶段,长期维护和更新频率待观察
- 依赖补丁版 Firefox,安装和环境配置可能比标准 pyppeteer 更复杂
适用场景
- 需要绕过反爬检测的网页数据采集
- 自动化表单填写与页面操作测试
- 对浏览器指纹有要求的登录态维持与任务自动化
替代项目
playwright、puppeteer
上一篇:agent-cli
同类项目推荐
Vibe-Workflow
开源
拖拽节点,快速搭建 AI 图像视频生成流水线
Free, open-source alternative to Weavy AI, Krea Nodes, Freepik Spaces & FloraFauna A···
cc-connect
开源
在聊天软件里远程指挥本地 AI 写代码
Bridge local AI coding agents (Claude Code, Cursor, Gemini CLI, Codex) to messaging ···
n8n-autoscaling
开源
n8n 队列模式自动扩缩 worker,高峰不排队、闲时不浪费
n8n queue mode build with automatic worker scaling and puppeteer
simprint
开源
开源指纹浏览器,多开隔离防关联
[指纹浏览器] Simprint is an open-source fingerprint browser and programmable browser···
BrowserPilot
开源
一句话让浏览器替你干活,自动研究、抓取、操作网页。
Open‑source alternative to Perplexity Comet, director.ai and firecrawl combined
webbrain
开源
用大白话指挥浏览器干活,自动填表、抓数据、点按钮
Open-source AI browser agent for Chrome and Firefox (monorepo)
JevRev
开源
给 LLM 装上工作流脊柱,多步任务自动跑完
An LLM + Jev workflow that changes EVERYTHING. Boost your vertebrate brain with a sp···
surf
开源
让 Go 请求伪装成真实浏览器,绕过反爬检测
SURF - Advanced Go HTTP client with Chrome/Firefox browser impersonation, HTTP/3 wit···
fynt
开源
自托管工作流引擎,把重复操作串成自动流程
Self-hostable workflow automation platform