Documentação
Escrever com a sua própria IA via MCP
Deixe o Claude ou outro cliente MCP escrever a partir da fila de conteúdo: reservar tópicos, ler briefings, enviar rascunhos, traduções e capas, ou funcionar sem supervisão num Mac.
O motor de conteúdo tem um segundo redator: a sua própria IA. Qualquer cliente MCP com sessão iniciada no AutoPSEO, como o Claude Code, as apps do Claude ou o Cursor, pode pegar em tópicos da mesma fila, ler o mesmo briefing e as mesmas regras, e enviar rascunhos que passam pelas mesmas verificações do redator do AutoPSEO. Os rascunhos escritos assim não contam para a quota mensal de artigos. Pode trabalhar com ela numa conversa ou deixar que uma execução sem supervisão escreva de forma agendada.
Ligue a sua IA
O endpoint MCP é https://app.autopseo.com/mcp. Há duas formas de entrar, ambas na página MCP & API da sua conta:
- Iniciar sessão com OAuth em "Connect by signing in". No Claude Code:
claude mcp add --transport http autopseo https://app.autopseo.com/mcp, depois/mcpe Authenticate. - Uma chave de API que começa por
apk_live_, enviada comoAuthorization: Bearer <key>. As ferramentas de conteúdo que alteram dados exigem uma chave Read & write; uma chave Read only só dá acesso às ferramentas de leitura.
A sua função também conta: um membro com acesso de visualização só pode usar ferramentas de leitura, e um membro convidado para algumas propriedades vê apenas essas. O catálogo completo, incluindo as ferramentas do Search Console, está na página MCP; a gestão de chaves está em MCP & ChatGPT app.
Em Settings, na página Content, a opção Who writes the topics in the queue decide quem trabalha a fila: AutoPSEO, at the pace above ou Your own AI, through MCP. Com a sua própria IA escolhida, o redator do AutoPSEO deixa de pegar em tarefas da fila. Em qualquer dos casos, "Your own AI can write and rewrite articles at any time, whichever you choose here." Para reservar e enviar, o motor tem de estar ativo para a propriedade e o plano tem de estar ativo.
As ferramentas de conteúdo
| Ferramenta | Acesso | O que faz |
|---|---|---|
content_instructions | leitura | Toda uma execução sem supervisão para uma propriedade, construída a partir das suas definições |
content_report | leitura | Definições, tipos de conteúdo, quota, contagem de tarefas, os 20 artigos publicados mais recentes e as entregas recusadas |
content_list_tasks | leitura | Tarefas, das mais promissoras para as menos, com indicação de quem tem cada uma |
content_find_pages | leitura | Páginas do seu site que correspondem a uma pesquisa, para verificar a cobertura e escolher ligações |
content_get_page | leitura | O texto publicado de um artigo, o rascunho em revisão, as suas revisões e as pesquisas ao longo de 28 dias |
content_get_translation | leitura | Um idioma: o original, as regras do tradutor e a tradução atual |
content_get_brief | pago | As regras de escrita, o briefing, as ligações permitidas, o endereço de uma página tipificada e se é pedida uma capa |
content_add_topics | escrita | Planeia de 1 a 200 tópicos; passam pelos filtros e pela revisão |
content_claim | escrita | Reserva uma tarefa durante duas horas: por tarefa, por página (rewrite, optimize ou refresh) ou por palavra-chave |
content_submit | escrita | Verifica e guarda um rascunho; nada é guardado enquanto houver erros |
content_submit_translation | escrita | Verifica e guarda um idioma de um rascunho ou de um artigo publicado |
content_cover | escrita | Verifica uma cena e devolve o prompt da imagem, as referências e um endereço de envio |
content_set_cover | escrita | Define ou substitui uma capa, ou obtém um endereço de envio para uma |
content_publish | escrita | Aprova um rascunho ou repõe uma revisão anterior |
content_unpublish | escrita | Retira um artigo do ar |
content_merge | escrita | Junta um artigo a outra página, com um 301 |
content_decline | escrita | Recusa definitivamente uma tarefa, com um motivo |
content_propose_value | escrita | Propõe um novo valor para um tipo de conteúdo tipificado, depois de consultar o seu site |
content_submit_value | escrita | Envia para revisão os dados de um novo valor |
content_remove_path | escrita | Pede ao seu site que retire o caminho de um valor |
Uma chave só de leitura, ou um membro com acesso de visualização, vê recusada qualquer ferramenta que não seja de leitura. As ferramentas que publicam, retiram do ar, juntam ou removem um caminho indicam à IA que só deve agir com a sua autorização.
Escrever um artigo
- Escolha uma tarefa.
content_list_tasksmostra o que está na fila;content_find_pagesverifica se o seu site já cobre o tema. - Reserve-a.
content_claim { taskId }reserva a tarefa durante duas horas, e reservar de novo renova a reserva. Também pode reservar um artigo publicado compageIdekind, ou começar por uma palavra-chave, opcionalmente com a chave de um tipo de conteúdo. Uma palavra-chave passa primeiro pelos filtros. - Leia o briefing.
content_get_briefdevolverules(as mesmas regras de escrita que o redator do AutoPSEO recebe), obrief,allowedLinksecover.wanted. A primeira chamada pesquisa os resultados de pesquisa e consome créditos de pesquisa; as chamadas seguintes para a mesma tarefa são gratuitas. - Escreva e envie. Envie o artigo em JSON, no formato descrito em entrega, com
content_submit. Se falhar uma verificação, a resposta começa por "Not saved. Fix these and submit again:" seguida da lista; as ligações fora deallowedLinkssão convertidas em texto a negrito. Quando a tarefa altera um artigo publicado, passebaseRev, a revisão a partir da qual trabalhou; se o artigo entretanto mudou, o envio é recusado por conflito. - Traduza. Para cada um dos outros idiomas, use
content_get_translatione depoiscontent_submit_translation. Os idiomas podem ser enviados em paralelo. Consulte tradução. - Adicione uma capa quando o briefing indicar que é pedida (abaixo).
- Publique. O rascunho fica à espera de revisão.
content_publish { taskId }aprova-o, algo que a ferramenta reserva para quando o disser.
Uma reserva que expira é libertada pelo agendamento de cinco minutos: a tarefa volta à fila. content_decline recusa definitivamente uma tarefa com um motivo de 3 a 300 caracteres, para que nunca mais seja proposta.
Rever um rascunho em revisão
Quando um revisor pede alterações, não é preciso recusar o rascunho:
content_claimcom a tarefa (ou a página, ou a palavra-chave) devolve o seu rascunho ao estado de escrita, para que ninguém o publique entretanto.content_get_pagedevolve o rascunho comodraft.content_submitguarda a revisão seguinte no mesmo endereço e marca o rascunho antigo como substituído.- Envie de novo as traduções: a nova revisão contém apenas o seu próprio idioma, e
content_get_translationoferece a tradução do rascunho substituído comocurrent.
Se a reserva expirar antes, o rascunho volta à revisão sem alterações.
Prompts
O servidor também disponibiliza prompts, que aparecem no Claude Code como comandos de barra, por exemplo /mcp__autopseo__write-articles:
| Prompt | Argumentos | O que percorre |
|---|---|---|
write-articles | site, count (1 a 10) | Escrever artigos da fila, passo a passo |
revise-draft | site, draft, changes | Rever um rascunho que aguarda revisão |
optimize-page | site, page | Melhorar um artigo publicado |
refresh-decayed | site, limit (até 10) | Atualizar artigos que perderam cliques |
connect-repo | articlesUrl | Construir o recetor de webhook assinado no código do seu site |
Capas feitas pela sua própria IA
Quando o seu site mostra capas, content_get_brief indica cover.wanted. A sua IA pode entregar uma imagem que criou através do campo cover de content_submit (um url https, ou data em base64 até 2,5 MB), enviar o ficheiro com PUT para o coverUploadUrl que content_submit devolve, ou defini-la mais tarde com content_set_cover. Também pode desenhá-la a partir do prompt do próprio AutoPSEO com content_cover. Os formatos, tamanhos e verificações estão em capas.
Quanto custa
- Os rascunhos e as traduções da sua própria IA não contam para a quota mensal de artigos, e o envio é gratuito.
- A primeira consulta dos resultados de pesquisa pelo briefing, e a chamada ao modelo que escolhe um tipo de conteúdo para uma palavra-chave que dois tipos poderiam receber, consomem créditos de pesquisa.
- Adicionar tópicos, recusar e as ferramentas de leitura são gratuitos. Aprovar um rascunho a que faltam idiomas, num site em que o AutoPSEO traduz, inicia traduções com créditos de pesquisa.
Execuções sem supervisão num Mac
content_instructions devolve tudo o que uma execução sem supervisão deve fazer para uma propriedade: relatório, concluir o que uma execução anterior deixou, verificar a cobertura antes de gastar num briefing, recusar duplicados, escrever, traduzir, adicionar capas e publicar apenas quando a revisão do site estiver desativada. Nunca retira artigos do ar nem os reverte, e termina com uma linha que um script consegue ler:
AUTOPSEO_RESULT property=<id> published=<n> review=<n> declined=<n> failed=<n> values=<n>
O redator do AutoPSEO é um pequeno conjunto de scripts para macOS que executa isto com o seu próprio Claude Code, na sua própria subscrição do Claude, sob o launchd. Contacte-nos para os obter. Configuração:
- Ligue o Claude Code ao AutoPSEO (o conector no Claude, ou
claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcpe Authenticate em/mcp). - Execute
./install.sh. Cria~/.autopseo/comrun.sh,cover-mcp.mjse umwriter.jsonde exemplo, e uma tarefa do launchd que corre todos os dias às 15:07 (AUTOPSEO_HOUReAUTOPSEO_MINUTEalteram a hora). A tarefa ainda não está carregada. - Preencha
~/.autopseo/writer.json:properties(cadaid, com umlimitopcional de novos artigos por execução, por omissão 8, no máximo 20),modelefallbackModel, umsubagentModelopcional para os subagentes de tradução,everyDaysentre execuções de uma propriedade (por omissão 3) ecovers(codex,grok, ouoff). - Experimente uma execução:
AUTOPSEO_FORCE=1 ~/.autopseo/run.she depois leia~/.autopseo/logs/history.log. - Carregue o agendamento com
launchctl load ~/Library/LaunchAgents/com.autopseo.writer.plist.
Cada execução inicia um claude -p por propriedade, com permissão para usar apenas as ferramentas e os subagentes do AutoPSEO: sem shell, sem ficheiros, sem web. Uma execução só conta como bem-sucedida quando imprime a linha de resultado. Quando values é superior a 0, uma segunda sessão trata dos novos caminhos das páginas tipificadas: pode pesquisar e ler a web, mas só tem acesso às ferramentas de que uma tarefa de valor precisa. As execuções que falham por um motivo passageiro são repetidas até três vezes, um limite de utilização interrompe as restantes propriedades, um watchdog termina uma execução ao fim de cinco horas, e o Mac é mantido acordado entretanto.
Para as capas, os scripts dão ao Claude Code um segundo servidor MCP com uma única ferramenta, make_cover, que desenha o prompt do AutoPSEO com a CLI do Codex (com sessão iniciada no ChatGPT) ou com a CLI do Grok, cada uma na sua própria sandbox, e só envia para app.autopseo.com.
Para que só a sua própria IA escreva, escolha Your own AI, through MCP como redator e mantenha New articles per week acima de 0. O ritmo também determina a revisão diária e o reabastecimento que enchem a fila, pelo que, com 0, nenhum tópico novo chega a ela.