/blocklists

A Python script designed to retrieve comprehensive domain status reports from multiple blocklist providers.

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

Blocklists

License: AGPL-3.0-only

A Python script blocklist.py designed to retrieve comprehensive domain status reports from multiple blocklist providers.

usage: blocklist.py [-h] -d DOMAINS

Check domains against all supported blocklist provider APIs.

options:
  -h, --help            show this help message and exit
  -d DOMAINS, --domains DOMAINS
                        comma-separated list of domains to check (e.g., "https://domain1.com,www.domain2.com,app.domain2.com")

Prerequisites

  • Python >=3.6
  • API keys for the blocklist service providers
  1. Clone this repository:
git clone https://github.com/pcaversaccio/blocklists.git
cd blocklists
  1. Create a virtual environment (optional but recommended):
python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`.
  1. Install the required packages:
pip install -r requirements.txt
  1. Create a .env file in the project root and add your API keys for the blocklist service providers:
BLOWFISH_API_KEY="YOUR_BLOWFISH_API_KEY"
CHAINPATROL_API_KEY="YOUR_CHAINPATROL_API_KEY"
SCAMSNIFFER_IDENTIFIER="YOUR_SCAMSNIFFER_IDENTIFIER"
SCAMSNIFFER_API_KEY="YOUR_SCAMSNIFFER_API_KEY"
SEAL_ISAC_API_KEY="YOUR_SEAL_ISAC_API_KEY"

Caution

Make sure to keep your .env file secure and never commit it to version control!

Usage

Run the script using Python:

python scripts/blocklist.py --domains "walietconnect.events,www.kyberswap.org,https://ethena.fi,docs.vyperlang.org/en/stable"

Supported Blocklist Providers