Spaces:
Running
Running
| 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 |