🛠️ Spero Restoration – SEO Master Plan (vFinal)

This repository contains the official and final version of the Spero Restoration web project.
Built entirely from scratch in Flask, this version includes advanced SEO optimization, AI automations, and multilingual support (English, Spanish, Portuguese).

---

🌎 Project Overview

Domain: https://spero-restoration.com
Main Email: contact@spero-restoration.com
Backup Email (BCC): roberto.maffra@gmail.com

---

⚙️ Core Technologies

• Flask 3.0+ – Lightweight Python framework
• Jinja2 Templates – Clean and SEO-friendly HTML
• Flask-Babel – Multilingual support (EN/ES/PT)
• SendGrid API – Contact form and email automation
• HubSpot CRM Integration
• Google GA4 + GTM + Ads + Search Console
• Schema.org + Sitemap + Robots.txt
• AI-Powered Blog + Competitor Scan + GMB Auto-post
• Tawk.to + WhatsApp + Meta + LinkedIn Pixel tracking

---

🧩 Project Structure

---

🚀 Deployment Instructions (Render)

1. Push all project files to GitHub under the repo web-spero.
2. Go to Render.com → New + → Web Service.
3. Connect your GitHub repo.
4. Configure Render:
   • Build Command: pip install -r requirements.txt
   • Start Command: gunicorn app:app
   • Python Version: 3.11
5. Add Environment Variables:
   • Copy from .env.example
6. Click Deploy 🚀

Render will automatically detect Flask and deploy the site publicly.

---

📊 Google & Media Integrations

Tool	Function
Google Analytics 4	Traffic tracking
Google Tag Manager	Centralized scripts
Google Ads	Conversion tracking
Google Search Console	SEO visibility
Schema.org	Local business metadata
Facebook Pixel	Remarketing
LinkedIn Insight Tag	B2B analytics
HubSpot	Lead CRM
SendGrid	Form email delivery
Tawk.to / WhatsApp	Real-time contact

---

🧠 AI Automations

Script	Description
sitemap_ai.py	Builds sitemap dynamically with AI-generated descriptions
blog_ai_generator.py	Creates SEO blog posts automatically
competitor_scan.py	Analyzes local competitors (keywords, pricing)
gmb_auto_post.py	Publishes blog excerpts to Google My Business
optimize_images.py	Converts and compresses images
backup_site.py	Creates daily backups automatically

---

📈 SEO & Performance

• Score target: 95+ in Google PageSpeed
• Core Web Vitals optimized
• Lazy loading + WebP images
• Sitemap + Robots auto-generation

---

🧾 License

© 2025 Spero Restoration Corp – All rights reserved.
Developed and maintained by Roberto Maffra.