Spaces:
Running
Running
File size: 3,212 Bytes
c0caea8 3b6511b c0caea8 dd14242 c0caea8 3b6511b c0caea8 3b6511b c0caea8 5f0cfa7 c0caea8 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 |
---
title: Thinkly Labs SEO
emoji: 🔍
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
license: mit
---
# Thinkly Labs SEO
Professional SEO analysis and reporting tool that creates comprehensive SEO audit reports from any website URL. Built with Flask and designed to be modular and extensible.
## Features
### ✅ Implemented (v1 MVP)
- **Technical SEO Analysis** via Google PageSpeed Insights API
- Mobile & desktop performance scores
- Core Web Vitals (LCP, CLS, INP, FCP)
- Optimization opportunities and diagnostics
- **Content Audit** via web crawling
- Metadata completeness (title, description, H1 tags)
- Content quality metrics (word count, CTA presence)
- Content freshness analysis
- **Professional HTML Reports** with interactive charts
- **PDF Export** functionality
- **Competitor Benchmarking** (basic comparison)
- **Executive Summary** with health scoring
### 🚧 Planned for Future Versions
- Keyword Rankings (Google Search Console integration)
- Backlink Profile Analysis (RapidAPI)
- Advanced Competitor Analysis
- GA4/Conversion Tracking Integration
## Installation
1. Clone the repository
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
streamlit run app.py
```
## Usage
1. Open the Streamlit app in your browser
2. Enter a website URL to analyze
3. Optionally add competitor URLs for benchmarking
4. Click "Generate SEO Report"
5. View the interactive report and download HTML/PDF versions
## API Requirements
- **Google PageSpeed Insights API**: No API key required for basic usage (with rate limits)
- For higher usage limits, get a free API key from Google Cloud Console
## Architecture
The system is built with a modular architecture:
```
app.py # Main Streamlit application
modules/
├── technical_seo.py # PageSpeed Insights integration
└── content_audit.py # Web crawling and content analysis
report_generator.py # HTML report generation with charts
pdf_generator.py # PDF export functionality
```
## Report Structure
1. **Executive Summary** - Overall health score and quick wins
2. **Technical SEO** - Performance metrics and optimization opportunities
3. **Content Audit** - Metadata completeness and content quality
4. **Competitor Analysis** - Basic performance comparison
5. **Future Modules** - Placeholder sections for keywords, backlinks, etc.
6. **Recommendations** - Prioritized action items
## Success Metrics
✅ Report generates without failures for multiple domains
✅ PageSpeed data fetched reliably via Google API
✅ Crawl completes within 200 pages, respecting robots.txt
✅ Charts render correctly in HTML and export cleanly to PDF
✅ Report structure matches defined format
✅ Professional visual design resembling agency decks
## Contributing
The system is designed to be extensible. To add new modules:
1. Create a new module in `modules/` following the existing pattern
2. Update `report_generator.py` to include the new section
3. Add placeholder sections for future enhancements
4. Update the main app to integrate the new module
## License
MIT License - see LICENSE file for details |