Disavow-Generator

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

Disavow-Generator

★ 9 Open GitHub ↗

Negative SEO protection web app with automated, hierarchical and historical Google Search Console disavow generation and granular link-level control

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Disavow Generator</h1>

Negative SEO protection web app with automated, hierarchical and historical Google Search Console disavow generation and granular link-level control.

---

## Features

- **Automated Disavow Generation** - Upload backlink exports and generate Google Search Console disavow files
- **Smart Categorization** - Automatically categorizes entries as IPs, domains, or specific URLs
- **Historical Tracking** - Tracks previously disavowed entries to highlight new threats
- **Whitelist Management** - Maintain a whitelist of legitimate domains to exclude from disavow
- **New Entries Review** - Review new domains/IPs before blocking with option to whitelist
- **Multi-format Support** - Import from Excel (.xlsx, .xls), CSV, and TXT files
- **Production Ready** - Multi-worker support with Hypercorn ASGI server
- **Docker Support** - Easy deployment with Docker and docker-compose

---

![Processing](https://raw.githubusercontent.com/BansheeTech/Disavow-Generator/refs/heads/main/ui/img/Processing.png)
![Whitelist](https://raw.githubusercontent.com/BansheeTech/Disavow-Generator/refs/heads/main/ui/img/Whitelist.png)
![Historic](https://raw.githubusercontent.com/BansheeTech/Disavow-Generator/refs/heads/main/ui/img/Historic.png)

## Quick Start with Docker

```bash
# Clone the repository
git clone https://github.com/BansheeTech/Disavow-Generator.git

# Bring up the container
docker compose up -d

# Access
open http://localhost:44444
```

**Default credentials:** `user` / `passwd`

> Change the default credentials immediately after first login via Settings.

---

## Manual Installation

### Requirements

- Python 3.11+
- pip

### Setup

```bash
# Clone the repository
git clone https://github.com/BansheeTech/Disavow-Generator.git
cd Disavow-Generator

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py
```

The app will start on `http://localhost:44444`

---

## Setup on HomeDock OS

Download [HomeDock OS](https://github.com/BansheeTech/HomeDockOS) and install it from the App Store.

---

## Configuration

Configuration is stored in `conf/disavow.conf` (auto-generated on first run):

```ini
[server]
port = 44444
mode = production
workers = 4
secret_key = <auto-generated>

[paths]
input_dir = __DISAVOW_DATA__/INGEST
output_dir = __DISAVOW_DATA__/OUTPUT
whitelist_file = __DISAVOW_DATA__/whitelist.txt

[auth]
username = user
password_hash = <bcrypt-hash>
```

### Configuration Options

| Option    | Description                   | Default      |
| --------- | ----------------------------- | ------------ |
| `port`    | Server port                   | `44444`      |
| `mode`    | `production` or `development` | `production` |
| `workers` | Number of worker processes    | `4`          |

---

## Usage

### 1. Upload Backlink Data

Upload backlink exports from tools like Ahrefs, SEMrush, Majestic, or any CSV/Excel file containing URLs.

### 2. Manage Whitelist

Add legitimate domains to the whitelist to prevent them from being included in the disavow file.

### 3. Generate Disavow File

Click "Generate Disavow File" to process all uploaded files. New domains/IPs will be highlighted for review.

### 4. Download & Upload to Google

Download the generated disavow file and upload it to [Google Search Console Disavow Tool](https://search.google.com/search-console/disavow-links).

---

## Docker Volumes

| Volume | Container Path          | Description                          |
| ------ | ----------------------- | ------------------------------------ |
| Config | `/app/conf`             | Configuration file (disavow.conf)    |
| Data   | `/app/__DISAVOW_DATA__` | Input files, output files, whitelist |

Example docker-compose.yml:

```yaml
services:
  disavow-generator:
    image: bansheetech/disavow-generator:latest
    container_name: disavow-generator
    restart: unless-stopped
    ports:
      - "44444:44444"
    volumes:
      - ./disavow_data:/app/__DISAVOW_DATA__
      - ./disavow_conf:/app/conf
    environment:
      - TZ=Europe/Madrid
```

---

## API Endpoints

| Method | Endpoint | Description |
| ------ | -------------------------- | ---------------------- |
| `POST` | `/api/upload` | Upload input file |
| `POST` | `/api/process` | Generate disavow file |
| `GET` | `/api/stats` | Get current statistics |
| `GET` | `/api/whitelist` | Get whitelist |
| `POST` | `/api/whitelist` | Update whitelist |
| `GET` | `/api/files` | List input files |
| `GET` | `/api/outputs` | List generated files |
| `GET` | `/api/download/<filename>` | Download disavow file |

---

## Tech Stack

- **Backend:** Python 3.11, Flask 3.1, Hypercorn (ASGI)
- **Frontend:** Vue.js 3, Tailwind CSS
- **Auth:** Flask-Login, bcrypt
- **Data:** pandas, openpyxl

---

## License

This project is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0)**.

See [LICENSE.md](LICENSE.md) for the full license text.

---

## Author

**Banshee** - [https://www.banshee.pro](https://www.banshee.pro)

---

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disavow-Generator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README