camoufox README

The project's README from github.com/daijro/camoufox. As one markdown file: README.md.

Camoufox

Camoufox is an open source anti-detect browser built for webscraping & AI agents. 🦊

daijro%2Fcamoufox | Trendshift
Total Downloads Monthly Downloads Weekly Downloads

⚠️ This project is under development. It may not be suitable for stable production use. ⚠️


[!NOTE] All of the latest documentation is available at camoufox.com.


Sponsors

View/Collapse All

Premium

nodemaven NodeMaven: The most efficient proxy provider for Web Scrapping and Automation with the Highest Quality IP on the market.
Why NodeMaven?
• 99.9% uptime
• ZIP Targeting
• IP filtering: all proxies have fraud score <97%
• No KYC required
• Unique free tools: Proxy Bandwidth Checker, Meta Tag Checker, IP Lookup and others!
Special codes for Camoufox users:
• CAMOUFOX35 - 35% off to Mobile and Residential Proxies
• CAMOUFOX40 - 40% off to ISP (Static) Proxies
nodeproxy Need proxies for Camoufox?
Use Node Proxy — a provider of datacenter, residential and mobile proxies offering high speed, security and near-100% uptime. Fully tested and supported in Camoufox.
What sets them apart from other providers
• 90+ IP score
• HTTP + SOCKS5 — multiprotocol support
• Discounts for retail customers
• Full B2B support
• Ethically sourced IP addresses
• Special terms for Enterprise clients
Want to support Camoufox?
Just use my promo code CAMOUFOX — it gets you a 30% discount and supports the developer at the same time.
Get started at node-proxy.com →
layer3 Layer3 Intel | See your proxies the way anti-bots see them
Camoufox hides your browser. Your proxy IP is the part it can't hide. Layer3 Intel is the residential proxy detection engine used to catch proxy traffic — check whether the IPs your provider sells you are clean, or already known and flagged.
• 🔍 Live threat score for any IP
• 🗂️ Proxy pool membership - identify IP resellers
• 📡 70M+ residential, mobile & ISP proxy IPs tracked across 200+ providers
• ⚡ <40ms API responses — vet IPs inline before your scraper uses them
Check your IPs: https://layer3intel.com

Tools & Services

Scrapfly.io Scrapfly is an enterprise-grade solution providing Web Scraping API that aims to simplify the scraping process by managing everything: real browser rendering, rotating proxies, and fingerprints (TLS, HTTP, browser) to bypass all major anti-bots. Scrapfly also unlocks the observability by providing an analytical dashboard and measuring the success rate/block rate in detail.
cloverlabs.ai Clover Labs is a Toronto based venture studio building AI agents for growth and distribution.
color horizontal SerpApi, a web search API to scrape Google and other search engines with a simple API.
color horizontal Web data that survives the anti-bots.
Crawlbase gives developers and AI teams reliable data at scale: a 99% success-rate Crawler, Crawling API, Smart AI Proxies, and Web MCP Server that get through, so your scrapers and agents don't break. You build, we handle the infrastructure.

Get 15% off your first 3 months with code CAMOUFOX → crawlbase.com

scrappey Scrappey is a Web Scraping API that only charges successful scrapes with pay as you go - no subscriptions. Scrape complex sites. Residential proxies included, no hidden proxy fees, or expiring balances. One API for direct HTTP, full-browser rendering, JavaScript-heavy pages, screenshots, sessions, 30+ browser actions and 200+ concurrent sessions at a time - trusted by 1000+ developers and AI agents. Get 10% off with code CAMOUFOX.
Cloro Cloro is a SERP and AI search API. Get structured results from Google, ChatGPT, Perplexity, Gemini, Copilot and Grok.

Proxy Providers

Camoufox is intended to be used with rotating proxies (preferably residential IPs). Check out these providers:

proxyempire 🚀 Camoufox × ProxyEmpire
Running Camoufox? Your proxy layer decides whether you scale — or get blocked.
ProxyEmpire delivers:
• 🌍 30M+ Residential IPs (170+ countries)
• 📱 4G/5G Mobile Proxies
• 🔄 Rotating & Sticky Sessions
• ⚡ Unlimited Concurrent Sessions
• 🎯 Precise geo-targeting
• HTTP, HTTPS & SOCKS5 Support
Built for scraping, automation, and high-stealth workflows.
🔥 Exclusive Offer - Use code Camoufox30
Get 30% recurring discount (not just first month). Upgrade your proxies. Reduce bans. Scale properly
rapidproxy RapidProxy - Power Your Data with Premium Proxies.
🎁 Try proxies for free + Use code RAPID10 for 10% OFF
Why Choose RapidProxy?
• 🌍 90M+ IPs in 200+ countries & regions
• ♾️ No expiration on traffic — use anytime, no pressure
• 🔥 Unlimited concurrency for maximum performance
• 💰 Starting from just $0.65/GB — built for scale
• 📍 City-level targeting for precise geo access
• 🔄 Flexible session control tailored to your needs
Don’t miss out — start your free trial today and experience fast, stable, and scalable proxy performance with RapidProxy.
swiftproxy Swiftproxy - High-Performance Residential Proxies for Scalable Data Collection
Built for developers who need reliable, anti-detection proxy infrastructure. Swiftproxy delivers stable connections, high success rates, and flexible control for large-scale scraping and automation.
• 🌍 195+ locations with ethically sourced residential IPs
• 🔄 Rotating & sticky sessions with precise geo-targeting
• ⚡ Optimized for anti-ban & high success rate
• 🔌 HTTP / HTTPS / SOCKS5 support
• 🧪 Free 500MB trial for testing
• 💸 Special discount code for Camoufox users: PROXY90 - 10%
Best for: Web scraping, automation, multi-accounting, and large-scale data extraction
mangoproxy MangoProxy is a Residential, ISP, Mobile and Datacenter proxy service designed for professional tasks where stability, speed, and anonymity matter.
Use code DAIJRO for 8% OFF ISP Static Proxies
proxidize Proxidize | Mobile and Residential Proxies for Camoufox
Running Camoufox at scale? Your browser setup is only half the stack. Your proxy layer matters too.
Proxidize provides mobile and residential proxies built for scraping, browser automation, SEO monitoring, AI agents, and data collection workflows.
Why Proxidize?
• Real 4G and 5G mobile proxies
• Residential proxies in 195+ countries
• Rotating and sticky sessions
• City-level and carrier targeting
• Unlimited concurrency
• HTTP(S), SOCKS5, and UDP over SOCKS support
• No hardware or DIY setup required
Built for teams that need reliable proxy infrastructure without managing devices, servers, or proxy rotation themselves.
Special offer for Camoufox users: Use code CAMOUFOX20 for 20% off.
Start now: https://proxidize.com
NiuProxy NiuProxy | Rotating Residential Proxies from $0.35/GB
NiuProxy provides residential, ISP, mobile, and datacenter proxies for scraping, browser automation, SEO, AI agents, and data collection.
Why NiuProxy?
• Residential proxies from $0.35/GB
• ISP proxies from $3/IP
• Mobile proxies from $1.5/GB
• Datacenter proxies from $0.5/GB
• HTTP(S) & SOCKS5 support
• Flexible geo targeting and sessions
• Alipay, USDT, cards, Google Pay & Apple Pay
Special offer for Camoufox users: Use code PAY2 for 10% off your recharge.
Start now: https://niuproxy.com
Thordata 🔍 Camoufox × Thordata
Real Residential IPs for Smarter AI Agents & Automation
With 100M+ residential IPs, Thordata helps your scraper access the web through real user IPs across 195+ countries.
Target specific locations with precision — including city, ISP, and ASN-level targeting — so your Camoufox automation runs with a more authentic network identity.
• 🔄 Rotating & Sticky Sessions (up to 90 minutes)
• ⚡ 99.99% uptime with unlimited concurrent sessions
• 🌍 Global residential coverage for AI agents, scraping, and automation workflows
🎁 Exclusive for Camoufox users:
Get free trial traffic after signup + use code Camoufox for 10% OFF.
Start your free trial with Thordata
Webshare Webshare gives you instant access to a proxy pool of 80M+ ethically-sourced IPs across 195+ countries, with rotating residential, static ISP, and datacenter options plus a full API. It includes a 100+ Gbps backbone, country/city/state/ZIP/ASN-level targeting, and requires no credit card to start.
🏷️ Get 20% OFF your first purchase with promo code CAMOUFOX20
Roamproxy Roam — Residential & static residential proxies, pay-as-you-go per GB. Use code CAMOUFOX15 for 15% extra credit on your first top-up.

Introduction

Camoufox is a Firefox fork engineered for web scraping and AI agents. It is headless, undetectable, and optimized to run at scale. Every run gets a fresh identity drawn from the real-world distribution of devices, so it blends into normal traffic instead of standing out.

Highlights

camoufox (daijro/camoufox)

Searching Database…

12.6K ·GitHub
这是什么?Camoufox 是一款开源的反检测浏览器,基于 Firefox 分支开发,专为网页抓取和 AI 智能体设计,能够让反爬虫系统无法识别。
这是一个独立的浏览器应用,还是需要我通过代码来控制的工具?它是一个经过修改的 Firefox,需要用程序来操控。Camoufox 提供 Python 接口,并可直接兼容 Playwright,因此编写脚本的方式与普通 Playwright 浏览器完全相同。
在抓取项目中,我该如何开始使用它?完整的安装和使用说明,包括 Python/Playwright API 的内容,都放在专门的文档网站上,而不是完全写在 README 中。
使用它之前,我是否需要先配置好 Playwright?由于 Camoufox 是通过兼容 Playwright 的 Python 接口,作为直接替换的方案接入的,因此需要你已经准备好 Python 环境,以及可以指向它的 Playwright 风格自动化代码。
Camoufox 是否稳定到可以用于生产环境的抓取?按维护者自己的说法,目前还不够:项目仍在积极开发中,可能并不适合稳定的生产环境使用。
我可以在本地和云端运行我的智能体集群吗?可以,无论你把自动化集群部署在自己的机器上,还是部署在云基础设施中,Camoufox 都能保持不被识别。
为什么每次运行 Camoufox 看起来都不一样?每次启动都会根据真实设备的实际分布生成一个全新的设备标识,因此它能融入正常流量,而不会重复使用固定、容易辨认的指纹。
使用 Camoufox 之后,我还需要代理吗?需要。Camoufox 应当搭配轮换代理使用,最好是住宅 IP,因为隐藏浏览器指纹并不能掩盖已被标记或共享的代理 IP。
Camoufox 和其他大多数反检测浏览器一样,是基于 Chromium 的吗?不是。它是 Firefox 的精简版分支,而不是基于 Chromium,这样选择是为了让它启动快,并且在大规模运行时成本更低。
我现有的 Playwright 抓取脚本能继续使用吗?基本可以。Camoufox 宣传通过其 Python 接口直接兼容 Playwright,这意味着现有基于 Playwright 的抓取代码只需极少改动,就能指向它。
Creator
daijro
Size
625.2 MB
Stars
12.6K
Age
2y
Commits · 90 Days