Documentation SEO Master

L'objectif de cette section : avoir ton premier site WordPress connecté, audité par l'IA dual-LLM, et la première recommandation poussée en production — le tout en moins de 5 minutes chrono. Aucune compétence technique requise au-delà de savoir installer un plugin WordPress.

1. Crée ton compte sur seo.mogacode.ma/auth/register. Email professionnel + mot de passe, ou OAuth Google. Pas de carte bancaire demandée pendant les 14 jours d'essai du plan Starter — tu peux annuler à tout moment, on ne facture rien à la fin si tu ne mets pas de carte.
2. Télécharge le plugin SEO Master Connector depuis ton dashboard (menu Sites → Ajouter un site → Télécharger le plugin). C'est un fichier ZIP signé d'environ 280 KB. Dans ton WordPress, va dans Extensions → Ajouter une nouvelle extension → Téléverser une extension → choisis le ZIP → Installer maintenant → Activer.
3. Pairing 1-clic. Une fois le plugin actif, va dans Réglages → SEO Master Connector. Clique « Coupler avec mon compte SEO Master ». Une fenêtre OAuth s'ouvre dans ton navigateur, tu autorises, le pairing est établi via une signature HMAC SHA-256. Aucun mot de passe ni clé API à copier-coller manuellement.
4. Premier audit automatique. Dès que le pairing est établi, SEO Master crawle ton site (typiquement 50 à 500 pages selon la taille), lance l'audit technique (Core Web Vitals via PageSpeed Insights, schema.org validation, hreflang, sitemap, robots.txt) et fait tourner GPT-4o + DeepSeek en parallèle sur les 20 pages les plus importantes. Le rapport complet est prêt en 60 à 90 secondes.
5. Push 1-clic en production. Chaque recommandation a un bouton « Appliquer ». En cliquant, le plugin reçoit une instruction signée, valide la signature, applique la modification dans la base WordPress (title via Yoast/RankMath/SEOPress si détecté, sinon via meta natif WP), puis renvoie une confirmation. Le tout est tracé : tu peux annuler la modification à tout moment depuis l'historique.

Le plugin SEO Master Connector est le pont entre le SaaS et ton site WordPress. Il permet à SEO Master de lire la structure de ton site (URLs, taxonomies, meta), d'appliquer les recommandations en 1 clic depuis le dashboard, et d'injecter automatiquement les schemas Schema.org au bon endroit (head, ou body via filtre Yoast/RankMath si présent).

Compatibilité

• WordPress 6.4+ (testé jusqu'à 6.7) — single-site et multisite

• Yoast SEO (toutes versions ≥ 21) — auto-détection, surcharge des champs SEO Meta

• RankMath (toutes versions ≥ 1.0.214) — auto-détection, push direct dans la table rank_math_meta

• SEOPress (toutes versions ≥ 7.0) — auto-détection

• Elementor (Free + Pro) — modifie le JSON brut Elementor sans toucher au HTML rendu, pour que tes mises en forme persistent

• WooCommerce — découverte automatique des CPTs (produit, boutique, catégorie)

• ACF, Pods, JetEngine — détection des CPTs custom via REST API

• WPML, Polylang, TranslatePress — gestion multi-langues, hreflang correct

Sécurité

Toutes les requêtes entre SEO Master et le plugin sont signées avec un secret HMAC SHA-256 généré au pairing (jamais transmis en clair). Le plugin valide la signature, le timestamp (anti-replay : window de 60 secondes), et l'origine (whitelist seo.mogacode.ma) avant d'exécuter quoi que ce soit. Aucune action ne peut être déclenchée par un acteur externe — même si quelqu'un obtenait l'URL de l'endpoint plugin.

Le plugin n'expose aucun endpoint REST public. Il écoute uniquement sur l'URL /wp-json/seomaster/v1/sync qui exige l'header X-SEOMaster-Signature valide. Un audit de sécurité par un pentester externe est en cours (Q3 2026, rapport public à venir).

Pour exploiter les vraies données Google (impressions, clics, CTR, positions par requête, sessions GA, fiches GMB, volumes de recherche), SEO Master se connecte à ton compte Google via OAuth 2.0. Une autorisation, et toutes les données pertinentes sont synchronisées dans tes audits — sans jamais que SEO Master n'écrive quoi que ce soit côté Google.

Le leak interne Google de mai 2024 (publication anti-trust DOJ + leak Yandex) a révélé que NavBoost — le système qui pondère les positions selon les comportements clics réels des utilisateurs — est l'un des trois facteurs de classement les plus influents. Concrètement : si ta page est en position 5 mais que les utilisateurs cliquent dessus 2× plus souvent que la moyenne pour cette position, Google la promeut. À l'inverse, si elle est en position 3 mais que personne ne clique, elle redescend.

Le NavBoost CTR Detector compare ton CTR par position aux benchmarks Google publics (advanced web ranking, similarweb, sistrix) et identifie automatiquement les pages où ton CTR est significativement sous la médiane. Pour ces pages, l'IA dual-LLM propose 3 alternatives de title et meta description optimisées pour le CTR (chiffres, brackets, hooks émotionnels, longueur idéale 50-60c title + 145-160c desc), validées contre les guidelines Google et testables en A/B via le plugin WordPress.

Comment lire le score NavBoost

• Vert (CTR ≥ médiane × 1.1) — la page over-performe. Ne touche à rien.
• Jaune (CTR entre médiane × 0.8 et médiane × 1.1) — la page est dans la norme. Tu peux tester une variante mais l'amélioration potentielle est faible.
• Rouge (CTR < médiane × 0.8) — opportunité claire. Le potentiel d'amélioration est de 20 à 50% du trafic actuel sur cette page.

Les seuils prennent en compte le secteur d'activité (e-commerce, B2B, info, local), la position SERP exacte, et la présence de features SERP au-dessus de toi (PAA, featured snippet, knowledge panel) qui réduisent mécaniquement le CTR organique. Le calcul est documenté en détail dans la formule NavBoost (à venir Q3 2026).

AEO (Answer Engine Optimization) et LLMO (Large Language Model Optimization) sont les deux disciplines émergentes du SEO 2026. Concrètement : il ne suffit plus de ranker dans Google — il faut être cité comme source par ChatGPT, Claude, Perplexity, Gemini, et dans les Google AI Overviews. Une étude Mozilla 2025 montre que 31% des recherches sur ces moteurs n'aboutissent à aucun clic vers la source — donc si tu n'es pas cité dans la réponse, tu n'existes pas.

SEO Master scanne ton contenu pour les signaux AEO : densité de questions-réponses bien formulées, présence de listes structurées, schemas FAQPage et HowTo correctement implémentés, sources externes citées, formats que les LLM reproduisent volontiers (tableaux, comparatifs, définitions claires en première phrase). Pour chaque page, on te dit ce qu'il faut ajouter, modifier ou retirer pour maximiser tes chances d'être cité.

LLM Citation Tracker (plans Agency+)

Chaque mois, on interroge ChatGPT, Claude, Perplexity, Gemini et Google AI Overview avec une vingtaine de prompts liés à ton domaine. Pour chaque prompt, on note si tu es cité, à quelle position dans la réponse, et avec quel angle. Le rapport mensuel te montre l'évolution de ta présence LLM, les concurrents qui sont systématiquement cités à ta place, et les angles éditoriaux à exploiter. C'est l'équivalent du rank tracking, mais pour les moteurs IA.

L'API REST v1 est incluse uniquement dans le plan Scale (449€/mois). Elle permet d'intégrer SEO Master à ton stack existant : Zapier, n8n, Make, ton CRM, ton dashboard interne, ou des automatisations internes Python/Node. Authentification par Bearer token (généré depuis ton compte → Settings → API Keys), rate limit 600 requêtes par minute par clé, retours JSON standards.

Endpoints disponibles

• GET /api/v1/sites — liste des sites du tenant

• GET /api/v1/sites/{id}/pages — pages d'un site avec leurs derniers scores

• POST /api/v1/audits — déclenche un audit ponctuel sur une URL

• GET /api/v1/audits/{id} — résultat complet d'un audit (recommandations + scores)

• POST /api/v1/recommendations/{id}/apply — applique une recommandation via plugin WordPress

• GET /api/v1/rank-tracker — positions par keyword sur les 90 derniers jours

La spec OpenAPI complète est disponible sur /docs/api/v1 (export YAML compatible Postman, Insomnia, Bruno). Un client TypeScript généré automatiquement est dispo via npm install @seo-master/api-client.

Sur les plans Pro (5 sites), Agency (50 sites) et Scale (illimité), tu peux organiser tes sites en « espaces clients » isolés. Chaque client a son propre tableau de bord avec ses sites, ses audits, ses rapports — sans voir ceux des autres clients. Tu peux aussi générer des rapports white-label (PDF avec ton propre logo, ta couleur, sans mention SEO Master) à envoyer directement aux clients en pièce jointe ou via lien partageable.

Permissions et rôles

4 rôles disponibles : Owner (toi), Admin (équipe interne, accès complet), Member (consultant, accès aux sites assignés uniquement), Client (lecture seule, voit uniquement ses propres sites avec habillage white-label). Les invitations se font par email, validation OAuth Google ou mot de passe. Un audit interne de chaque action critique (modification de plan, suppression de site, partage de rapport) est conservé 90 jours.