---
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