Aller au contenu
Documentation

Écrire avec votre propre IA via MCP

Laissez Claude ou un autre client MCP écrire depuis la file de contenu : réservez des sujets, lisez les briefs, envoyez brouillons, traductions et visuels de couverture, ou lancez des exécutions autonomes sur un Mac.

Propriété → Contenu → Paramètres9 min de lecture

Le moteur de contenu a un second rédacteur : votre propre IA. Tout client MCP connecté à AutoPSEO, comme Claude Code, les applications Claude ou Cursor, peut prendre des sujets dans la même file, lire le même brief et les mêmes règles, puis soumettre des brouillons qui passent les mêmes contrôles que le rédacteur d'AutoPSEO. Les brouillons rédigés ainsi ne sont pas décomptés du quota mensuel d'articles. Vous pouvez travailler avec elle dans une conversation, ou la laisser écrire de façon autonome selon un calendrier.

Connecter votre IA

Le point d'accès MCP est https://app.autopseo.com/mcp. Il y a deux façons de s'y connecter, toutes deux depuis la page MCP & API de votre compte :

  • Se connecter avec OAuth sous « Connect by signing in ». Dans Claude Code : claude mcp add --transport http autopseo https://app.autopseo.com/mcp, puis /mcp et Authenticate.
  • Une clé API commençant par apk_live_, envoyée sous la forme Authorization: Bearer <key>. Les outils de contenu qui modifient quelque chose exigent une clé Read & write ; une clé Read only ne donne accès qu'aux outils de lecture.

Votre rôle compte aussi : un membre disposant d'un accès en lecture ne peut utiliser que les outils de lecture, et un membre invité sur certaines propriétés ne voit que celles-ci. Le catalogue complet, y compris les outils Search Console, se trouve sur la page MCP ; la gestion des clés est décrite dans MCP & ChatGPT app.

Dans Settings de la page Content, l'option Who writes the topics in the queue détermine qui traite la file : AutoPSEO, at the pace above ou Your own AI, through MCP. Si vous choisissez votre propre IA, le rédacteur d'AutoPSEO cesse de prendre les tâches en file. Dans les deux cas, « Your own AI can write and rewrite articles at any time, whichever you choose here. » Pour réserver et soumettre, le moteur doit être activé pour la propriété et l'abonnement actif.

Les outils de contenu

OutilAccèsFonction
content_instructionslectureL'intégralité d'une exécution autonome pour une propriété, construite à partir de ses réglages
content_reportlectureRéglages, types de contenu, quota, nombre de tâches, les 20 articles en ligne les plus récents et les livraisons refusées
content_list_taskslectureLes tâches, les plus prometteuses en premier, avec la personne qui détient chacune
content_find_pageslectureLes pages de votre site qui correspondent à une requête, pour vérifier la couverture et choisir des liens
content_get_pagelectureLe texte en ligne d'un article, son brouillon en relecture, ses révisions et ses recherches sur 28 jours
content_get_translationlectureUne langue : l'original, les règles du traducteur et la traduction actuelle
content_get_briefpayantLes règles de rédaction, le brief, les liens autorisés, l'adresse d'une page typée et l'indication d'un visuel de couverture souhaité
content_add_topicsécriturePlanifier de 1 à 200 sujets ; ils passent par les filtres et la relecture
content_claimécritureRéserver une tâche pendant deux heures : par tâche, par page (rewrite, optimize ou refresh) ou par mot-clé
content_submitécritureVérifier et enregistrer un brouillon ; rien n'est enregistré tant qu'il reste des erreurs
content_submit_translationécritureVérifier et enregistrer une langue d'un brouillon ou d'un article en ligne
content_coverécritureVérifier une scène et obtenir le prompt d'image, les références et une adresse d'envoi
content_set_coverécritureDéfinir ou remplacer un visuel de couverture, ou obtenir une adresse d'envoi pour en téléverser un
content_publishécritureApprouver un brouillon, ou rétablir une révision antérieure
content_unpublishécritureRetirer un article
content_mergeécritureFusionner un article dans une autre page, avec une redirection 301
content_declineécritureRefuser définitivement une tâche, en indiquant un motif
content_propose_valueécritureProposer une nouvelle valeur pour un type de contenu typé, après interrogation de votre site
content_submit_valueécritureEnvoyer les faits d'une nouvelle valeur pour relecture
content_remove_pathécritureDemander à votre site de retirer le chemin d'une valeur

Une clé en lecture seule, ou un membre disposant d'un accès en lecture, se voit refuser tous les outils qui ne sont pas en lecture. Les outils qui publient, retirent, fusionnent ou suppriment un chemin demandent à l'IA de n'agir qu'avec votre accord.

Écrire un article

  1. Choisir une tâche. content_list_tasks affiche ce qui est en file ; content_find_pages vérifie si votre site couvre déjà le sujet.
  2. La réserver. content_claim { taskId } réserve la tâche pendant deux heures, et une nouvelle réservation renouvelle le délai. Vous pouvez aussi réserver un article en ligne avec pageId et kind, ou partir d'un mot-clé, éventuellement avec une clé de type de contenu. Un mot-clé passe d'abord par les filtres.
  3. Lire le brief. content_get_brief renvoie rules (les mêmes règles de rédaction que celles du rédacteur d'AutoPSEO), le brief, allowedLinks et cover.wanted. Le premier appel analyse les résultats de recherche et consomme des crédits de recherche ; les appels suivants pour la même tâche sont gratuits.
  4. Écrire et soumettre. Envoyez l'article en JSON, dans le format décrit dans livraison, avec content_submit. Si un contrôle échoue, la réponse commence par « Not saved. Fix these and submit again: » suivi de la liste ; les liens extérieurs à allowedLinks sont transformés en texte en gras. Lorsque la tâche modifie un article en ligne, transmettez baseRev, la révision sur laquelle vous avez travaillé ; si l'article a évolué entre-temps, la soumission est refusée pour cause de conflit.
  5. Traduire. Pour chacune des autres langues, content_get_translation, puis content_submit_translation. Les langues peuvent être envoyées en parallèle. Voir traduction.
  6. Ajouter un visuel de couverture lorsque le brief indique qu'il est souhaité (voir plus bas).
  7. Publier. Le brouillon attend en relecture. content_publish { taskId } l'approuve, ce que l'outil réserve aux cas où vous le demandez.

Une réservation expirée est libérée par la planification toutes les cinq minutes : la tâche retourne dans la file. content_decline refuse définitivement une tâche avec un motif de 3 à 300 caractères, afin qu'elle ne soit plus jamais proposée.

Réviser un brouillon en relecture

Lorsqu'un relecteur demande des modifications, inutile de rejeter le brouillon :

  1. content_claim avec la tâche (ou la page, ou le mot-clé) remet votre brouillon en rédaction, afin que personne ne le publie entre-temps.
  2. content_get_page renvoie le brouillon sous le nom draft.
  3. content_submit enregistre la révision suivante à la même adresse et marque l'ancien brouillon comme remplacé.
  4. Renvoyez les traductions : la nouvelle révision ne contient que sa propre langue, et content_get_translation propose la traduction du brouillon remplacé sous le nom current.

Si la réservation expire avant, le brouillon retourne en relecture sans changement.

Prompts

Le serveur propose aussi des prompts, qui apparaissent dans Claude Code sous forme de commandes slash telles que /mcp__autopseo__write-articles :

PromptArgumentsÉtapes couvertes
write-articlessite, count (1 à 10)Rédaction d'articles depuis la file, pas à pas
revise-draftsite, draft, changesRévision d'un brouillon en attente de relecture
optimize-pagesite, pageAmélioration d'un article en ligne
refresh-decayedsite, limit (jusqu'à 10)Mise à jour des articles qui ont perdu des clics
connect-repoarticlesUrlCréation du récepteur de webhook signé dans le code de votre site

Visuels de couverture avec votre propre IA

Lorsque votre site affiche des visuels de couverture, content_get_brief indique cover.wanted. Votre IA peut fournir une image qu'elle a créée via le champ cover de content_submit (une url https, ou des data en base64 jusqu'à 2,5 Mo), envoyer le fichier en PUT à l'adresse coverUploadUrl renvoyée par content_submit, ou le définir plus tard avec content_set_cover. Elle peut aussi partir du prompt d'AutoPSEO avec content_cover. Les formats, tailles et contrôles sont décrits dans visuels de couverture.

Ce que cela coûte

  • Les brouillons et traductions envoyés par votre propre IA ne sont pas décomptés du quota mensuel d'articles, et leur envoi est gratuit.
  • La première analyse des résultats de recherche pour le brief, ainsi que l'appel au modèle qui choisit un type de contenu pour un mot-clé que deux types pourraient accueillir, consomment des crédits de recherche.
  • L'ajout de sujets, le refus de tâches et les outils de lecture sont gratuits. L'approbation d'un brouillon auquel il manque des langues, sur un site où AutoPSEO traduit, lance des traductions qui consomment des crédits de recherche.

Exécutions autonomes sur un Mac

content_instructions renvoie tout ce qu'une exécution autonome doit faire pour une propriété : établir le rapport, terminer ce qu'une exécution précédente a laissé en plan, vérifier la couverture avant de dépenser pour un brief, refuser les doublons, écrire, traduire, ajouter des visuels de couverture, et ne publier que si la relecture du site est désactivée. Elle ne retire jamais d'articles et n'en rétablit jamais d'anciennes versions, et se termine par une ligne qu'un script peut lire :

AUTOPSEO_RESULT property=<id> published=<n> review=<n> declined=<n> failed=<n> values=<n>

Le rédacteur AutoPSEO est un petit ensemble de scripts macOS qui exécute ce processus avec votre propre Claude Code, sur votre propre abonnement Claude, sous launchd. Contactez-nous pour les obtenir. Installation :

  1. Connectez Claude Code à AutoPSEO (le connecteur dans Claude, ou claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcp puis Authenticate sous /mcp).
  2. Lancez ./install.sh. Il crée ~/.autopseo/ avec run.sh, cover-mcp.mjs et un exemple de writer.json, ainsi qu'une tâche launchd exécutée chaque jour à 15:07 (AUTOPSEO_HOUR et AUTOPSEO_MINUTE permettent de la modifier). La tâche n'est pas encore chargée.
  3. Renseignez ~/.autopseo/writer.json : properties (chacune avec son id, et une limit facultative de nouveaux articles par exécution, 8 par défaut, 20 au maximum), model et fallbackModel, un subagentModel facultatif pour les sous-agents de traduction, everyDays entre deux exécutions d'une propriété (3 par défaut) et covers (codex,grok, ou off).
  4. Essayez une exécution : AUTOPSEO_FORCE=1 ~/.autopseo/run.sh, puis consultez ~/.autopseo/logs/history.log.
  5. Chargez la planification avec launchctl load ~/Library/LaunchAgents/com.autopseo.writer.plist.

Chaque exécution lance un claude -p par propriété, autorisé à n'utiliser que les outils AutoPSEO et des sous-agents : pas de shell, pas de fichiers, pas de web. Une exécution n'est considérée comme réussie que si elle affiche la ligne de résultat. Lorsque values est supérieur à 0, une seconde session prend en charge les nouveaux chemins des pages typées : elle peut chercher et lire sur le web, mais n'accède qu'aux outils dont une tâche de valeur a besoin. Les exécutions qui échouent pour une raison passagère sont relancées jusqu'à trois fois, une limite d'utilisation interrompt les propriétés restantes, un chien de garde met fin à une exécution au bout de cinq heures, et le Mac reste éveillé pendant ce temps.

Pour les visuels de couverture, les scripts fournissent à Claude Code un second serveur MCP doté d'un seul outil, make_cover, qui génère l'image à partir du prompt d'AutoPSEO avec le CLI Codex (connecté avec ChatGPT) ou le CLI Grok, chacun dans son propre bac à sable, et n'envoie les fichiers qu'à app.autopseo.com.

Pour que seule votre propre IA écrive, choisissez Your own AI, through MCP comme rédacteur et gardez New articles per week au-dessus de 0. Ce rythme pilote aussi la revue quotidienne et le réapprovisionnement qui alimentent la file : à 0, aucun nouveau sujet n'y parvient.

Mettez votre contenu SEO en pilote automatique

Connectez Search Console et votre site. AutoPSEO l'analyse et planifie aussitôt les premiers sujets. Sans carte bancaire.