Ir para o conteúdo
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.

Propriedade → Conteúdo → Configurações8 min de leitura

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 /mcp e Authenticate.
  • Uma chave de API que começa por apk_live_, enviada como Authorization: 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

FerramentaAcessoO que faz
content_instructionsleituraToda uma execução sem supervisão para uma propriedade, construída a partir das suas definições
content_reportleituraDefinições, tipos de conteúdo, quota, contagem de tarefas, os 20 artigos publicados mais recentes e as entregas recusadas
content_list_tasksleituraTarefas, das mais promissoras para as menos, com indicação de quem tem cada uma
content_find_pagesleituraPáginas do seu site que correspondem a uma pesquisa, para verificar a cobertura e escolher ligações
content_get_pageleituraO texto publicado de um artigo, o rascunho em revisão, as suas revisões e as pesquisas ao longo de 28 dias
content_get_translationleituraUm idioma: o original, as regras do tradutor e a tradução atual
content_get_briefpagoAs regras de escrita, o briefing, as ligações permitidas, o endereço de uma página tipificada e se é pedida uma capa
content_add_topicsescritaPlaneia de 1 a 200 tópicos; passam pelos filtros e pela revisão
content_claimescritaReserva uma tarefa durante duas horas: por tarefa, por página (rewrite, optimize ou refresh) ou por palavra-chave
content_submitescritaVerifica e guarda um rascunho; nada é guardado enquanto houver erros
content_submit_translationescritaVerifica e guarda um idioma de um rascunho ou de um artigo publicado
content_coverescritaVerifica uma cena e devolve o prompt da imagem, as referências e um endereço de envio
content_set_coverescritaDefine ou substitui uma capa, ou obtém um endereço de envio para uma
content_publishescritaAprova um rascunho ou repõe uma revisão anterior
content_unpublishescritaRetira um artigo do ar
content_mergeescritaJunta um artigo a outra página, com um 301
content_declineescritaRecusa definitivamente uma tarefa, com um motivo
content_propose_valueescritaPropõe um novo valor para um tipo de conteúdo tipificado, depois de consultar o seu site
content_submit_valueescritaEnvia para revisão os dados de um novo valor
content_remove_pathescritaPede 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

  1. Escolha uma tarefa. content_list_tasks mostra o que está na fila; content_find_pages verifica se o seu site já cobre o tema.
  2. 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 com pageId e kind, ou começar por uma palavra-chave, opcionalmente com a chave de um tipo de conteúdo. Uma palavra-chave passa primeiro pelos filtros.
  3. Leia o briefing. content_get_brief devolve rules (as mesmas regras de escrita que o redator do AutoPSEO recebe), o brief, allowedLinks e cover.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.
  4. 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 de allowedLinks são convertidas em texto a negrito. Quando a tarefa altera um artigo publicado, passe baseRev, a revisão a partir da qual trabalhou; se o artigo entretanto mudou, o envio é recusado por conflito.
  5. Traduza. Para cada um dos outros idiomas, use content_get_translation e depois content_submit_translation. Os idiomas podem ser enviados em paralelo. Consulte tradução.
  6. Adicione uma capa quando o briefing indicar que é pedida (abaixo).
  7. 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:

  1. content_claim com 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.
  2. content_get_page devolve o rascunho como draft.
  3. content_submit guarda a revisão seguinte no mesmo endereço e marca o rascunho antigo como substituído.
  4. Envie de novo as traduções: a nova revisão contém apenas o seu próprio idioma, e content_get_translation oferece a tradução do rascunho substituído como current.

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:

PromptArgumentosO que percorre
write-articlessite, count (1 a 10)Escrever artigos da fila, passo a passo
revise-draftsite, draft, changesRever um rascunho que aguarda revisão
optimize-pagesite, pageMelhorar um artigo publicado
refresh-decayedsite, limit (até 10)Atualizar artigos que perderam cliques
connect-repoarticlesUrlConstruir 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:

  1. Ligue o Claude Code ao AutoPSEO (o conector no Claude, ou claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcp e Authenticate em /mcp).
  2. Execute ./install.sh. Cria ~/.autopseo/ com run.sh, cover-mcp.mjs e um writer.json de exemplo, e uma tarefa do launchd que corre todos os dias às 15:07 (AUTOPSEO_HOUR e AUTOPSEO_MINUTE alteram a hora). A tarefa ainda não está carregada.
  3. Preencha ~/.autopseo/writer.json: properties (cada id, com um limit opcional de novos artigos por execução, por omissão 8, no máximo 20), model e fallbackModel, um subagentModel opcional para os subagentes de tradução, everyDays entre execuções de uma propriedade (por omissão 3) e covers (codex,grok, ou off).
  4. Experimente uma execução: AUTOPSEO_FORCE=1 ~/.autopseo/run.sh e depois leia ~/.autopseo/logs/history.log.
  5. 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.

Coloque o seu conteúdo de SEO no piloto automático

Conecte o Search Console e o seu site. O AutoPSEO analisa tudo e planeja os primeiros temas na hora. Sem cartão de crédito.