SeoToolkit/web-analytics-agent-skill

Compétence d'analyse web

Cette compétence permet à l'agent d'extraire et d'analyser les données de trafic de Google et Bing pour fournir des insights SEO approfondis.

Préparation de l'environnement

Les scripts nécessaires se trouvent dans le répertoire scripts/ relatif à ce fichier SKILL.md. Assurez-vous que les dépendances suivantes sont installées :

python3 -m pip install -r scripts/gsc-requirements.txt

Identifiants requis et comment les obtenir

Avant d'exécuter cette compétence, assurez-vous que l'environnement est configuré. Si l'utilisateur ne dispose pas des identifiants nécessaires, l'Agent doit lui demander de les obtenir en suivant les étapes ci-dessous :

1. Secret client OAuth Google (client_secret.json)

L'agent nécessite un ID client OAuth 2.0 pour application de bureau afin d'accéder aux API Google. Instructions pour l'utilisateur :

1. Allez dans la Console Google Cloud.
2. Créez un nouveau projet ou sélectionnez-en un existant.
3. Accédez à APIs & Services > Bibliothèque et activez l'API Google Search Console et l'API Google Analytics Data.
4. Accédez à APIs & Services > Écran de consentement OAuth et configurez-le (vous pouvez définir le type d'utilisateur sur "Externe" et ajouter votre propre adresse e-mail comme utilisateur de test).
5. Accédez à APIs & Services > Identifiants. Cliquez sur Créer des identifiants > ID client OAuth.
6. Sélectionnez Application de bureau comme type d'application.
7. Cliquez sur Créer, puis téléchargez le fichier JSON. Renommez-le en client_secret.json et placez-le dans le répertoire scripts/ de cette compétence.

2. Jetons OAuth Google (token.json, google_analytics_token.json)

Ces jetons sont générés automatiquement par le script.

• Instruction pour l'Agent : Si la sortie du script indique Ouverture du navigateur pour autorisation, demandez à l'utilisateur de vérifier son ordinateur pour une nouvelle fenêtre de navigateur ouverte et de compléter la connexion OAuth Google. Le script enregistrera automatiquement les jetons localement une fois la connexion réussie.

3. Clé API Bing

Instructions pour l'utilisateur :

1. Allez sur Bing Webmaster Tools.
2. Sélectionnez votre site web vérifié.
3. Cliquez sur l'icône d'engrenage Paramètres dans le coin supérieur droit.
4. Accédez à Accès API -> Clé API.
5. Cliquez sur Générer une clé API (ou copiez la clé existante).
6. Collez-la dans le fichier .env sous la forme BING_API_KEY=votre_cle_ici.

Étapes d'exécution

1. Récupérer les données de Google Search Console (GSC)

Exécutez le script d'analyse GSC pour obtenir les clics, impressions, CTR et position moyenne :

cd scripts && python3 analyze_gsc.py

2. Récupérer les données de Google Analytics 4 (GA4)

Exécutez le script GA4 pour analyser les sessions utilisateur, les sources de trafic et les pages vues :

cd scripts && python3 ga4_both.py

3. Récupérer les données de Bing Webmaster Tools

Exécutez le script Bing pour comparer les performances de recherche Bing par rapport à Google :

export BING_API_KEY=$(grep BING_API_KEY ../../.env | cut -d '=' -f2)
cd scripts && python3 bing_webmaster.py

4. Synthétiser les insights

Analysez les résultats combinés et rapportez :

1. Analyse des tendances : Le trafic global est-il en croissance ou en baisse sur la période de 14 jours ?
2. Ratio de plateforme : Quelle est la proportion du trafic Bing par rapport à Google ?
3. Opportunités de mots-clés et de pages : Mettez en évidence les mots-clés avec des impressions élevées mais un faible CTR, ou les pages performantes sur Bing mais pas sur Google.

Fournissez le résumé final à l'utilisateur en utilisant du Markdown propre.