Documentation

Guide complet : fonctionnalités, configuration et utilisation

Vue d'ensemble

SEO Pilote est un tableau de bord SEO complet conçu pour les agences et consultants SEO. Il permet de centraliser le suivi des positions, la qualification des mots-clés, la gestion des plans d'action et la génération de rapports IA pour chaque client.

Stockage local uniquement — Sauvegardez vos données !
Toutes les données sont enregistrées localement sur votre ordinateur. Aucune donnée n'est envoyée ni stockée en ligne. Pensez à effectuer des sauvegardes régulières depuis la page Paramètres.

Sources de données

  • Haloscan — Positions, volumes de recherche, suggestions de mots-clés
  • Google Search Console — Impressions, clics, CTR, positions moyennes via l'API officielle
  • OpenAI — Rapports SEO automatisés, synthèses et recommandations par IA

Démarrage

Suivez ces étapes pour mettre en place le suivi SEO d'un client.

1

Créer un client

Depuis la page d'accueil, cliquez sur "Nouveau client" et renseignez le nom du client ou du site.

2

Importer un fichier de crawl

Lancez un crawl complet avec Screaming Frog (payant) ou BeamUsUp (gratuit), exportez en CSV et importez-le depuis le dashboard client. Cela active la fonctionnalité URLs Orphelines.

3

Importer un fichier de référence GSC

Importez un premier fichier Google Search Console qui servira de point de référence. Via l'API GSC ou via fichier CSV exporté manuellement.

Important : Taguez ce fichier comme "Référence" dans le dashboard client. C'est ce fichier qui servira de point de départ pour mesurer l'évolution.
4

Importer les données Haloscan

Haloscan apporte le volume de recherche mensuel, une donnée que la GSC ne fournit pas. Via l'API ou fichier Excel/CSV.

5

Comparer les positions

Importez un second fichier GSC avec une date différente, puis rendez-vous dans Suivi des Positions pour voir les hausses, baisses et entrées/sorties.

Et ensuite ? Explorez le Plan d'Action pour organiser vos optimisations, utilisez le Suivi des Mots-Clés GSC pour monitorer vos mots-clés stratégiques, et générez des rapports IA pour vos clients.

Fonctionnalités

  • Créez, renommez et supprimez des clients
  • Chaque client dispose de ses propres imports, plans d'action et suivi
  • Vue globale inter-clients pour les tâches et le suivi de positions
  • Import Excel/CSV : Haloscan, Google Search Console, Screaming Frog
  • Import API direct : Récupération automatique des positions via Haloscan et GSC
  • Qualification : Marquez chaque mot-clé comme pertinent, non pertinent ou à évaluer
  • Tags et notes : Organisez vos imports avec des tags personnalisés
  • Détection de cannibalisation : Identifiez les URLs qui se disputent les mêmes mots-clés
  • Détection des URLs avec des impressions GSC mais sans maillage interne
  • Croisement avec les données de crawl Screaming Frog ou BeamUsUp
  • Vue par client et vue globale
  • Synthèse SEO : Résumé exécutif, tendances, opportunités et hypothèses
  • Rapport de suivi : Analyse des performances par mot-clé
  • Rapport client : Rapport factuel sans recommandations, prêt à envoyer
  • Export complet de toutes les données en JSON
  • Restauration sur un autre poste
  • Accessible depuis les Paramètres de l'application

Plans d'Action

À quoi ça sert ? Quand vous analysez un site, vous identifiez des optimisations à faire sur certaines pages. Le Plan d'Action vous permet de centraliser toutes ces tâches et de les organiser par page (URL). C'est votre feuille de route SEO.
  • Organisation par page : Les tâches sont regroupées par URL
  • Types de tâches : Tâches globales ou spécifiques à un mot-clé
  • Statuts : À faire, Prioritaire, À ne pas faire, Terminé
  • Sous-tâches : Checklist de sous-étapes pour chaque tâche
  • 5 modes de vue : Par URL, Liste, Kanban (drag & drop), Calendrier, Statistiques
  • Templates : Créez des modèles de tâches réutilisables
  • Export : Excel, CSV, PDF
Conseil : Commencez par les "quick wins" — les pages proches du top 10 (positions 11 à 20) avec un bon volume de recherche.

Suivi des Positions

À quoi ça sert ? Comparez vos positions à deux dates différentes pour mesurer si vos actions portent leurs fruits. Vous voyez immédiatement quels mots-clés progressent, reculent ou restent stables. C'est l'outil qui vous permet de prouver les résultats de votre travail SEO.

Fonctionnalités

  • Comparez deux imports pour mesurer l'évolution (gains, pertes, stable)
  • Filtrez par type d'évolution, plage de positions, source
  • Comparaison spécifique GSC (impressions, clics, CTR)
  • Génération de rapport IA automatisé via OpenAI

Comment l'utiliser ?

  1. Importez au moins 2 fichiers GSC (ou Haloscan) à des dates différentes
  2. Rendez-vous dans Suivi des Positions depuis le menu
  3. Sélectionnez un client puis choisissez vos deux imports à comparer
  4. Analysez les résultats : mots-clés en hausse (vert), en baisse (rouge), stables (gris)

Suivi des Mots-Clés GSC

À quoi ça sert ? Sélectionnez vos mots-clés stratégiques et suivez-les dans un tableau dédié, avec position, volume, impressions, clics et évolution. C'est votre tableau de bord stratégique.

Comment l'utiliser ?

  1. Depuis le dashboard d'un client, ouvrez un import GSC
  2. Cliquez sur l'icône "Suivre" à côté des mots-clés à surveiller
  3. Rendez-vous dans Suivi Mots-Clés GSC depuis le menu
Conseil : Concentrez-vous sur les 10 à 30 mots-clés les plus importants pour votre client.

Connexion API Haloscan

1

Créer un compte Haloscan

Rendez-vous sur haloscan.com et créez un compte.

2

Obtenir votre clé API

Accédez à votre tableau de bord API Haloscan pour copier votre clé.

3

Configurer dans SEO Pilote

Dans Paramètres, collez votre clé API, sauvegardez et testez la connexion.

Fonctionnalités via l'API

  • Positions du domaine : récupère automatiquement tous les mots-clés positionnés
  • Mots-clés similaires : suggestions avec volume de recherche
  • Variations : variantes et déclinaisons
  • Questions populaires : questions posées par les internautes

Connexion API Monitorank

L'API Monitorank vous permet de suivre les positions de vos mots-clés sur Google avec une distinction Desktop / Mobile. Les données sont récupérées automatiquement et fusionnées dans SEO Pilote.

1

Créer un compte Monitorank

Rendez-vous sur monitorank.com et créez un compte.

2

Obtenir votre clé API

Connectez-vous à votre espace Monitorank et récupérez votre clé API depuis les paramètres de votre compte.

3

Configurer dans SEO Pilote

Dans Paramètres, collez votre clé API dans le champ Monitorank, sauvegardez et testez la connexion.

4

Associer un projet et une entité à un client

Depuis le dashboard d'un client, configurez le Projet (site ou campagne) et l'Entité (moteur de recherche ciblé, ex : Google FR) Monitorank correspondants.

Données récupérées via l'API

  • Mots-clés suivis : liste complète des mots-clés du projet
  • Position Desktop : position sur ordinateur
  • Position Mobile : position sur mobile
  • Volume de recherche : volume mensuel estimé
  • URL positionnée : la page qui se positionne sur chaque mot-clé
Fusion Desktop / Mobile : Monitorank peut retourner des entrées séparées pour Desktop et Mobile. SEO Pilote les fusionne automatiquement par mot-clé. La position principale affichée est celle du Desktop (ou Mobile si le Desktop n'est pas disponible).

Connexion Google Search Console

Note : Le serveur backend Express (port 3001) est indispensable pour l'authentification OAuth2.
1

Créer un projet Google Cloud

Rendez-vous sur la Google Cloud Console et créez un nouveau projet.

2

Activer l'API Search Console

Dans votre projet, allez dans API et Services > Bibliothèque, recherchez "Google Search Console API" et activez-la.

3

Configurer l'écran de consentement OAuth

Type d'utilisateur : Externe. Ajoutez votre adresse email comme utilisateur de test.

4

Créer les identifiants OAuth 2.0

Type : Application Web. URI de redirection autorisé :

http://localhost:3001/auth/google/callback

5

Configurer dans SEO Pilote

Collez le Client ID et le Client Secret dans Paramètres, sauvegardez, puis cliquez sur "Se connecter à Google".

6

Associer un site GSC à un client

Sur le dashboard d'un client, sélectionnez le site GSC correspondant dans le menu déroulant.

Données récupérées

  • Requêtes : mots-clés sur lesquels le site apparaît
  • Position moyenne par mot-clé et par page
  • Impressions : nombre d'affichages dans les résultats
  • Clics et CTR

Connexion API OpenAI

L'API OpenAI génère des rapports SEO automatisés à partir de vos données de comparaison de positions.

1

Créer un compte OpenAI

Rendez-vous sur platform.openai.com. Un moyen de paiement est nécessaire.

2

Générer une clé API

Accédez à API Keys et créez une nouvelle clé secrète.

La clé ne sera affichée qu'une seule fois. Copiez-la immédiatement.
3

Configurer dans SEO Pilote

Collez votre clé dans Paramètres > API OpenAI, sauvegardez et testez.

Types de rapports générés

  • Synthèse SEO consultante : Résumé exécutif, tendances, opportunités, plan d'action
  • Rapport de suivi : Analyse par mot-clé suivi, détection des problèmes
  • Rapport client : Rapport factuel et professionnel, prêt à envoyer

Import de données

  • Via l'API (recommandé) : Depuis le dashboard client, bouton "Import Haloscan"
  • Via fichier : Exportez depuis Haloscan et importez le fichier. Colonnes reconnues : Keyword, Position, Volume, URL, Date, Traffic

L'import se fait exclusivement via l'API Monitorank.

  1. Depuis le dashboard d'un client, configurez le Projet et l'Entité Monitorank associés
  2. Cliquez sur "Import Monitorank" pour récupérer les mots-clés et positions
  3. Les données sont automatiquement formatées : position Desktop, position Mobile, volume et URL
Monitorank distingue les positions Desktop et Mobile. Les deux sont conservées lors de l'import.

Une fois la connexion GSC configurée, utilisez le bouton "Import GSC" depuis le dashboard client.

  • Période par défaut : les 28 derniers jours (avec 3 jours de décalage)
  • Colonnes importées : Requête, Position, Impressions, CTR, Clics, URL
  1. Rendez-vous sur Google Search Console
  2. Performances > Résultats de recherche
  3. Cochez Clics, Impressions, CTR et Position moyenne
  4. Onglet "Requêtes" puis "Exporter" en CSV
  5. Importez dans SEO Pilote depuis le dashboard client
  • Screaming Frog : Exportez le CSV "Internal" et importez-le
  • BeamUsUp (gratuit) : Téléchargez sur beamusup.com, crawlez et exportez en CSV
Les colonnes essentielles sont URL (ou Address) et Status Code. Utilisé pour la détection des URLs orphelines.

FAQ & Dépannage

Vérifiez que :

  • L'API Search Console est bien activée dans Google Cloud Console
  • L'écran de consentement OAuth est configuré
  • Votre email est ajouté comme utilisateur de test
  • L'URI de redirection est exactement : http://localhost:3001/auth/google/callback
  • Vérifiez l'association du site GSC au client
  • Les données GSC ont un décalage de ~3 jours (c'est normal)
  • Vérifiez le statut de connexion dans les Paramètres

L'URI de redirection ne correspond pas. Ajoutez exactement :

http://localhost:3001/auth/google/callback

Pas de slash final, pas de https, pas de port différent.

  • Vérifiez que votre clé API OpenAI est valide et que vous avez des crédits
  • Testez la connexion dans les Paramètres
  • Assurez-vous d'avoir des données de comparaison (au moins 2 imports)
  1. Sur l'ancien poste : Paramètres > "Télécharger la sauvegarde"
  2. Transférez le fichier JSON sur le nouveau poste
  3. Sur le nouveau poste : installez SEO Pilote puis "Choisir un fichier de sauvegarde"
Les clés API et la connexion Google devront être reconfigurées.