IntroductionIntroduction

Octopus transforme une liste de mots-clés en pages SEO publiées dans votre boutique Shopify — une page par requête, vérifiée contre les doublons.Octopus turns a list of keywords into SEO pages published in your Shopify store — one page per query, checked against duplicates.

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.The principle is simple: you provide the keywords, Octopus spreads its tentacles to generate, check and publish. This documentation covers installation, importing, the two generation modes and the status reference.

InstallationInstallation

1. Installez Octopus depuis l'App Store Shopify et accordez les permissions de lecture/écriture des pages et collections.Install Octopus from the Shopify App Store and grant read/write permissions for pages and collections.
2. Ouvrez le Tableau de bord : l'index anti-cannibalisation se construit automatiquement à partir de votre catalogue existant.Open the Dashboard: the anti-cannibalization index builds automatically from your existing catalog.
3. (Optionnel) Ajoutez votre clé Anthropic dans Réglages pour activer le mode Éditorial.(Optional) Add your Anthropic key in Settings to enable Editorial mode.

Importer des mots-clésImport keywords

Depuis l'écran Importer, déposez un fichier CSV. Une ligne = un mot-clé. La colonne keyword est obligatoire ; mode et intent sont facultatifs.From the Import screen, drop a CSV file. One row = one keyword. The keyword column is required; mode and intent are optional.

Octopus crée une page par ligne 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.Octopus creates one page per row and runs batch generation in the background. You track progress in the jobs list — each job shows success / total.

Mots-clés bloquésBlocked keywords

Certains termes sont écartés automatiquement (contenu interdit, produits réglementés). Ils apparaissent dans la liste des mots-clés bloqués avec leur motif.Some terms are automatically filtered out (prohibited content, regulated products). They appear in the blocked-keywords list with their reason.

Modes Produit & ÉditorialProduct & Editorial modes

Octopus génère deux types de pages selon l'intention du mot-clé :Octopus generates two page types depending on keyword intent:

Mode ProduitProduct mode

Crée une collection SEO regroupant les produits pertinents de votre catalogue, avec titre, description et slug optimisés. Idéal pour les requêtes transactionnelles (« snowboard », « jean »).Creates an SEO collection grouping the relevant products from your catalog, with optimized title, description and slug. Ideal for transactional queries ("snowboard", "jeans").

Mode ÉditorialEditorial mode

Rédige un contenu long (guide, comparatif) propulsé par votre clé Anthropic, avec une stratégie RAG : GENERATION, AGGREGATION ou HYBRIDE selon les données disponibles. Idéal pour les requêtes informationnelles.Writes long-form content (guide, comparison) powered by your Anthropic key, with a RAG strategy: GENERATION, AGGREGATION or HYBRID depending on available data. Ideal for informational queries.

Anti-cannibalisationAnti-cannibalization

Avant chaque création, Octopus interroge un index sémantique de votre catalogue pour vérifier qu'aucune page trop proche n'existe déjà. Si un quasi-doublon est détecté, la page reçoit le statut Cannibalisation au lieu d'être publiée.Before each creation, Octopus queries a semantic index of your catalog to verify no near-duplicate page already exists. If a near-duplicate is detected, the page receives the Cannibalization status instead of being published.

L'index se met à jour à chaque publication. Vous pouvez le ré-indexer manuellement depuis le Tableau de bord (« Ré-indexer »).The index updates on every publish. You can re-index manually from the Dashboard ("Re-index").

Statuts des pagesPage statuses

Chaque page générée porte un statut, suivant un code couleur strict :Each generated page carries a status, following a strict color code:

• PubliéPublished — la page est en ligne dans Shopify, prête à indexer.the page is live in Shopify, ready to index.
• InsuffisantInsufficient — trop peu de produits/données pour générer une page de qualité. À enrichir.too few products/data to generate a quality page. To enrich.
• CannibalisationCannibalization — une page trop proche existe déjà ; publication bloquée.a near-duplicate page already exists; publishing blocked.
• En attenteQueued — en file de génération.in the generation queue.
• ErreurError — échec de génération ou de publication ; consultez le détail du job.generation or publishing failed; check the job detail.

Clé API AnthropicAnthropic API key

Le mode Éditorial utilise votre propre clé Anthropic. Rendez-vous dans Réglages → Clé API et collez une clé au format Anthropic.Editorial mode uses your own Anthropic key. Go to Settings → API key and paste a key in the Anthropic format.

La clé est stockée chiffrée et n'est jamais exposée côté client. Vous êtes facturé directement par Anthropic pour votre consommation — Octopus ne prend aucune marge.The key is stored encrypted and never exposed client-side. You are billed directly by Anthropic for your usage — Octopus takes no markup.