Skip to main content
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
  1. Clone the Miasma Repository
    Obtain the Miasma source code by cloning its GitHub repository to your local machine.
  2. Install Dependencies
    Install all required Python packages using pip. It's recommended to do this in a virtual environment.
  3. Configure the Honeypot
    Edit `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.
  4. Launch Miasma
    Start the Miasma server. By default, it runs on port 8000. Ensure this port is accessible to potential scrapers.
  5. Expose and Monitor
    Integrate 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
Miasma: A tool to trap AI web scrapers in an endless poison pit — Action Pack