BoostSEO - Interface Web avec Déploiement Vercel

Version: 2.1.0 Dossier: C:\Users\steph\CLAUDE CODE\boostseo

---

📋 Vue d'ensemble

Application web complète pour l'analyse SEO :

• Interface moderne avec Bootstrap 5
• Formulaire d'analyse (domaine, position min/max, volume min)
• Affichage des résultats avec badges de couleur
• Export CSV (compatible Excel)
• Export JSON
• Intégration Claude Code MCP pour les vraies données Haloscan
• Déploiement sur Vercel

---

🚀 Installation et Déploiement

Option A: Déploiement Simple (Recommandé)

1. Ouvrir PowerShell ou CMD et aller dans le dossier :

   cd "C:\Users\steph\CLAUDE CODE\boostseo"

2. Executer Vercel :

   vercel

3. Suivre les instructions :

   • Connectez-vous ou créez un compte Vercel
   • Sélectionnez "Link to existing project" → Non
   • Nom du projet : boostseo (doit être en minuscules)
   • Dossier du code : sélectionner C:\Users\steph\CLAUDE CODE\boostseo
   • Framework preset : Python
   • Déployer

4. Votre URL sera : https://boostseo-xxxxx.vercel.app

---

Option B: Déploiement avec Script

1. Préparer les fichiers :

   • Assurez-vous que le dossier boostseo existe et contient les fichiers
   • Vérifiez que .env.example contient les bonnes valeurs

2. Executer le script (depuis PowerShell) :

   cd "C:\Users\steph\CLAUDE CODE\boostseo"
   python -c "

import subprocess import sys

Commandes Vercel

commands = [ 'vercel link', 'vercel env add HALOSCAN_API_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjo4MDMsImRhdGUiOjE3NjYxMjAzNDIsImlhdCI6MTc2NjEyMDU4NiwiZXhwIjoyMDgxNjk2NTg2fQ.2sSE002XTWPYUWrYP6ZxVtLOaDkT7hWb-HBeOp-EM0E', 'vercel env add HALOSCAN_API_URL=https://api.haloscan.io', 'vercel env add BOOSTSEO_MIN_POSITION=9', 'vercel env add BOOSTSEO_MAX_POSITION=20', 'vercel env add BOOSTSEO_MIN_VOLUME=500', 'vercel deploy' ]

for cmd in commands: result = subprocess.run(cmd, shell=True, capture_output=True, text=True) print(result.stdout) if result.stderr: print(result.stderr, file=sys.stderr) if result.returncode != 0: break " "

---

## 📱 Utilisation de l'Application

### 1. Lancer une analyse (avec données simulées)

1. Ouvrir l'URL Vercel
2. Entrer un domaine (ex: `quefairedemondechet.fr`)
3. Ajuster les filtres si nécessaire
4. Cliquer sur **"Analyser"**

### 2. Analyser avec les vraies données Haloscan (via Claude Code)

L'application a deux méthodes :

**Méthode A** : `/api/analyze` (données simulées)
- Utile des données de test

**Méthode B** : `/api/analyze_with_mcp` (vraies données)
- Doit recevoir les données Haloscan depuis Claude Code

**Workflow complet** :

1. Ouvrir l'URL Vercel de l'application
2. Dans Claude Code, exécuter :

from boostseo.app_mcp import BoostSEOMCPClaude

analyzer = BoostSEOMCPClaude()

3. Dans Claude Code, appeler l'API Haloscan :

mcp__haloscan__get_domains_positions input="quefairedemondechet.fr" mode="root" position_min=9 position_max=20 volume_min=500

4. Dans Claude Code, traiter et envoyer à l'app :

haloscan_data = {...} # Les résultats de l'étape 3 analyzer.process_haloscan_results(haloscan_data, "quefairedemondechet.fr")

5. Sur l'interface web, le bouton **"Ajouter les backlinks"** peut être utilisé pour ajouter les backlinks GSC

---

## 📊 Structure du Projet

boostseo/ ├── app.py # Application Flask principale ├── templates/ │ └── index.html # Interface web Bootstrap 5 ├── static/ # Fichiers statiques │ ├── css/ │ └── js/ ├── Procfile # Configuration Gunicorn ├── vercel.json # Configuration Vercel ├── requirements.txt # Dépendances Python ├── .env.example # Template configuration └── .gitignore # Fichiers ignorés

---

## 🔧 Configuration

Les variables d'environnement sont configurées dans `vercel.json` :

| Variable | Valeur | Description |
|----------|--------|-------------|
| `HALOSCAN_API_KEY` | eyJhbGci... | Clé API Haloscan (intégrée) |
| `HALOSCAN_API_URL` | https://api.haloscan.io | URL API Haloscan |
| `BOOSTSEO_MIN_POSITION` | 9 | Position minimum par défaut |
| `BOOSTSEO_MAX_POSITION` | 20 | Position maximum par défaut |
| `BOOSTSEO_MIN_VOLUME` | 500 | Volume minimum par défaut |
| `PORT` | 5000 | Port du serveur |

---

## 📤 API Endpoints

| Endpoint | Méthode | Description |
|----------|----------|-------------|
| `/` | GET | Page d'accueil (interface) |
| `/api/analyze` | POST | Analyse avec données simulées |
| `/api/analyze_with_mcp` | POST | Analyse avec vraies données MCP |
| `/api/add-backlinks` | POST | Ajouter les backlinks GSC |
| `/api/export/csv` | GET | Export en CSV |
| `/api/export/json` | GET | Export en JSON |
| `/api/config` | GET | Configuration actuelle |
| `/health` | GET | Health check |

---

## 🎨 Personnalisation

### Changer les couleurs

Éditer `templates/index.html` et modifier les variables CSS dans `:root` :

```css
:root {
    --primary-color: #4f46e5;  /* Couleur principale */
    --success-color: #22c55e;  /* Couleur succès */
}

Modifier les filtres par défaut

Modifier vercel.json :

"env": {
    "BOOSTSEO_MIN_POSITION": "5",
    "BOOSTSEO_MAX_POSITION": "30",
    "BOOSTSEO_MIN_VOLUME": "1000"
}

---

🐛 Résolution de Problèmes

Erreur : "Domaine invalide"

Le domaine doit contenir un point (ex: campings.com et non campings).

Erreur : "Aucune analyse à exporter"

Lancez d'abord une analyse avant d'exporter.

Erreur lors du déploiement

1. Vérifiez que le dossier boostseo existe
2. Assurez-vous que les fichiers sont dans le dossier racine
3. Utilisez vercel link --cwd "C:\Users\steph\CLAUDE CODE\boostseo"

---

📝 Données de Test Intégrées

L'application inclut des données de test pour 20 mots-clés :

• est ce que le polystyrène se recycle (pos 9, vol 500)
• dons jouets (pos 9, vol 880)
• revendre ordinateur portable (pos 9, vol 1300)
• ... et 17 autres mots-clés

Ces données sont retournées par l'endpoint /api/analyze.

Pour utiliser les vraies données Haloscan, utilisez /api/analyze_with_mcp en envoyant les données depuis Claude Code.

---

📄 Scripts Claude Code Utiles

Script pour exécuter l'analyse complète

Depuis Claude Code, vous pouvez créer et exécuter ce script :

# Importer l'application
from boostseo.app_mcp import BoostSEOMCPClaude

# Créer l'analyseur
analyzer = BoostSEOMCPClaude()

# Récupérer les données Haloscan (via MCP)
# 1. Claude Code exécute: mcp__haloscan__get_domains_positions(...)
# 2. Puis vous donnez les résultats

# Traiter les résultats
# analyzer.process_haloscan_results(haloscan_data, "quefairedemondechet.fr")

# Afficher le résumé
# analyzer.print_summary(report)

Ajouter les backlinks GSC

Après l'analyse, pour chaque mot-clé trouvé :

1. Dans Claude Code : mcp__gsc__index_inspect pour l'URL
2. Si la page a des backlinks, les récupérer
3. Envoyer à l'application : POST /api/add-backlinks

Exemple JSON à envoyer :

{
  "backlinks": {
    "https://blog.quefairedemondechet.fr/article/conteneur-a-vetements": [
      "https://www.bretagnecirculaire.org/...html",
      "https://app.circularcity.world/...html"
    ]
  }
}

---

📚 Documentation Vercel

• Guide Vercel
• Python Runtime
• Environment Variables

---

Version : 2.1.0 Dernière mise à jour : 2026-02-27