Repo·github.com
ai-agentssecurityweb-developmentautomationinfrastructuremiasma
Miasma: A tool to trap AI web scrapers in an endless poison pit
Deploy Miasma to create an 'endless poison pit' for AI web scrapers. This tool detects and traps AI agents, consuming their resources and preventing unauthorized data extraction, thus protecting your intellectual property and server bandwidth.
intermediate30 min5 steps
The play
- Clone the Miasma RepositoryObtain the Miasma source code by cloning its GitHub repository to your local machine.
- Install DependenciesInstall all required Python packages using pip. It's recommended to do this in a virtual environment.
- Configure the HoneypotEdit `config.py` to customize the honeypot's behavior. Adjust parameters like `HONEYPOT_WORD_COUNT`, `HONEYPOT_LINK_COUNT`, and `HONEYPOT_DEPTH` to control the deceptive content generated. Consider setting `HONEYPOT_MIN_DELAY` and `HONEYPOT_MAX_DELAY` to simulate realistic page load times.
- Launch MiasmaStart the Miasma server. By default, it runs on port 8000. Ensure this port is accessible to potential scrapers.
- Expose and MonitorIntegrate Miasma into your web infrastructure (e.g., as a subdomain or specific path) to expose it to AI scrapers. Monitor its logs for activity and trapped agents.
Starter code
git clone https://github.com/austin-weeks/miasma.git cd miasma pip install -r requirements.txt # Edit config.py for your desired honeypot settings python main.py
Source