Introduction

Octopus transforme une liste de mots-clés en pages listing produits publiées dans votre boutique Shopify — une page par requête, vérifiée contre les doublons.

Le principe est simple : vous fournissez les mots-clés, Octopus déploie ses tentacules pour générer, vérifier et publier. Cette documentation couvre l'installation, l'import, les deux modes de génération et la référence des statuts.

Prérequis Une boutique Shopify active. La rédaction IA (mode Éditorial en Hybride / Génération, intros IA des collections) nécessite votre clé Anthropic — facultative : l'Agrégation et les intros templétisées fonctionnent sans.

Installation

  1. Installez Octopus depuis l'App Store Shopify et accordez les permissions de lecture/écriture des pages et collections.
  2. Dans Réglages, construisez l'index de contenu en un clic : pages, collections et articles de votre boutique alimentent l'anti-cannibalisation.
  3. (Optionnel) Ajoutez votre clé Anthropic dans Réglages pour activer les rédactions IA (Éditorial Hybride / Génération, intros IA des collections).
Note Aucune carte bancaire n'est requise pour le plan Free (10 pages actives).

Importer des mots-clés

Depuis l'écran Importer, déposez un fichier CSV. Une ligne = un mot-clé. La colonne keyword est obligatoire ; min_products (1–100, seuil de produits minimum pour ce mot-clé) est facultative. Le délimiteur (, ou ;) est détecté automatiquement, le BOM est géré, jusqu'à 5 Mo, et les doublons sont dédupliqués.

# keywords.csv
keyword,min_products
snowboard,5
veste hiver,3
guide cadeaux fêtes,
# un fichier d'exemple est téléchargeable dans l'app (/sample.csv)

Vous choisissez le mode de traitement au lancement du batch — Produit, Éditorial, ou les deux (compte 2 au quota) — pas ligne par ligne dans le CSV. Avant tout lancement, une preview affiche total / valides / erreurs / bloqués / conflits de cannibalisation : rien n'est créé avant votre confirmation.

Octopus crée ensuite une page par mot-clé et lance la génération par lots en arrière-plan. Vous suivez la progression dans la liste des jobs — chaque job affiche réussis / total.

Mots-clés bloqués (blacklist)

Vous définissez pour votre boutique une liste de motifs à écarter — marques concurrentes, termes interdits… — par ajout unitaire ou en masse, avec un motif facultatif. Tout mot-clé qui matche est écarté dès l'import et apparaît dans la liste des mots-clés bloqués.

Modes Produit & Éditorial

Octopus génère deux types de pages selon l'intention du mot-clé. Vous choisissez le mode au lancement du batch : Produit, Éditorial, ou les deux (chaque mot-clé compte alors 2 au quota).

Mode Produit

Crée une collection Shopify native regroupant les produits pertinents de votre catalogue, avec titre, SEO title ({keyword} — {Boutique}), meta description et intro au-dessus de la grille. La recherche s'appuie sur le moteur natif Shopify (produits actifs uniquement, jusqu'à 250). Idéal pour les requêtes transactionnelles (« snowboard », « jean »).

Filtre de pertinence sémantique Chaque produit candidat est re-scoré par similarité entre le mot-clé et ses métadonnées curées (titre + type + tags + vendor — la description est exclue, source des faux positifs). Le seuil est réglable (défaut 0.30) et désactivable ; il ne descend jamais sous votre minimum de produits — il resserre la sélection, il ne bloque pas. Sous min_products, le mot-clé passe en « Insuffisant » plutôt que de créer une page pauvre.

Mode Éditorial (moteur RAG)

Octopus indexe votre blog et mesure, pour chaque mot-clé, sa proximité avec vos articles existants. Il choisit alors automatiquement un des trois modes RAG :

  • Agrégation — articles très proches : une page de curation (extraits + liens vers vos articles). 100 % votre contenu, aucune clé IA requise.
  • Hybride — proximité moyenne : une intro rédigée par Claude + la curation de vos articles.
  • Génération — pas de contenu proche : un article complet (400–600 mots) rédigé par Claude. Nécessite votre clé Anthropic.
À propos de la clé Le mode Éditorial fonctionne sans clé en Agrégation. Seule la Génération (et l'intro Hybride) rédige avec l'IA et requiert votre clé Anthropic ; sans clé, ces mots-clés sont proposés en « différé » avec un message explicite plutôt que rédigés.

Anti-cannibalisation

Octopus contrôle les doublons en deux couches, contre tout le contenu existant de votre boutique (pages, collections, articles) et les contenus qu'il a déjà créés :

  1. À l'import — détection des doublons exacts par « empreinte de tokens » : insensible à la casse, aux accents, aux pluriels, à l'ordre des mots et aux stop-words FR/EN (« robes d'été » ≡ « robe été »).
  2. Au traitement — détection sémantique par similarité d'embeddings (seuil réglable, défaut 0.75) qui attrape les quasi-doublons, y compris entre deux mots-clés d'un même batch.

Sur conflit, vous décidez par ligne : ignorer (défaut, la page n'est pas créée et passe en « Cannibalisation »), forcer (créer quand même — le slug est suffixé automatiquement) ou renommer le mot-clé.

L'index de contenu se construit en un clic depuis Réglages et se met à jour au fil des créations.

Sitemap HTML

Octopus génère et tient à jour une page plan de site HTML qui liste et relie toutes les pages créées. Les robots de Google y trouvent un point d'entrée unique vers l'ensemble de vos pages SEO — l'exploration et l'indexation sont plus rapides et plus complètes.

Le contenu est groupé (Collections / Articles thématiques), trié alphabétiquement, avec un compteur et une date de mise à jour, et localisé FR/EN selon la langue de la boutique. Il est régénéré automatiquement à la fin de chaque batch et après chaque suppression — aucune action de votre part.

Le titre et le slug sont personnalisables ; changer le slug renomme la page existante et crée une redirection 301 depuis l'ancienne URL. Un lien vers le plan de site est ajouté automatiquement au menu footer de votre thème (option activée par défaut) pour que Google le crawle — retiré automatiquement si vous décochez l'option.

À retenir Le plan de site HTML donne à Google un point d'entrée unique vers toutes vos pages : il découvre vos pages de longue traîne même sans lien externe pointant vers elles.

Maintenance automatique des collections

Vos collections restent synchronisées avec votre catalogue : nouveaux produits ajoutés, produits retirés quand ils ne correspondent plus — automatiquement, chaque jour. Octopus re-exécute la recherche de chaque collection qu'il a créée et applique le même filtre de pertinence.

La fréquence est réglable dans Réglages : quotidienne (par défaut), tous les 3 jours, hebdomadaire, ou manuelle. Le diff est minimal : titre, SEO et description ne sont pas touchés. La date du dernier rafraîchissement est affichée dans Réglages.

Vos retouches sont sacrées Octopus gère sa propre sélection de produits via le nouveau modèle de collections Shopify. Si vous ajoutez ou retirez des produits à la main, vos choix ne sont jamais écrasés par la synchronisation. La réindexation de votre blog est réglable séparément (toutes les 6 h / 12 h / 24 h ou manuelle).

Redirections 301

Quand vous supprimez une page générée par Octopus, une fenêtre de confirmation propose de créer une redirection 301 permanente — cochée par défaut, car recommandée. Vous gardez la main : choisissez la destination (collection parente, page d'accueil, ou toute autre URL), ou décochez l'option si vous préférez ne pas rediriger.

Avec la redirection, aucun lien mort et aucune perte de référencement : le « jus SEO » accumulé par la page est transféré vers la destination, et vos visiteurs comme Google arrivent toujours sur une page valide. Sans redirection, l'ancienne URL renverra une 404.

Les redirections sont créées nativement dans les URL redirects de Shopify : vous pouvez les consulter ou les ajuster à tout moment depuis votre admin.

Statuts des pages

Chaque page générée porte un statut, suivant un code couleur strict :

Publié Insuffisant Cannibalisation En attente Erreur
  • Publié — la page est en ligne dans Shopify, prête à indexer.
  • Insuffisant — trop peu de produits/données pour générer une page de qualité. À enrichir.
  • Cannibalisation — une page trop proche existe déjà ; publication bloquée.
  • En attente — en file de génération.
  • Erreur — échec de génération ou de publication ; consultez le détail du job.

Clé API Anthropic

Octopus fonctionne en BYOK (Bring Your Own Key) : les rédactions IA — intros IA des collections, mode Éditorial Hybride et Génération — utilisent votre propre clé Anthropic. Rendez-vous dans Réglages → Clé API et collez une clé au format Anthropic. Sans clé, tout reste utilisable (Agrégation + intros templétisées).

# format attendu
sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx

La clé est chiffrée (AES-256-GCM) et n'est jamais exposée côté client. Vous êtes facturé directement par Anthropic pour votre consommation — Octopus ne prend aucune marge et ne consomme jamais de crédits IA à votre place. Le modèle est Claude Sonnet ; le contenu est rédigé dans la langue principale de votre boutique (EN, FR, DE, ES, IT, PT, NL, JA), avec le ton et la niche que vous configurez.

Besoin d'aide ? Consultez la FAQ ou écrivez-nous depuis le Tableau de bord.