Documentación
Escribir con tu propia IA mediante MCP
Deja que Claude u otro cliente MCP escriba desde la cola de contenido: reclama temas, lee briefs, envía borradores, traducciones y portadas, o ejecútalo sin supervisión en un Mac.
El motor de contenido tiene un segundo redactor: tu propia IA. Cualquier cliente MCP con sesión iniciada en AutoPSEO, como Claude Code, las apps de Claude o Cursor, puede tomar temas de la misma cola, leer el mismo brief y las mismas reglas, y enviar borradores que pasan las mismas comprobaciones que el redactor de AutoPSEO. Los borradores escritos de este modo no cuentan para la cuota mensual de artículos. Puedes trabajar con ella en un chat o dejar que una ejecución sin supervisión escriba de forma programada.
Conecta tu IA
El endpoint MCP es https://app.autopseo.com/mcp. Hay dos formas de acceder, ambas en la página MCP & API de tu cuenta:
- Iniciar sesión con OAuth en "Connect by signing in". En Claude Code:
claude mcp add --transport http autopseo https://app.autopseo.com/mcp, luego/mcpy Authenticate. - Una clave de API que empieza por
apk_live_, enviada comoAuthorization: Bearer <key>. Las herramientas de contenido que modifican algo requieren una clave Read & write; una clave Read only solo accede a las herramientas de lectura.
Tu rol también influye: un miembro con acceso de solo visualización solo puede usar herramientas de lectura, y un miembro invitado a algunas propiedades solo ve esas. El catálogo completo, incluidas las herramientas de Search Console, está en la página de MCP; la gestión de claves está en MCP & ChatGPT app.
En Settings de la página Content, Who writes the topics in the queue decide quién trabaja la cola: AutoPSEO, at the pace above o Your own AI, through MCP. Si eliges tu propia IA, el redactor de AutoPSEO deja de tomar tareas de la cola. En cualquier caso, "tu propia IA puede escribir y reescribir artículos en cualquier momento, elijas lo que elijas aquí". Para reclamar y enviar, el motor debe estar activado para la propiedad y el plan debe estar activo.
Las herramientas de contenido
| Herramienta | Acceso | Qué hace |
|---|---|---|
content_instructions | lectura | Toda una ejecución sin supervisión para una propiedad, construida a partir de su configuración |
content_report | lectura | Configuración, tipos de contenido, cuota, recuento de tareas, los 20 artículos publicados más recientes y las entregas rechazadas |
content_list_tasks | lectura | Tareas, las más prometedoras primero, con quién tiene cada una |
content_find_pages | lectura | Páginas de tu sitio que coinciden con una consulta, para comprobar la cobertura y elegir enlaces |
content_get_page | lectura | El texto publicado de un artículo, su borrador en revisión, sus revisiones y sus búsquedas en 28 días |
content_get_translation | lectura | Un idioma: el original, las reglas del traductor y la traducción actual |
content_get_brief | de pago | Las reglas de redacción, el brief, los enlaces permitidos, la dirección de una página tipada y si se quiere una portada |
content_add_topics | escritura | Planifica de 1 a 200 temas; pasan por los filtros y la revisión |
content_claim | escritura | Reserva una tarea durante dos horas: por tarea, por página (rewrite, optimize o refresh) o por palabra clave |
content_submit | escritura | Comprueba y guarda un borrador; no se guarda nada mientras queden errores |
content_submit_translation | escritura | Comprueba y guarda un idioma de un borrador o de un artículo publicado |
content_cover | escritura | Comprueba una escena y obtén el prompt de imagen, las referencias y una dirección de subida |
content_set_cover | escritura | Establece o sustituye una portada, u obtén una dirección de subida para ella |
content_publish | escritura | Aprueba un borrador o restaura una revisión anterior |
content_unpublish | escritura | Retira un artículo |
content_merge | escritura | Fusiona un artículo con otra página, con una redirección 301 |
content_decline | escritura | Rechaza una tarea de forma definitiva, indicando un motivo |
content_propose_value | escritura | Propone un nuevo valor para un tipo de contenido tipado, tras consultarlo con tu sitio |
content_submit_value | escritura | Envía a revisión los datos de un nuevo valor |
content_remove_path | escritura | Pide a tu sitio que retire la ruta de un valor |
Una clave de solo lectura, o un miembro con acceso de solo visualización, es rechazado por todas las herramientas que no sean de lectura. Las herramientas que publican, retiran, fusionan o eliminan una ruta indican a la IA que actúe solo con tu visto bueno.
Escribe un artículo
- Elige una tarea.
content_list_tasksmuestra lo que hay en cola;content_find_pagescomprueba si tu sitio ya lo cubre. - Reclámala.
content_claim { taskId }reserva la tarea durante dos horas, y reclamarla de nuevo renueva la reserva. También puedes reclamar un artículo publicado conpageIdykind, o partir de una palabra clave, con una clave de tipo de contenido opcional. Una palabra clave pasa primero por los filtros. - Lee el brief.
content_get_briefdevuelverules(las mismas reglas de redacción que recibe el redactor de AutoPSEO), elbrief,allowedLinksycover.wanted. La primera llamada investiga los resultados de búsqueda y consume créditos de investigación; las siguientes llamadas para la misma tarea son gratuitas. - Escribe y envía. Envía el artículo como JSON en el formato descrito en entrega con
content_submit. Si no supera una comprobación, la respuesta empieza por "Not saved. Fix these and submit again:" seguida de la lista; los enlaces que no estén enallowedLinksse convierten en texto en negrita. Cuando la tarea modifica un artículo publicado, indicabaseRev, la revisión sobre la que trabajaste; si el artículo ha cambiado entretanto, el envío se rechaza por conflicto. - Traduce. Para cada uno de los demás idiomas, usa
content_get_translationy despuéscontent_submit_translation. Los idiomas pueden enviarse en paralelo. Consulta traducción. - Añade una portada cuando el brief indique que se quiere una (más abajo).
- Publica. El borrador espera en revisión.
content_publish { taskId }lo aprueba, algo que la herramienta reserva para cuando tú lo indiques.
Una reserva que caduca es liberada por la programación de cinco minutos: la tarea vuelve a la cola. content_decline rechaza una tarea de forma definitiva con un motivo de 3 a 300 caracteres, de modo que no se vuelve a proponer.
Revisa un borrador en revisión
Cuando un revisor pide cambios, no hace falta rechazar el borrador:
content_claimcon la tarea (o la página, o la palabra clave) devuelve tu borrador al estado de redacción, de modo que nadie lo publique mientras tanto.content_get_pagedevuelve el borrador comodraft.content_submitguarda la siguiente revisión en la misma dirección y marca el borrador anterior como sustituido.- Vuelve a enviar las traducciones: la nueva revisión solo contiene su propio idioma, y
content_get_translationofrece la traducción del borrador sustituido comocurrent.
Si la reserva caduca antes, el borrador vuelve a revisión sin cambios.
Prompts
El servidor también ofrece prompts, que aparecen en Claude Code como comandos de barra, por ejemplo /mcp__autopseo__write-articles:
| Prompt | Argumentos | Qué recorre |
|---|---|---|
write-articles | site, count (de 1 a 10) | Escribir artículos de la cola, paso a paso |
revise-draft | site, draft, changes | Revisar un borrador que espera en revisión |
optimize-page | site, page | Mejorar un artículo publicado |
refresh-decayed | site, limit (hasta 10) | Actualizar artículos que han perdido clics |
connect-repo | articlesUrl | Construir el receptor de webhooks firmados en el código de tu sitio |
Portadas desde tu propia IA
Cuando tu sitio muestra portadas, content_get_brief indica cover.wanted. Tu IA puede entregar una imagen que haya creado con cover de content_submit (una url https, o data en base64 de hasta 2.5 MB), subir el archivo mediante PUT a la coverUploadUrl que devuelve content_submit, o establecerla más tarde con content_set_cover. También puede generarla a partir del prompt propio de AutoPSEO con content_cover. Los formatos, tamaños y comprobaciones están en portadas.
Cuánto cuesta
- Los borradores y las traducciones de tu propia IA no cuentan para la cuota mensual de artículos, y enviarlos es gratuito.
- La primera consulta del brief a los resultados de búsqueda, y la llamada al modelo que elige un tipo de contenido para una palabra clave que podrían cubrir dos tipos, consumen créditos de investigación.
- Añadir temas, rechazar y las herramientas de lectura son gratuitos. Aprobar un borrador al que le faltan idiomas, en un sitio donde AutoPSEO traduce, inicia las traducciones con créditos de investigación.
Ejecuciones sin supervisión en un Mac
content_instructions devuelve todo lo que debe hacer una ejecución sin supervisión para una propiedad: informar, terminar lo que dejó una ejecución anterior, comprobar la cobertura antes de gastar en un brief, rechazar duplicados, escribir, traducir, añadir portadas y publicar solo cuando la revisión del sitio está desactivada. Nunca retira artículos ni los revierte, y termina con una línea que un script puede leer:
AUTOPSEO_RESULT property=<id> published=<n> review=<n> declined=<n> failed=<n> values=<n>
El redactor de AutoPSEO es un pequeño conjunto de scripts de macOS que ejecuta esto con tu propio Claude Code y tu propia suscripción de Claude, bajo launchd. Contáctanos para obtenerlos. Configuración:
- Conecta Claude Code a AutoPSEO (el conector en Claude, o
claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcpy Authenticate en/mcp). - Ejecuta
./install.sh. Crea~/.autopseo/conrun.sh,cover-mcp.mjsy unwriter.jsonde ejemplo, además de un trabajo de launchd que se ejecuta a diario a las 15:07 (AUTOPSEO_HOURyAUTOPSEO_MINUTElo cambian). El trabajo aún no está cargado. - Rellena
~/.autopseo/writer.json:properties(cadaid, con unlimitopcional de artículos nuevos por ejecución, 8 por defecto, como máximo 20),modelyfallbackModel, unsubagentModelopcional para los subagentes de traducción,everyDaysentre ejecuciones de una propiedad (3 por defecto) ycovers(codex,grok, ooff). - Prueba una ejecución:
AUTOPSEO_FORCE=1 ~/.autopseo/run.sh, y luego lee~/.autopseo/logs/history.log. - Carga la programación con
launchctl load ~/Library/LaunchAgents/com.autopseo.writer.plist.
Cada ejecución inicia un claude -p por propiedad, al que solo se permite usar las herramientas de AutoPSEO y subagentes: sin shell, sin archivos, sin web. Una ejecución cuenta como correcta solo cuando imprime la línea de resultado. Cuando values es mayor que 0, una segunda sesión se encarga de las nuevas rutas de las páginas tipadas: puede buscar y leer en la web, pero solo accede a las herramientas que necesita una tarea de valor. Las ejecuciones que fallan por un motivo pasajero se reintentan hasta tres veces, un límite de uso detiene las propiedades restantes, un watchdog finaliza una ejecución a las cinco horas y el Mac se mantiene activo mientras tanto.
Para las portadas, los scripts proporcionan a Claude Code un segundo servidor MCP con una sola herramienta, make_cover, que genera la imagen a partir del prompt de AutoPSEO con la CLI de Codex (con sesión iniciada en ChatGPT) o la CLI de Grok, cada una en su propio sandbox, y sube archivos únicamente a app.autopseo.com.
Para que solo escriba tu propia IA, elige Your own AI, through MCP como redactor y mantén New articles per week por encima de 0. El ritmo también determina la revisión diaria y el reabastecimiento que llenan la cola, así que con 0 no llega ningún tema nuevo a ella.