This is a big update with many improvements across many places, but also many breaking changes for good reasons. Please read the below before updating
-
For many reasons, we decided that from now on, we will stop using Camoufox entirely, and we might switch back to it in the future if its development continues. If you prefer to continue using Camoufox as before this release, there are instructions for that in this section.
-
Previously, we were using patchright in the stealth mode inside
DynamicFetcherand its session classes. Now we removed the stealth mode from them and started using patchright insideStealthyFetcherand its session classes, with A LOT of improvements, as you will see, improving the stealth overall on top of patchright.
This makes StealthyFetcher and its session classes 101% faster than before, use less memory and space, and have ~400 lines of code shorter, but, most importantly, are more stable than when we used Camoufox before.
This will also shorten the installation time of the scrapling install command, reduce the size of the Docker image, improve test smoothness in GitHub's CI, and make scrapling less confusing for new users.
Breaking changes
- The
stealthargument was removed from theDynamicFetcherclass and its session class, while thehide_canvasargument was moved to theStealthyFetcherand its session classes. - The
disable_webglargument has been moved fromDynamicFetcherto theStealthyFetcherclass and renamed asallow_webgl. All session classes as well. - The
StealthyFetcherclass is now basically the new stealthy version ofDynamicFetcher, so the following arguments are removed:block_images,humanize,addons,os_randomize,disable_ads, andgeoip. I tried to replicate them in Chromium, but each had its own problem. This might change with upcoming releases before v0.4.
Now to the good news, we have improved and fixed a lot of stuff :)
Improvements
- You already know that the
StealthyFetcherclass and its session classes are now 101% faster than before, but now also theDynamicFetcherclass and its session class are 20% faster. - Cloudflare's solver algorithm has been improved over before now to finish faster and handle more cases. Also, thanks to the new refactor, expect the solver to solve the captcha twice as fast!
- All fetchers now use less memory.
- The MCP server now uses fewer tokens to save more money!
- The Docker image is now 60% smaller.
- The whole documentation website has been updated with the new stuff. At the same time, it was made more explicit, many sections were shortened, more examples were added, missing arguments were included, the API reference section was updated with graphs, and many other improvements were made. The Website now loads 130% faster, uses less data, and is better for SEO.
Fixes
- Added the arguments that were missing before in the Web Scraping shell shortcuts and made them more accurate.
- Fixed the issue where the
google_searchargument was creating a Google referrer even if the URL is a localhost/IP.
🙏 Special thanks to our Discord community for all the continuous testing and feedback





