MIT-licensed. It does not collect off-site backlinks.
Requirements
| Tool | Version |
|---|---|
| Python | 3.11+ |
| Node.js | 20+ |
| Docker | optional |
No Redis, Postgres, or external APIs. Data lives in a local SQLite file.
Clone and run locally
git clone https://github.com/stivmartinez/SEO-Screaming-Linkbuilding.git
cd SEO-Screaming-Linkbuilding
Backend (port 8000)
cd backend
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
Frontend (port 5173)
cd frontend
npm install
npm run dev
Open http://localhost:5173. Start a crawl with a seed URL you own.
Health check: http://127.0.0.1:8000/api/health
Docker
docker compose up --build
Open http://localhost:8000. Crawl data is stored in the crawler-data volume.
Install desktop
Pre-built Mac and Windows binaries are not published as downloads yet. Build from source with the desktop scripts.
Run from source (dev machine)
chmod +x scripts/run-desktop.sh
./scripts/run-desktop.sh
Build an installable app
chmod +x scripts/build-desktop.sh
./scripts/build-desktop.sh
- macOS:
dist/SEO Screaming Link Building.app - Windows / Linux:
dist/SEOScreamingLinkBuilding/
Gatekeeper / SmartScreen may warn until you code-sign the binary. The API has no authentication — the desktop app binds to localhost only on purpose.