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.
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/mcpet Authenticate. - Une clé API commençant par
apk_live_, envoyée sous la formeAuthorization: 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
| Outil | Accès | Fonction |
|---|---|---|
content_instructions | lecture | L'intégralité d'une exécution autonome pour une propriété, construite à partir de ses réglages |
content_report | lecture | Ré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_tasks | lecture | Les tâches, les plus prometteuses en premier, avec la personne qui détient chacune |
content_find_pages | lecture | Les pages de votre site qui correspondent à une requête, pour vérifier la couverture et choisir des liens |
content_get_page | lecture | Le texte en ligne d'un article, son brouillon en relecture, ses révisions et ses recherches sur 28 jours |
content_get_translation | lecture | Une langue : l'original, les règles du traducteur et la traduction actuelle |
content_get_brief | payant | Les 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 | écriture | Planifier de 1 à 200 sujets ; ils passent par les filtres et la relecture |
content_claim | écriture | Réserver une tâche pendant deux heures : par tâche, par page (rewrite, optimize ou refresh) ou par mot-clé |
content_submit | écriture | Vérifier et enregistrer un brouillon ; rien n'est enregistré tant qu'il reste des erreurs |
content_submit_translation | écriture | Vérifier et enregistrer une langue d'un brouillon ou d'un article en ligne |
content_cover | écriture | Vérifier une scène et obtenir le prompt d'image, les références et une adresse d'envoi |
content_set_cover | écriture | Définir ou remplacer un visuel de couverture, ou obtenir une adresse d'envoi pour en téléverser un |
content_publish | écriture | Approuver un brouillon, ou rétablir une révision antérieure |
content_unpublish | écriture | Retirer un article |
content_merge | écriture | Fusionner un article dans une autre page, avec une redirection 301 |
content_decline | écriture | Refuser définitivement une tâche, en indiquant un motif |
content_propose_value | écriture | Proposer une nouvelle valeur pour un type de contenu typé, après interrogation de votre site |
content_submit_value | écriture | Envoyer les faits d'une nouvelle valeur pour relecture |
content_remove_path | écriture | Demander à 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
- Choisir une tâche.
content_list_tasksaffiche ce qui est en file ;content_find_pagesvérifie si votre site couvre déjà le sujet. - 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 avecpageIdetkind, ou partir d'un mot-clé, éventuellement avec une clé de type de contenu. Un mot-clé passe d'abord par les filtres. - Lire le brief.
content_get_briefrenvoierules(les mêmes règles de rédaction que celles du rédacteur d'AutoPSEO), lebrief,allowedLinksetcover.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. - É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 àallowedLinkssont transformés en texte en gras. Lorsque la tâche modifie un article en ligne, transmettezbaseRev, la révision sur laquelle vous avez travaillé ; si l'article a évolué entre-temps, la soumission est refusée pour cause de conflit. - Traduire. Pour chacune des autres langues,
content_get_translation, puiscontent_submit_translation. Les langues peuvent être envoyées en parallèle. Voir traduction. - Ajouter un visuel de couverture lorsque le brief indique qu'il est souhaité (voir plus bas).
- 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 :
content_claimavec la tâche (ou la page, ou le mot-clé) remet votre brouillon en rédaction, afin que personne ne le publie entre-temps.content_get_pagerenvoie le brouillon sous le nomdraft.content_submitenregistre la révision suivante à la même adresse et marque l'ancien brouillon comme remplacé.- Renvoyez les traductions : la nouvelle révision ne contient que sa propre langue, et
content_get_translationpropose la traduction du brouillon remplacé sous le nomcurrent.
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 :
| Prompt | Arguments | Étapes couvertes |
|---|---|---|
write-articles | site, count (1 à 10) | Rédaction d'articles depuis la file, pas à pas |
revise-draft | site, draft, changes | Révision d'un brouillon en attente de relecture |
optimize-page | site, page | Amélioration d'un article en ligne |
refresh-decayed | site, limit (jusqu'à 10) | Mise à jour des articles qui ont perdu des clics |
connect-repo | articlesUrl | Cré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 :
- Connectez Claude Code à AutoPSEO (le connecteur dans Claude, ou
claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcppuis Authenticate sous/mcp). - Lancez
./install.sh. Il crée~/.autopseo/avecrun.sh,cover-mcp.mjset un exemple dewriter.json, ainsi qu'une tâche launchd exécutée chaque jour à 15:07 (AUTOPSEO_HOURetAUTOPSEO_MINUTEpermettent de la modifier). La tâche n'est pas encore chargée. - Renseignez
~/.autopseo/writer.json:properties(chacune avec sonid, et unelimitfacultative de nouveaux articles par exécution, 8 par défaut, 20 au maximum),modeletfallbackModel, unsubagentModelfacultatif pour les sous-agents de traduction,everyDaysentre deux exécutions d'une propriété (3 par défaut) etcovers(codex,grok, ouoff). - Essayez une exécution :
AUTOPSEO_FORCE=1 ~/.autopseo/run.sh, puis consultez~/.autopseo/logs/history.log. - 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.