HeyMark

Publicar en redes sociales desde Claude Code y Codex

Con un comando conectas Claude Code o Codex al servidor MCP de HeyMark, y tu agente crea publicaciones, sube archivos de tu computador, programa y publica en Instagram, TikTok, LinkedIn, Facebook y YouTube. No hay API REST pública: todo pasa por el MCP, con OAuth y con una vista previa que apruebas antes de publicar ahora.

Por HeyMark · Revisado por Crescente Martinez, CMO y cofundador de HeyMark · Actualizado el

Tienes una carpeta con 12 imágenes de una campaña y un archivo con los textos. Le pides a tu agente de código que arme las publicaciones, suba cada imagen y te muestre el plan de fechas; cuando lo apruebas, las programa en Instagram y LinkedIn. Eso es publicar en redes sociales desde Claude Code o Codex con HeyMark: el agente trabaja con los archivos que ya están en tu computador y deja todo en el calendario de tu marca, sin pasar por otra app.

La diferencia con Claude o ChatGPT en el navegador es el archivo. Un archivo de tu computador no llega solo a una conversación remota; un agente de código sí puede leerlo y transferirlo a HeyMark.

Conecta Claude Code o Codex con un comando

Para Claude Code:

claude mcp add --transport http heymark https://mcp.heymark.ai

La primera vez que lo uses, el navegador abre HeyMark para que apruebes el acceso.

Para Codex:

codex mcp add heymark --url https://mcp.heymark.ai

Si la autorización queda pendiente, ejecuta codex mcp login heymark y apruébala en el navegador. Desde ahí, usar Codex para redes sociales funciona igual que Claude Code.

No hay llaves que generar ni aplicación que registrar: el servidor usa OAuth 2.1 con PKCE y registro dinámico, así que tu cliente se registra solo la primera vez. Para probar la conexión, pídele al agente que liste tus marcas.

Cómo sube tu agente un archivo local

Subir una imagen o un video tiene tres pasos, y tu agente los encadena:

  1. Preparar la carga. Con la publicación ya creada y su destino elegido, el agente le pide a HeyMark un permiso de carga con el tipo y el tamaño del archivo (prepare_post_media_upload). HeyMark le devuelve las instrucciones.
  2. Transferir el archivo. El agente lee el original en tu computador y lo envía siguiendo esas instrucciones, en una carga reanudable. El archivo no pasa por la conversación como texto.
  3. Adjuntarlo. Cuando la carga está completa, el agente adjunta el archivo a la publicación (attach_post_media) y la vuelve a leer para verificar. En un carrusel, los archivos van en orden.

Tres formas de publicar en redes sociales desde Claude Code o Codex

Genera los slides de un carrusel y déjalo listo

Si tus carruseles salen de una plantilla o de un script que genera imágenes, el agente puede crearlas en tu repo, armar la publicación, subirlas en orden y dejarla lista para programar.

Carrusel desde archivos locales

En la carpeta ./carrusel-lanzamiento hay 6 imágenes numeradas y un archivo texto.md con el copy. Crea en HeyMark un borrador de carrusel para Instagram con ese texto, sube las imágenes en orden y vuelve a leer la publicación. Muéstrame el texto, la cuenta, los archivos y su orden, y detente antes de programar.

Un reporte semanal en un archivo markdown

El agente lee el resumen de los últimos 7 días (seguidores, visualizaciones, interacciones y mejores publicaciones, contra el periodo anterior) y lo escribe en tu repo. Si lo corres cada lunes, el historial de tus redes queda versionado junto al resto del trabajo.

Reporte semanal

Usa HeyMark para ver cómo le fue a mi marca en los últimos 7 días: seguidores, visualizaciones e interacciones por red, comparados con el periodo anterior, y las 3 mejores publicaciones. Escríbelo en reportes/semana.md con una tabla por red y tres conclusiones. Si falta un dato, dilo en vez de estimarlo.

Una campaña completa desde una carpeta, con aprobación

Para un lanzamiento: una carpeta con los archivos y una planilla con la red, la fecha, la hora y el texto de cada pieza. El agente crea un borrador por fila, sube cada archivo y te muestra la tabla completa. Programa solo cuando apruebas, porque programar se ejecuta directo.

Campaña desde una carpeta

En ./campana hay imágenes y un archivo plan.csv con las columnas archivo, red, fecha, hora y texto. Crea un borrador en HeyMark por cada fila, sube su archivo y muéstrame una tabla con red, fecha, hora en mi zona horaria, texto y archivo. No programes nada hasta que te escriba “apruebo”. Después programa cada una y vuelve a leer las fechas para confirmarlas.

TikTok también entra en estos flujos, con videos y carruseles de fotos con título. Lo que puede hacer el agente en esa red está en MCP de TikTok.

Qué pide confirmación y qué no

Acción Qué pasa
Crear o editar borradores y subir archivos Se ejecuta directo. Sigue siendo planificación: no sale nada.
Programar Se ejecuta directo, y lo programado se publica a su hora sin otra confirmación. Aprueba fecha, hora y zona horaria antes de pedirlo.
Publicar ahora Devuelve una vista previa y publica cuando la apruebas.
Responder comentarios o DMs, ocultar o borrar comentarios, cambiar automatizaciones También pasan por una vista previa que apruebas.

Cada aprobación vence a los cinco minutos y vale solo para esa acción: si cambia el texto, la cuenta o los archivos, hace falta una vista previa nueva. Si una escritura queda en duda, el agente debe leer el estado antes de reintentar, porque repetir la creación puede duplicar el borrador. El tope es de 60 llamadas de herramientas por minuto.

La guía Publicar desde un agente de código tiene el detalle técnico completo, con la recuperación de errores paso a paso. La referencia de cada herramienta está en la documentación del MCP.

No hay API REST, y cuándo necesitas una

HeyMark no tiene API REST pública todavía. El MCP es la puerta de entrada y cubre lectura y escritura, pero está pensado para un asistente que trabaja con tu cuenta y tus permisos, no para que tu producto publique en nombre de tus usuarios. Si estás construyendo eso, te conviene una API de publicación. Explicamos la diferencia en API o MCP para redes sociales y comparamos opciones para desarrolladores en mejores MCP para redes sociales.

Si lo tuyo es el chat y no la terminal, Claude con HeyMark hace lo mismo sin comandos, salvo subir archivos de tu computador.

Preguntas frecuentes

¿Claude Code puede publicar en Instagram?

Sí. Con HeyMark conectado por MCP, Claude Code crea la publicación, sube tus archivos locales y la programa o la publica. Publicar ahora espera que apruebes una vista previa.

¿Necesito una API key para conectar Codex?

No. Agregas el servidor con codex mcp add y apruebas el acceso en el navegador con tu cuenta de HeyMark. Si la autorización quedó pendiente, codex mcp login heymark la vuelve a abrir.

¿Qué pasa si se corta la subida de un archivo?

El agente recupera la posición de la carga y sigue desde ahí. Si el permiso de carga ya venció, prepara uno nuevo, y un archivo incompleto nunca se adjunta a la publicación.

¿Cuánto cuesta?

El MCP no tiene costo extra en ningún plan de HeyMark, que parte en $12 USD al mes con 14 días de prueba. Tu suscripción de Claude Code o Codex va aparte.

¿Funciona con otros agentes de código?

Sí, con cualquier cliente MCP compatible con OAuth. Usa la misma URL, https://mcp.heymark.ai, y el cliente se registra solo la primera vez que conecta.

Míralo con tus propias cuentas.

Conecta Instagram, TikTok, Facebook, LinkedIn o YouTube y usa HeyMark gratis por 14 días. Mark responde en tu tono y tú apruebas lo que sale.

Sigue leyendo