Scrivere con la tua AI tramite MCP

Il motore dei contenuti ha un secondo autore: la tua AI. Qualsiasi client MCP collegato ad AutoPSEO, come Claude Code, le app di Claude o Cursor, può prendere argomenti dalla stessa coda, leggere lo stesso brief e le stesse regole e inviare bozze che superano gli stessi controlli dell'autore di AutoPSEO. Le bozze scritte in questo modo non vengono conteggiate nella quota mensile di articoli. Puoi lavorarci in una chat oppure lasciare che un'esecuzione autonoma scriva con una cadenza programmata.

Collega la tua AI

L'endpoint MCP è https://app.autopseo.com/mcp. Ci sono due modi per accedere, entrambi nella pagina MCP & API del tuo account:

• Accedi con OAuth in "Connect by signing in". In Claude Code: claude mcp add --transport http autopseo https://app.autopseo.com/mcp, poi /mcp e Authenticate.
• Una chiave API che inizia con apk_live_, inviata come Authorization: Bearer <key>. Gli strumenti sui contenuti che modificano qualcosa richiedono una chiave Read & write; una chiave Read only consente di usare solo gli strumenti di lettura.

Conta anche il tuo ruolo: un membro con accesso in sola visualizzazione può usare solo gli strumenti di lettura, e un membro invitato a una parte delle proprietà vede solo quelle. Il catalogo completo, compresi gli strumenti di Search Console, è nella pagina MCP; la gestione delle chiavi è descritta in MCP & ChatGPT app.

In Settings della pagina Content, Who writes the topics in the queue stabilisce chi lavora la coda: AutoPSEO, at the pace above oppure Your own AI, through MCP. Se scegli la tua AI, l'autore di AutoPSEO smette di prendere in carico le attività in coda. In entrambi i casi, "Your own AI can write and rewrite articles at any time, whichever you choose here." Per prendere in carico e inviare, il motore deve essere attivo per la proprietà e il piano deve essere attivo.

Gli strumenti per i contenuti

Una chiave di sola lettura, o un membro con accesso in sola visualizzazione, viene respinta da ogni strumento che non sia di lettura. Gli strumenti che pubblicano, rimuovono, uniscono o eliminano un percorso indicano all'AI di agire solo con il tuo via libera.

Scrivere un articolo

1. Scegli un'attività. content_list_tasks mostra cosa è in coda; content_find_pages verifica se il tuo sito copre già l'argomento.
2. Prendila in carico. content_claim { taskId } mantiene l'attività in carico per due ore, e una nuova richiesta rinnova il blocco. Puoi anche prendere in carico un articolo pubblicato con pageId e kind, oppure partire da una parola chiave, eventualmente con la chiave di un tipo di contenuto. Una parola chiave passa prima attraverso i filtri.
3. Leggi il brief. content_get_brief restituisce rules (le stesse regole di scrittura che riceve l'autore di AutoPSEO), il brief, allowedLinks e cover.wanted. La prima chiamata analizza i risultati di ricerca e consuma crediti di ricerca; le chiamate successive per la stessa attività sono gratuite.
4. Scrivi e invia. Invia l'articolo come JSON nel formato descritto in consegna con content_submit. Se non supera un controllo, la risposta inizia con "Not saved. Fix these and submit again:" seguito dall'elenco; i link non presenti in allowedLinks vengono trasformati in testo in grassetto. Quando l'attività modifica un articolo pubblicato, passa baseRev, la revisione da cui sei partito; se nel frattempo l'articolo è cambiato, l'invio viene rifiutato come conflitto.
5. Traduci. Per ogni altra lingua usa content_get_translation, poi content_submit_translation. Le lingue possono essere inviate in parallelo. Vedi traduzione.
6. Aggiungi una copertina quando il brief indica che è richiesta (vedi sotto).
7. Pubblica. La bozza resta in attesa di revisione. content_publish { taskId } la approva, operazione che lo strumento riserva ai casi in cui sei tu a dare il via libera.

Un blocco scaduto viene rilasciato dalla pianificazione ogni cinque minuti: l'attività torna in coda. content_decline rifiuta un'attività in modo definitivo con un motivo da 3 a 300 caratteri, così non verrà più proposta.

Rivedere una bozza in revisione

Quando un revisore chiede modifiche, non serve rifiutare la bozza:

1. content_claim con l'attività (o la pagina, o la parola chiave) riporta la tua bozza in fase di scrittura, così nessuno può pubblicarla nel frattempo.
2. content_get_page restituisce la bozza come draft.
3. content_submit salva la revisione successiva allo stesso indirizzo e segna la vecchia bozza come sostituita.
4. Invia di nuovo le traduzioni: la nuova revisione contiene solo la propria lingua, e content_get_translation propone come current la traduzione della bozza sostituita.

Se il blocco scade prima, la bozza torna in revisione senza modifiche.

Prompt

Il server offre anche dei prompt, che in Claude Code compaiono come comandi slash, per esempio /mcp__autopseo__write-articles:

Copertine dalla tua AI

Quando il tuo sito mostra le copertine, content_get_brief indica cover.wanted. La tua AI può consegnare un'immagine da lei creata con il campo cover di content_submit (un url https, oppure data in base64 fino a 2,5 MB), caricare il file con PUT al coverUploadUrl restituito da content_submit, oppure impostarla in seguito con content_set_cover. Può anche generarla a partire dal prompt di AutoPSEO con content_cover. Formati, dimensioni e controlli sono descritti in copertine.

Quanto costa

• Le bozze e le traduzioni della tua AI non vengono conteggiate nella quota mensile di articoli, e inviarle è gratuito.
• La prima analisi dei risultati di ricerca per il brief, e la chiamata al modello che sceglie un tipo di contenuto per una parola chiave adatta a due tipi, consumano crediti di ricerca.
• Aggiungere argomenti, rifiutare e gli strumenti di lettura sono gratuiti. Approvare una bozza a cui mancano delle lingue, su un sito in cui AutoPSEO traduce, avvia le traduzioni usando crediti di ricerca.

Esecuzioni autonome su Mac

content_instructions restituisce tutto ciò che un'esecuzione autonoma deve fare per una proprietà: generare il report, completare ciò che un'esecuzione precedente ha lasciato in sospeso, verificare la copertura prima di spendere per un brief, rifiutare i duplicati, scrivere, tradurre, aggiungere le copertine e pubblicare solo quando la revisione del sito è disattivata. Non rimuove mai articoli dalla pubblicazione e non esegue rollback, e si conclude con una riga leggibile da uno script:

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

L'autore di AutoPSEO è un piccolo insieme di script per macOS che esegue tutto questo con il tuo Claude Code e il tuo abbonamento a Claude, tramite launchd. Contattaci per riceverli. Configurazione:

1. Collega Claude Code ad AutoPSEO (il connettore in Claude, oppure claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcp e Authenticate in /mcp).
2. Esegui ./install.sh. Crea ~/.autopseo/ con run.sh, cover-mcp.mjs e un writer.json di esempio, più un job launchd che parte ogni giorno alle 15:07 (AUTOPSEO_HOUR e AUTOPSEO_MINUTE permettono di cambiarlo). Il job non è ancora caricato.
3. Compila ~/.autopseo/writer.json: properties (ciascuna con id e un limit facoltativo di nuovi articoli per esecuzione, 8 per impostazione predefinita, al massimo 20), model e fallbackModel, un subagentModel facoltativo per i subagent di traduzione, everyDays tra un'esecuzione e l'altra di una proprietà (3 per impostazione predefinita) e covers (codex,grok, oppure off).
4. Prova un'esecuzione: AUTOPSEO_FORCE=1 ~/.autopseo/run.sh, poi leggi ~/.autopseo/logs/history.log.
5. Carica la pianificazione con launchctl load ~/Library/LaunchAgents/com.autopseo.writer.plist.

Ogni esecuzione avvia un claude -p per proprietà, autorizzato a usare solo gli strumenti e i subagent di AutoPSEO: niente shell, niente file, niente web. Un'esecuzione conta come riuscita solo se stampa la riga del risultato. Quando values è maggiore di 0, una seconda sessione si occupa dei nuovi percorsi delle pagine tipizzate: può cercare e leggere sul web, ma accede solo agli strumenti necessari a un'attività sui valori. Le esecuzioni che falliscono per un motivo passeggero vengono ritentate fino a tre volte, un limite di utilizzo interrompe le proprietà rimanenti, un watchdog termina un'esecuzione dopo cinque ore e nel frattempo il Mac resta attivo.

Per le copertine, gli script forniscono a Claude Code un secondo server MCP con un solo strumento, make_cover, che genera l'immagine a partire dal prompt di AutoPSEO con la Codex CLI (con accesso tramite ChatGPT) o la Grok CLI, ciascuna nel proprio sandbox, e carica i file solo su app.autopseo.com.

Per far scrivere solo la tua AI, scegli Your own AI, through MCP come autore e mantieni New articles per week maggiore di 0. Il ritmo determina anche la revisione giornaliera e il rifornimento che alimentano la coda, quindi con il valore 0 nessun nuovo argomento la raggiunge.