Luna is an anti-fingerprinting automation framework designed for web scraping and automated testing, addressing the challenge of browser detection and identification. It targets developers and researchers needing to simulate realistic browser environments that evade anti-bot measures. The primary benefit is enabling sophisticated automation that mimics human browsing behavior, thereby bypassing sophisticated detection mechanisms.

How It Works

Luna combines a custom-built "Luna browser" with an automation framework, similar in concept to tools like Selenium or Playwright. Its core innovation lies in its ability to deeply integrate and manipulate browser fingerprinting attributes. By leveraging the Luna browser, the framework can precisely control and randomize various fingerprinting vectors—such as canvas, WebGL, user agent, timezone, and more—to create highly evasive browser profiles. This approach allows for effective anti-correlation testing and robust scraping against sites employing advanced anti-bot technologies.

Quick Start & Requirements

The primary framework is developed in Go. Installation involves go get -u github.com/musiclover789/luna. A Python version is also available. The project currently supports only Windows x86-64 platforms, with other platforms being insufficiently tested. Running the framework requires a compatible Chromium-based browser executable. Specific fingerprint settings require downloading and using the proprietary Luna browser, available via a Baidu Netdisk link with an extraction code, where most fingerprints are non-functional for unauthorized users.

Highlighted Details

• Supports extensive fingerprint customization, including user agent, canvas, WebGL/WebGPU, platform, timezone, language, screen properties, audio, WebRTC IPs, and more.
• Offers advanced automation features like visual selectors, simulated mouse movement trajectories, keyboard input, and proxy support (HTTP, HTTPS, SOCKS5).
• Capable of simulating both PC and mobile browser environments.
• Claims to bypass mainstream anti-fingerprinting detection, with provided test URLs for verification (e.g., browserscan.net, creepjs.com).

Maintenance & Community

The project is actively developed, with the latest update noted as 2025-7-16. Community support is primarily channeled through a QQ group (ID: 179991677). Specific contributor or sponsorship details are not provided in the README.

Licensing & Compatibility

The README does not explicitly state a software license. The distribution of the "Luna browser" appears to be restricted, with many fingerprints requiring authorization, suggesting potential licensing or commercial use limitations. Compatibility for commercial use or integration into closed-source projects is unclear due to the lack of a defined license and the proprietary nature of the Luna browser.

Limitations & Caveats

The framework is officially supported only on Windows x86-64. Effective anti-fingerprinting requires the use of the custom-built "Luna browser," which is distributed separately and may have licensing or access restrictions affecting fingerprint functionality. Visual-based anti-fingerprinting features depend on the correct directory structure (luna).