Table des matières
1. Installation & Activation
Téléchargez le plugin
Après votre achat, vous avez reçu un email de Freemius contenant votre clé de licence et un lien de téléchargement. Téléchargez le fichier .zip.
Uploadez dans WordPress
Activez le plugin
Cliquez sur "Activer l'extension". Un nouveau menu "WooWriter AI" apparait dans la sidebar gauche de WordPress avec 3 sous-menus : Produits, Audit SEO, Parametres.
Activez votre licence
A la premiere activation, une fenetre vous demande votre clé de licence. Saisissez la cle recue par email pour debloquer toutes les fonctionnalites et les mises a jour automatiques.
2. Configuration des clés API
WooWriter AI utilise vos propres clés API. Vos clés sont chiffrées (AES-256) et stockées uniquement sur votre serveur. Elles ne transitent jamais par nos serveurs.
2.1 Claude AI (Anthropic) — Requis
Claude est le moteur principal. Il analyse vos images produit (vision) et génère les descriptions, titres, meta et alt texts.
Créez un compte
Rendez-vous sur console.anthropic.com et creez votre compte.
Ajoutez du crédit
Allez dans Settings → Billing et ajoutez du credit. 5$ suffisent pour environ 500 descriptions.
Générez votre clé
Allez dans Settings → API Keys → Create Key. Copiez la cle (format : sk-ant-...).
Collez dans WooWriter
2.2 Perplexity AI — Recommande
Perplexity scrape Google en temps réel pour analyser la SERP, extraire les questions PAA (People Also Ask), identifier les mots-clés concurrents et enrichir vos descriptions avec des données SEO réelles.
Créez un compte
Rendez-vous sur perplexity.ai/settings/api.
Ajoutez du crédit et générez la clé
Ajoutez du crédit (5$ = ~800 analyses SERP), puis cliquez sur "Generate". Format : pplx-....
Collez dans WooWriter
2.3 OpenAI / ChatGPT — Optionnel
Alternative a Claude. Si vous preferez utiliser ChatGPT comme moteur de generation.
Obtenez votre clé
Rendez-vous sur platform.openai.com/api-keys, ajoutez du credit dans Billing, puis creez une cle API (format : sk-...).
Configurez dans WooWriter
3. Réglages du plugin
Onglet API
| Reglage | Recommandation | Explication |
|---|---|---|
| Fournisseur IA | Claude (Anthropic) | Meilleure qualite pour la vision et le SEO |
| Modele Claude | claude-sonnet-4-6 | Meilleur rapport qualite/prix, vision excellente |
| Tokens maximum | 1500 | Suffisant pour descriptions completes + meta |
Modèles disponibles
| Modele | Usage | Cout / description |
|---|---|---|
claude-sonnet-4-6 | Recommande — Vision + Performance | ~0.01$ |
claude-haiku-4-5 | Rapide & economique | ~0.003$ |
claude-opus-4-6 | Qualite premium maximale | ~0.05$ |
gpt-4o-mini | OpenAI — Rapide | ~0.005$ |
gpt-4o | OpenAI — Vision + Performance | ~0.02$ |
Onglet Prompts
| Reglage | Description |
|---|---|
| Prompt de génération | Le prompt par défaut utilisé pour générer les descriptions. Vous pouvez le personnaliser. Le nom du produit, les catégories et les specs sont automatiquement ajoutés. |
| Prompt Workflow SERP | Prompt specifique au workflow SEO complet. Utilise quand les données SERP de Perplexity sont disponibles. |
Onglet SEO & Conversion
| Reglage | Recommandation | Explication |
|---|---|---|
| Longueur | 150-300 mots | Ideal pour le SEO e-commerce. Google favorise les descriptions entre 200 et 400 mots. |
| Ton | Selon votre marque | Professionnel, decontracte, luxe, jeune, technique |
| Public cible | Selon vos produits | Femme, homme, unisexe, enfant, general |
| Meta Description | Active | Génère automatiquement les meta descriptions (155-160 car.) et les envoie à Yoast SEO ou Rank Math |
| Title SEO | Active | Génère les titres SEO (55-60 car.) pour Yoast/Rank Math |
| Alt Text Images | Active | Génère un alt text SEO (10-15 mots) pour chaque image du produit |
| Description Images | Optionnel | Génère une description détaillée (20-30 mots) pour chaque image dans la médiathèque |
| A/B Testing | 1 version | Passez a 2-3 versions pour tester differents angles de redaction |
Onglet Perplexity
| Reglage | Recommandation | Explication |
|---|---|---|
| Modele | sonar | Rapide et economique (~0.006$ par analyse). sonar-pro pour des analyses plus profondes. |
| Assistant SEO | Active | Active le workflow SEO complet et les analyses SERP |
| Distribution auto | Selon preference | Si active, distribue automatiquement les intentions de recherche aux produits |
4. L'interface produits
La page principale affiche tous vos produits WooCommerce dans une grille avec :
Zone de filtres
- Categorie — Filtrez par categorie WooCommerce
- Statut — Tous / Sans description / Publies / Brouillons
- Recherche — Recherche par nom de produit
- Actualiser — Recharge la liste
- Nettoyer le cache — Vide le cache WooCommerce et redetecte les descriptions
Statistiques
3 cartes en haut affichent en temps reel :
- Total Produits — Nombre total dans la categorie/filtre
- Sans Description — Produits sans aucune description (courte ou longue)
- Descriptions Générées - Nombre de descriptions générées par WooWriter
Cartes produit
Chaque produit est affiche dans une carte avec :
- Image miniature
- Nom du produit (cliquable pour modifier en direct)
- Categories (cliquables pour modifier en direct)
- Prix
- Badge de statut : "Brouillon" si non publie
- Lien "Editer le produit" vers l'editeur WooCommerce
- Case a cocher pour la selection
- 4 boutons d'action (voir section suivante)
Les 4 boutons d'action
Chaque carte produit possede 4 boutons :
H1 Génère uniquement le titre H1 optimisé
SEO Lance le workflow complet (H1 + SERP + Description)
FAQ Génère les FAQ avec questions PAA de Google
Desc Génère la description uniquement
Pagination
Les produits sont charges par pages de 100. Utilisez les boutons de pagination en bas pour naviguer entre les pages.
5. Génération de descriptions
5.1 Génération simple — Bouton "Desc"
Le bouton Desc génère la description d'un produit en une étape.
Ce qui se passe :
Claude recoit toutes les images du produit (principale + galerie, jusqu'a 20 images)
Il analyse visuellement chaque image pour comprendre le produit
Il génère une description HTML structurée (avec titres, listes, paragraphes)
La description est sauvegardée dans le champ "Description longue" de WooCommerce
Si activés dans les réglages : meta description, title SEO, alt texts sont aussi générés
5.2 Génération H1 — Bouton "H1"
Le bouton H1 génère uniquement un titre H1 optimisé pour le SEO.
Ce qui se passe :
Claude analyse les images du produit
Il génère un titre longue traîne, unique et anti-cannibalisation
Le titre est sauvegarde et affiche sur la carte
Vous pouvez le modifier en cliquant directement dessus
5.3 Workflow SEO complet — Bouton "SEO"
Le bouton SEO lance le pipeline le plus puissant de WooWriter. C'est la méthode recommandée pour obtenir des descriptions ultra-optimisées.
Workflow en 3 étapes automatiques :
H1 Génération (Claude Vision)
Claude analyse vos images et génère un titre H1 optimisé, unique et longue traîne.
Analyse SERP (Perplexity)
Perplexity recherche votre H1 sur Google en temps reel et extrait :
- Les 10 premiers resultats de la SERP
- Les intentions de recherche des utilisateurs
- Le champ semantique complet
- Les questions "People Also Ask"
- Les angles utilises par les concurrents
- Les opportunites de contenu non couvertes
- Les estimations de volume et de concurrence
- Les mots-clés longue traîne associés
Description ultra-optimisée (Claude + données SERP)
Claude recoit toutes les données SERP et génère une description qui intègre naturellement les mots-clés, répond aux intentions de recherche et se démarque de la concurrence.
Après l'analyse SERP, un panneau de résultats s'affiche avec toutes les données extraites. Vous pouvez les exporter en CSV ou PDF (voir section Export).
5.4 Génération de FAQ — Bouton "FAQ"
Le bouton FAQ génère automatiquement une section FAQ basée sur les vraies questions que les gens posent sur Google.
Workflow en 3 étapes :
Extraction PAA (Perplexity)
Perplexity recherche votre produit sur Google et extrait les 8-12 questions de la section "People Also Ask" (Autres questions posees).
Génération des réponses (Claude)
Claude génère des réponses SEO-optimisées de 50 à 100 mots pour chaque question. Les réponses sont spécifiques à votre produit et incluent des mots-clés naturellement.
Application au produit
La FAQ est ajoutée à la fin de la description produit en HTML sémantique. Le schema.org FAQPage est automatiquement généré pour que Google puisse afficher vos FAQ en rich snippets.
- Rich Snippets — Google peut afficher vos FAQ directement dans les resultats de recherche
- Meilleur positionnement — Repond directement aux intentions de recherche
- Augmentation du CTR — Plus de surface visible dans la SERP
- Schema.org — FAQPage markup automatique reconnu par Google
5.5 Génération en masse
Pour traiter plusieurs produits d'un coup :
Sélectionnez vos produits
Cochez les produits voulus, ou utilisez "Selectionner tout" pour selectionner toute la page (100 max).
Choisissez l'action
4 boutons d'action en masse sont disponibles :
- Générer H1 pour la sélection — Génère uniquement les titres H1
- Générer tout pour la sélection — Génère descriptions + meta + alt texts
- Workflow Complet SEO — H1 + SERP + Description pour chaque produit
- Générer FAQ pour la sélection — FAQ + schema.org pour chaque produit
Suivez la progression
Une barre de progression apparait avec le nombre de produits traites, le nombre de succes et d'erreurs. Les produits sont traites un par un avec un delai d'une seconde entre chaque pour eviter de surcharger les APIs.
- Commencez par tester sur 2-3 produits avant de lancer en masse
- Le workflow SEO complet prend ~15-20 secondes par produit (3 appels API)
- La generation simple prend ~5-8 secondes par produit
- Evitez de fermer l'onglet pendant le traitement
6. Audit SEO & Anti-Cannibalisation
6.1 Détection en temps réel
Chaque fois que vous sauvegardez un produit dans l'editeur WooCommerce, WooWriter verifie automatiquement s'il y a un risque de cannibalisation SEO avec vos autres produits.
Qu'est-ce que la cannibalisation SEO ?
C'est quand deux de vos pages se font concurrence sur les memes mots-cles. Google ne sait pas laquelle privilegier, et les deux perdent en positionnement. C'est un des problemes SEO les plus frequents en e-commerce, surtout quand on a des produits similaires.
Comment ca fonctionne
- Claude analyse le titre et la description de votre produit
- Il le compare avec vos 50 produits existants les plus proches
- Si la similarite depasse 75%, une alerte apparait dans l'editeur produit
- L'alerte affiche les produits concernes avec le score de similarite et la raison
Actions disponibles
- Generer des titres alternatifs - Claude propose 3 titres avec des angles différents (prix, occasion, style, matériau, saison)
- Appliquer un titre — Cliquez sur un titre propose pour l'appliquer
- Ignorer l'alerte — Si vous estimez que c'est un faux positif
6.2 Audit complet
L'audit complet analyse tout votre catalogue pour detecter les groupes de cannibalisation.
Processus de l'audit :
Configuration — Choisissez le type d'audit :
- Produits uniquement
- Categories uniquement
- Produits vs Categories (anti-cannibalisation croisée)
Et le scope : tous les produits, sans description, ou par categorie.
Analyse par lots — Claude analyse les produits par lots de 10, identifie les clusters de cannibalisation et score la similarite.
Analyse SERP — Perplexity analyse la SERP pour chaque cluster et identifie les intentions de recherche a cibler.
Résultats — Affichage des groupes cannibalisés avec scores, mots-clés problématiques, et stratégies de différenciation.
Variations — Claude génère des descriptions uniques pour chaque produit du groupe, avec des angles différents.
Application — Previsualisation et application en un clic pour chaque variation.
7. Spécifications produit
Dans l'editeur de chaque produit WooCommerce, WooWriter ajoute une meta box "AIPW - Caracteristiques Techniques".
A quoi ca sert ?
Les spécifications permettent à Claude de générer des descriptions factuellement exactes. Sans specs, Claude peut inventer des détails (hallucinations). Avec les specs, il se base sur vos données réelles.
Types de specs
| Cle | Exemple |
|---|---|
| Matiere | Acier inoxydable 316L |
| Poids | 250g |
| Dimensions | 10 x 5 x 2 cm |
| Couleurs | Noir, Bleu marine, Rouge |
| Garantie | 2 ans constructeur |
| Certification | CE, OEKO-TEX |
Pré-remplissage automatique
Si vous avez deja des attributs WooCommerce (taille, couleur, etc.), cliquez sur "Pre-remplir depuis les attributs" pour les importer automatiquement dans les specs.
Zone de notes
Un champ libre permet d'ajouter du contexte supplementaire : origine, precautions d'usage, proprietes speciales, arguments de vente. Tout ce texte sera injecte dans le prompt de generation.
8. Meta, Alt Text & Integrations SEO
Meta Description
Si activé dans les réglages, WooWriter génère une meta description de 155-160 caracteres optimisée pour le CTR. Elle est automatiquement enregistrée dans :
- Yoast SEO : champ
_yoast_wpseo_metadesc - Rank Math : champ
rank_math_description
Title SEO
Génère un titre SEO de 55-60 caractères, différent du H1, optimisé pour la SERP. Enregistré dans Yoast (_yoast_wpseo_title) ou Rank Math (rank_math_title).
Alt Text des images
Pour chaque image du produit (principale + galerie), Claude génère un texte alternatif de 10-15 mots, descriptif et intégrant les mots-clés. Enregistré directement dans le champ WordPress _wp_attachment_image_alt.
Description des images
Optionnellement, génère une description détaillée de 20-30 mots pour chaque image, enregistrée dans la médiathèque WordPress (caption/description).
9. Exports CSV & PDF
Apres une analyse SERP (workflow SEO complet), un panneau de resultats apparait avec deux boutons d'export :
Export CSV
Telecharge un fichier tableur contenant :
- Titre H1 genere
- Intentions de recherche detectees
- Mots-clés du champ sémantique
- Volume de recherche estime
- Niveau de concurrence
- Mots-clés longue traîne
- Questions PAA extraites
Compatible Excel, Google Sheets, LibreOffice.
Export PDF
Génère un rapport PDF complet avec toutes les données SERP, les recommandations et l'analyse de la concurrence. Idéal pour archiver ou partager avec un consultant SEO.
10. Stratégie SEO recommandée
Stratégie #1 : Le workflow rapide (budget réduit)
Pour les catalogues de moins de 100 produits ou les budgets API limites.
- Remplissez les spécifications de vos produits les plus importants (top 20% des ventes)
- Utilisez le bouton Desc pour générer les descriptions
- Activez les options Meta Description et Alt Text dans les réglages
- Lancez en masse avec "Générer tout pour la sélection"
- Verifiez les 5-10 premiers resultats manuellement
Cout estime : ~5-10$ pour 100 produits
Stratégie #2 : Le workflow SEO complet (recommandé)
Pour maximiser le positionnement sur Google. C'est la methode que nous recommandons.
- Remplissez les spécifications de tous vos produits
- Lancez le Workflow SEO complet par lots de 10-20 produits
- Verifiez les titres H1 generes et ajustez si besoin (clic pour editer)
- Consultez les données SERP dans le panneau de resultats
- Exportez les données en CSV pour les garder
- Lancez ensuite les FAQ pour les produits strategiques
- Executez l'Audit SEO pour detecter la cannibalisation
- Appliquez les variations suggeres pour les produits cannibalises
Cout estime : ~15-25$ pour 100 produits (H1 + SERP + Description + FAQ)
Stratégie #3 : Le workflow anti-cannibalisation
Pour les catalogues avec beaucoup de produits similaires (vetements, accessoires...).
- Lancez d'abord l'Audit SEO complet sur tout votre catalogue
- Identifiez les groupes de cannibalisation
- Générez et appliquez les variations uniques pour chaque groupe
- Relancez l'audit pour verifier que la cannibalisation a ete resolue
- Ensuite seulement, lancez le workflow SEO complet sur les produits optimises
Cout estime : ~10-15$ pour l'audit + variations de 200 produits
- Images de qualité - Plus vos photos sont bonnes, plus Claude génère des descriptions précises
- Spécifications - Remplissez-les toujours pour éviter les hallucinations
- Titres H1 uniques — Chaque produit doit avoir un titre different, longue traine si possible
- Vérifiez les résultats - Lisez les 10 premières descriptions générées pour ajuster le prompt si besoin
- FAQ sur les produits cles — Ciblez les 20% de produits qui generent 80% de votre CA
- Audit regulier — Relancez l'audit apres chaque ajout de nouveaux produits
- N'éditez pas le HTML - WooWriter génère du HTML structuré. Si vous éditez manuellement, la structure peut être cassée
11. Estimation des coûts API
Description simple
Workflow SEO
FAQ complete
Exemples concrets
| Catalogue | Description simple | Workflow SEO | SEO + FAQ |
|---|---|---|---|
| 50 produits | ~0.50$ | ~1.25$ | ~2.25$ |
| 200 produits | ~2$ | ~5$ | ~9$ |
| 500 produits | ~5$ | ~12.50$ | ~22.50$ |
| 1000 produits | ~10$ | ~25$ | ~45$ |
12. Questions fréquentes
Le plugin écrase-t-il mes descriptions existantes ?
Oui, la nouvelle description remplace l'ancienne. WordPress garde un historique des revisions : vous pouvez toujours revenir a une version precedente via l'editeur produit → Revisions.
Faut-il Perplexity pour utiliser le plugin ?
Non. Perplexity est optionnel mais fortement recommandé. Sans Perplexity, vous pouvez générer des descriptions et des H1 avec Claude seul. Avec Perplexity, vous débloquez le workflow SEO complet, les FAQ avec PAA, et l'analyse SERP.
Puis-je utiliser OpenAI au lieu de Claude ?
Oui. Dans les reglages, changez le fournisseur en "ChatGPT". Nous recommandons Claude pour sa meilleure qualité de vision et de génération SEO, mais OpenAI fonctionne aussi.
Le plugin fonctionne-t-il avec Yoast SEO et Rank Math ?
Oui, automatiquement. Les meta descriptions et titres SEO generes sont enregistres directement dans les champs de Yoast SEO et Rank Math. Aucune configuration supplementaire.
Combien de temps prend une generation ?
- Description simple : 5-8 secondes
- H1 seul : 3-5 secondes
- Workflow SEO complet : 15-20 secondes (3 appels API)
- FAQ : 10-15 secondes (2 appels API)
Puis-je personnaliser le prompt ?
Oui, de deux façons : (1) dans les Réglages → Prompts pour changer le prompt par défaut, ou (2) sur la page Produits dans la zone "Prompt personnalisé" pour un usage ponctuel.
Que se passe-t-il si une generation echoue ?
Le produit affiche une erreur et passe au suivant dans le traitement en masse. Les causes fréquentes : clé API invalide, crédit API épuisé, image trop lourde, timeout réseau. Vérifiez vos clés et votre crédit.
Les descriptions générées sont-elles uniques ?
Oui. Claude génère du contenu original à chaque appel. Le système anti-cannibalisation garantit en plus que chaque produit a un angle unique par rapport aux autres.
Puis-je modifier les descriptions générées ?
Absolument. Les descriptions sont enregistrees dans les champs standards de WooCommerce. Vous pouvez les editer a tout moment via l'editeur produit classique.
Le plugin ralentit-il mon site ?
Non. Le plugin ne fonctionne que dans l'administration WordPress. Il n'ajoute aucun script ni CSS sur le front-end de votre boutique (sauf le CSS de style FAQ si vous utilisez les FAQ générées).
13. Support
Vous avez une question, un probleme ou une suggestion ?
| support@woowriter.fr | |
| Site web | woowriter.fr |
| Formulaire | woowriter.fr/contact |
| Delai de reponse | Sous 24 heures (jours ouvres) |
- Votre version de WordPress et WooCommerce
- Le fournisseur IA utilise (Claude/OpenAI)
- Le message d'erreur exact (si applicable)
- Une capture d'ecran du probleme