Publicar desde un agente de código
Conecta Codex o Claude Code, carga un archivo local y verifica una publicación programada o publicada sin trasladar tu trabajo a otra aplicación.
Tienes una foto de producto en tu computador y quieres publicarla en el Instagram de tu marca. Tu agente de código puede preparar el borrador, cargar el archivo original y solicitar la publicación mediante HeyMark.
Necesitas una cuenta de HeyMark con acceso al contenido de la marca, una cuenta social conectada y un cliente que pueda leer el archivo local y hacer solicitudes HTTP. Un archivo de tu computador no está disponible automáticamente en una conversación remota.
Conecta tu cliente
Para Codex, ejecuta:
codex mcp add heymark --url https://mcp.heymark.aiSi falta autorizar, ejecuta codex mcp login heymark. Aprueba el acceso con tu propia cuenta de HeyMark en el navegador. El navegador se usa para autorizar; la transferencia ocurre en el entorno que puede leer tu archivo.
Para Claude Code, ejecuta:
claude mcp add --transport http heymark https://mcp.heymark.aiCompleta el flujo OAuth del cliente. Para otros clientes, consulta la guía de conexión. El acceso MCP de HeyMark es gratis en todos los planes. Se mantienen los límites del producto y los costos de IA; tu cliente puede cobrar por separado.
Elige la marca y prepara el borrador
Pide al cliente que actualice su lista de herramientas y use list_brands y get_brand_context. Elige la marca de forma explícita si tienes varias. Sigue los argumentos que devuelve tools/list: tus permisos y la compatibilidad del cliente determinan las herramientas disponibles.
Preparar un borrador
Lista mis marcas de HeyMark y pregunta cuál usar. Para esa marca, revisa la cuenta de Instagram conectada. Prepara un borrador para anunciar nuestro nuevo producto con la foto de [ruta absoluta del archivo] y estas indicaciones: [tus indicaciones]. Muéstrame el texto, destino y archivos antes de programar o publicar.
create_post crea contenido de planificación. Una fecha de planificación no equivale a una programación. Para reutilizar contenido guardado, usa duplicate_post y revisa el estado de los archivos: la copia puede seguir importándolos. Guarda el nuevo post_id y úsalo durante el resto del proceso.
Carga el archivo local
Los clientes de código usan prepare_post_media_upload y después attach_post_media. La preparación requiere una publicación existente con destino, el tipo MIME del archivo y su tamaño en bytes. Devuelve un objeto upload e instrucciones en upload_instructions.
- Pide al agente que lea el archivo original en su entorno y solicite el permiso de carga.
- Sigue las instrucciones TUS reanudables: crea la carga con POST y envía los bytes originales con PATCH a la ubicación recibida, en los fragmentos indicados. No pegues el archivo como base64 en la conversación. Base64 solo se usa para los valores de los metadatos TUS.
- Adjunta el archivo solo cuando el
Upload-Offsetdel servidor sea igual afile_size_bytes. Pasa la rutastorage_pathrecibida aattach_post_media. - Procesa los archivos de un carrusel en orden. Vuelve a leer la publicación para verificar los archivos adjuntos y su orden. Mantén privados los tokens de carga.
Cargar y verificar
Usa prepare_post_media_upload para este borrador y archivo local. Sigue sus upload_instructions con un cliente HTTP y llama a attach_post_media con el storage_path recibido. Vuelve a leer la publicación y muestra el texto, destino, archivos y estado de importación. Detente antes de programar o publicar.
Si la carga se interrumpe, usa HEAD en la misma ubicación para recuperar la posición antes de continuar. Si el permiso vence, prepara una carga nueva. Nunca adjuntes un archivo incompleto. Los clientes con aplicaciones MCP integradas también pueden usar open_post_media_manager; los clientes de código no necesitan ese selector.
Programa o publica después de revisar
Lee el texto, los archivos y los ajustes pertinentes con get_post_context. Confirma la cuenta, formato, orden de archivos y zona horaria. Que los archivos estén listos no demuestra que se cumplan todos los requisitos de publicación de la plataforma: atiende los errores de validación que devuelva la herramienta de escritura.
| Lo que quieres hacer | Comportamiento de la herramienta |
|---|---|
| Seguir trabajando en el borrador | Actualiza su contenido guardado. Sigue siendo contenido de planificación. |
| Publicar en una fecha futura | schedule_post se ejecuta directamente. Aprueba la fecha, hora y zona horaria exactas antes de pedir al agente que la use. La publicación programada puede publicarse después sin otra confirmación. |
| Publicar ahora | publish_post devuelve primero una vista previa y un confirm_token. Aprueba esa vista previa; el cliente repite los mismos argumentos con el token. |
| Cancelar una publicación futura | Usa unschedule_post y vuelve a leer su estado. |
Los tokens de confirmación vencen después de cinco minutos y están ligados a la acción y su vista previa. Si cambian los argumentos o el contenido de destino, necesitas una nueva vista previa. No reutilices la aprobación para otro texto, cuenta o conjunto de archivos.
Después de programar, verifica la fecha recibida y vuelve a leerla. Después de publicar, revisa el estado real y el enlace de la plataforma cuando esté disponible. Una solicitud aceptada o un trabajo en cola no demuestra que la plataforma haya publicado.
Recupera el proceso sin duplicar la publicación
| Lo que ocurrió | Siguiente paso |
|---|---|
| La escritura agotó el tiempo de espera o su resultado es incierto | Lee el estado actual de la publicación o conversación antes de reintentar. Una confirmación completada puede devolver su resultado guardado, pero un resultado incierto del proveedor no autoriza otro envío. |
| La vista previa venció o cambió | Solicita una nueva vista previa y aprueba su contenido actual. |
| La respuesta es demasiado grande | Solicita menos secciones de get_post_context o una página más pequeña; sigue el cursor o desplazamiento recibido para leer el resto. |
| El acceso fue rechazado | Verifica la marca elegida, el área de acceso y la facturación. Reconecta solo si necesitas renovar la autorización. |
| La plataforma rechazó la solicitud | Lee el error y corrige su causa. Conserva la misma publicación en lugar de recrearla automáticamente. |
Repetir create_post o duplicate_post puede crear otro registro. Conserva los identificadores recibidos, verifica el estado entre pasos y consulta la referencia de herramientas al continuar.
Ahora ponlo a trabajar.
HeyMark aprende las reglas que acabas de escribir, y con eso planifica, redacta, programa y responde en esa voz. Tú apruebas.