ssec-seo

ssec-seo - SEO Scanner by ssecgroup

The most advanced open-source SEO scanner - 100% FREE forever
See what others miss. Find exposed data, subdomains, SSL issues, and more.

---

Features

Category	Capabilities
Deep Crawling	1000+ pages, redirect tracking, robots.txt respect
Exposed Data	Finds .git, .env, backups, config files, admin panels
Subdomains	Certificate logs + DNS brute force (1000+ subdomains)
SSL/TLS	Expiry alerts, protocol support, vulnerabilities
Security	HTTP headers, misconfigurations, directory listing
Dead Links	Full redirect chain analysis, broken link detection
Reports	Beautiful HTML with charts, one-click PDF export
Free Cloud	GitHub Actions integration - scan without installation

---

Quick Start

Install via pip

pip install ssec-seo

Scan any website

ssec-seo scan https://example.com

Quick info

ssec-seo quick https://google.com

---

Example Report

When you run a scan, ssec-seo generates a beautiful HTML report with:

• Executive summary with scores
• Interactive severity charts
• Critical issues highlighted
• Exposed data tables
• Discovered subdomains
• SSL certificate details
• Actionable recommendations

View Sample Report

---

Advanced Usage

Scan with custom options

ssec-seo scan https://example.com --max-pages 500 --concurrent 50 --output report.html

Batch scan multiple URLs

# Create urls.txt with one URL per line
echo "https://site1.com" > urls.txt
echo "https://site2.com" >> urls.txt

# Run batch scan (uses GitHub Actions)

Configuration file

ssec-seo configure  # Creates ssec-seo_config.json
ssec-seo load ssec-seo_config.json

---

GitHub Actions (Free Cloud Scanning)

ssec-seo includes ready-to-use GitHub Actions workflows:

Manual scan

1. Go to Actions tab
2. Select ssec-seo
3. Enter URL and click Run workflow
4. Download report from artifacts

Scheduled scans

# Automatic weekly scans
schedule:
  - cron: '0 0 * * 0'  # Every Sunday

Batch scanning

Scan 100+ websites automatically using the matrix workflow.

---

What ssec-seo Finds

Severity	What We Detect
🔴 Critical	Exposed .git, .env, database backups, AWS keys
🟠 High	Admin panels, phpinfo, directory listing, missing security headers
🟡 Medium	SSL expiry <30 days, too many redirects, missing meta tags
🔵 Low	Server info exposure, missing alt text, old file versions

---

Installation on Different Platforms

Linux / macOS

git clone https://github.com/ssecgroup/ssec-seo.git
cd ssec-seo
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .
ssec-seo --help

Windows

git clone https://github.com/ssecgroup/ssec-seo.git
cd ssec-seo
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
pip install -e .
ssec-seo --help

Docker

docker run --rm ssecgroup/ssec-seo scan https://example.com

---

Running Tests

# Unit tests
pytest tests/

# Test specific scanner
pytest tests/test_scanners/test_ssl_scanner.py

# Test with coverage
pytest --cov=ssec-seo tests/

---

Contributing

We welcome contributions! Here’s how you can help:

1. Report bugs - Open an issue
2. Suggest features - Start a discussion
3. Fix issues - Submit a PR
4. Improve docs - Update README or wiki
5. Translate - Add language support

See CONTRIBUTING.md for details.

---

💖 Donate

ssec-seo is completely free and always will be.
If you find it valuable, consider supporting development:

Ethereum: 0x8242f0f25c5445F7822e80d3C9615e57586c6639

Your donations help:

• Add new features
• Fix bugs faster
• Improve documentation
• Keep free cloud scanning alive

---

Roadmap

• Core crawling engine
• SSL/TLS scanning
• Subdomain discovery
• Exposed data detection
• Beautiful HTML reports
• Historical tracking
• Competitor analysis
• WordPress plugin
• Browser extension
• API marketplace

---

License

MIT License - use it anywhere!
Copyright (c) 2026 ssecgroup

---

⭐ Support Us

If you like ssec-seo:

• ⭐ Star this repository
• 🐦 Share on Twitter
• 👥 Tell your friends
• 💖 Donate to support development

---

Made with ❤️ by ssecgroup
Open source. Always free. Forever.