se-domain-snapback

SE/NU Domain Snapback Scanner

Lists ALL .se and .nu domains that will be released tonight.

🌐 View Live Results on GitHub Pages

Features

Web Interface

Starting the Web UI

# Install dependencies
pip install -r requirements.txt

# Start the web server
python app.py

The web interface will be available at http://localhost:5000

Web UI Features

Command Line Interface

Basic Usage

# List ALL domains releasing tonight (default)
python src/main.py

# List ALL domains releasing on a specific date
python src/main.py --date 2026-02-10

# Dry run (don't save reports)
python src/main.py --dry-run

# Test the drop list fetch
python src/main.py --test-fetch

How It Works

The scanner performs a simple 2-step process:

  1. Fetch Drop Lists: Retrieves ALL domains releasing on target date from Internetstiftelsen (IIS) API
  2. Generate Reports: Creates CSV and JSON reports in the /reports directory

Configuration

Edit config.py to customize:

GitHub Actions

The scanner runs automatically via GitHub Actions:

GitHub Pages

The results are automatically published to GitHub Pages:

The static site includes:

Output Format

CSV Format

domain,tld,release_date,available,indexed,estimated_pages,index_source,checked_at
example.se,se,2026-02-10,True,False,,,2026-02-09T07:00:00Z

JSON Format

{
  "generated_at": "2026-02-09T07:00:00Z",
  "total_domains": 1,
  "domains": [
    {
      "domain": "example.se",
      "tld": "se",
      "release_date": "2026-02-10",
      "available": true,
      "indexed": false,
      "estimated_pages": null,
      "index_source": null,
      "checked_at": "2026-02-09T07:00:00Z"
    }
  ]
}

Requirements

Installation

# Clone the repository
git clone https://github.com/Caceras/se-domain-snapback.git
cd se-domain-snapback

# Install dependencies
pip install -r requirements.txt

# Run the scanner
python src/main.py

# Or start the web UI
python app.py

License

This project is for educational and research purposes.

API Sources