invisible_puppeteer

改一行 import,pyppeteer 脚本直接跑在隐身 Firefox 上

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 82 👀 关注 4
GitHub ↗
GitHub 星标 ★ 155
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无在线服务

项目预览

invisible_puppeteer 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队oss-invisible
定价模式🏷️完全免费
价格说明开源免费,无在线服务
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型anti-bot,anti-detect,anti-detect-browser,antidetect,antidetect-browser,automation,bot-detection,browser-automation,fingerprint,firefox,headless-browser,puppeteer,pyppeteer,python,scraping,stealth,stealth-browser,web-automation,web-scraping,webscraping
GitHub 星标★ 155
上线时间2024-09-01 00:00:00
代码更新2026-11-12
仓库体积12.2 MB
本站数据更新2026-11-17
维护状态活跃
收录时间2026-10-03
浏览次数3

项目介绍

invisible_puppeteer 是一个基于 Python 的浏览器自动化库,它把 pyppeteer 的 API 移植到经过补丁的 Firefox 上,并内置确定性的隐身(stealth)配置。它解决的核心问题是:使用 pyppeteer 或 Puppeteer 驱动 Chromium 时,浏览器指纹容易被反爬系统识别,导致脚本被拦截或封禁。该项目让你几乎不用改代码,只需把 import 从 pyppeteer 换成 invisible_puppeteer,就能在打过补丁的 Firefox 上运行原有脚本,同时获得更接近真实用户的指纹特征。核心能力包括:兼容 pyppeteer 的页面操作、导航、截图、表单填写等接口;提供确定性的 stealth profile,减少随机指纹带来的不稳定;基于 Firefox 而非 Chromium,降低被针对性检测的概率。适合需要稳定抓取或自动化操作、又不想重写整套脚本的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-03 · 当前星标 ★ 155

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 4 步

环境要求

  • Python 3.11 或更高版本
  • 操作系统:Windows x86_64 / ARM64,或 Linux x86_64 / arm64
  • 需要能联网下载补丁版 Firefox(首次一次性下载)
  • 不要与 pyppeteer 同时安装,本包已实现其 API

安装与启动步骤

  1. 1安装库

    使用 pip 安装 invisible-puppeteer,建议在虚拟环境中进行,避免与旧依赖冲突。

    pip install invisible-puppeteer
  2. 2下载补丁版Firefox

    首次使用需执行一次该命令下载打过补丁的 Firefox 引擎,下载后会做 sha256 校验。

    python -m invisible_puppeteer fetch
  3. 3改写导入语句

    把原有基于 pyppeteer 的脚本中的 launch 导入改为从 invisible_puppeteer 导入,其余代码不用改。

    from invisible_puppeteer import launch
  4. 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

下一篇:invisible_selenium

同类项目推荐

Vibe-Workflow 开源

拖拽节点,快速搭建 AI 图像视频生成流水线

Free, open-source alternative to Weavy AI, Krea Nodes, Freepik Spaces & FloraFauna A···

★ 646 2026-08-09
cc-connect 开源

在聊天软件里远程指挥本地 AI 写代码

Bridge local AI coding agents (Claude Code, Cursor, Gemini CLI, Codex) to messaging ···

★ 16410 2026-10-16
n8n-autoscaling 开源

n8n 队列模式自动扩缩 worker,高峰不排队、闲时不浪费

n8n queue mode build with automatic worker scaling and puppeteer

★ 740 2026-09-20
simprint 开源

开源指纹浏览器,多开隔离防关联

[指纹浏览器] Simprint is an open-source fingerprint browser and programmable browser···

★ 693 2026-10-07
BrowserPilot 开源

一句话让浏览器替你干活,自动研究、抓取、操作网页。

Open‑source alternative to Perplexity Comet, director.ai and firecrawl combined

★ 180 2026-08-09
webbrain 开源

用大白话指挥浏览器干活,自动填表、抓数据、点按钮

Open-source AI browser agent for Chrome and Firefox (monorepo)

★ 1719 2026-08-09
JevRev 开源

给 LLM 装上工作流脊柱,多步任务自动跑完

An LLM + Jev workflow that changes EVERYTHING. Boost your vertebrate brain with a sp···

★ 452 2026-10-04
surf 开源

让 Go 请求伪装成真实浏览器,绕过反爬检测

SURF - Advanced Go HTTP client with Chrome/Firefox browser impersonation, HTTP/3 wit···

★ 1853 2026-10-08
fynt 开源

自托管工作流引擎,把重复操作串成自动流程

Self-hostable workflow automation platform

★ 467 2026-09-17