Inicio  /  Blog  /  Agente de marketing
TUTORIAL / AGENTES + MARKETING

Tu agente
de marketing.

Cómo crear un agente de marketing con Claude que estudia a tu competencia, escribe el guion, le pone voz y entrega un vídeo vertical listo para revisar. Usamos Opus 5.5 como cerebro, NexLev para investigar YouTube, Fish Audio para la voz y HyperFrames para el vídeo. Lo hemos probado de principio a fin y te dejamos el kit.

POR SKOA~14 MIN DE LECTURA
Pipeline del agente de marketing: brief, NexLev, Opus 5.5, Fish Audio, HyperFrames y aprobación humana.
01 / SEIS PASOS, UNA APROBACIÓN TUYA.
15 s9:16 · ES y EN
6 escenasuna por frase
2 peticionesa Fish Audio
−14 LUFSmedido, no a oído
01 /

El resultado: un promo vertical en dos idiomas.

Le dimos al agente un brief de cinco líneas: promocionar este tutorial ante fundadores y marketers que ya usan Claude. Devolvió el guion, la voz en español y en inglés, dos composiciones de HyperFrames y estos dos vídeos. Ningún editor de vídeo intervino. Lo único manual fue revisarlos.

02 / ESPAÑOL · 15,6 S
03 / INGLÉS · 14,8 S

Es un ejemplo pequeño a propósito: seis frases, seis escenas. El mismo procedimiento sirve para un anuncio, un lanzamiento o una serie de Shorts. Solo cambian el brief y las escenas.

02 /

Qué es un agente de marketing (y qué no).

No es un chat que escribe posts. Es un modelo con herramientas y un procedimiento escrito: lee un brief, decide qué investigar, llama a cada herramienta, comprueba el resultado y se para donde tú decides. En Claude Code eso se monta con tres cosas:

  1. Un modelo que dirige: Opus 5.5 lee, planifica, escribe el guion y el código de las escenas, y revisa los fotogramas.
  2. Herramientas: conectores MCP (NexLev), plugins con comandos (marketing) y scripts propios (Fish Audio, ffmpeg, HyperFrames).
  3. Una skill: un SKILL.md con los pasos, las reglas y los puntos donde el agente espera tu aprobación.
La regla que no se negocia

El agente no publica. Entrega el vídeo y un informe; publicar es tarea tuya. Así un error de guion o una voz mal pronunciada nunca llegan a tu audiencia sin que nadie los vea.

03 /

Las piezas y lo que hace cada una.

PiezaPara quéAccesoEn esta prueba
Claude Code + Opus 5.5Orquestar, escribir guion y escenas, revisarPlan de Claude o APIUsado
Plugin marketing/marketing:competitive-brief, /marketing:brand-review y otros comandosGratis, Apache-2.0Usado para el vídeo largo del canal; no en este promo
NexLev MCPCanales y vídeos que destacan en YouTubeCuenta de NexLev, OAuthNo conectado
Fish AudioVoz a partir del textoClave de APIUsado: 2 peticiones
HyperFramesHTML + GSAP a MP4, render deterministanpx hyperframesUsado: 0.9.16
ffmpegPausas de la voz y volumenLocalUsado

Si ya usas otra herramienta de investigación, como Ahrefs o Similarweb, el plugin de marketing trae conectores para ellas. El agente no cambia: solo cambia lo que conectas.

04 /

Paso 1: el proyecto y el modelo.

Un agente de Claude Code es una carpeta. Lo que hay en .claude/ define cómo trabaja ahí dentro. Fija el modelo para que todas las sesiones de esta carpeta usen Opus 5.5:

.claude/settings.json
{
  "model": "claude-opus-5-5"
}

La estructura completa del kit:

marketing-agent/
.claude/settings.json                    modelo
.claude/skills/marketing-agent/SKILL.md  el procedimiento
brief/brief.md                           qué promocionar y qué se puede afirmar
script/{es,en}.txt                       una frase por línea
scripts/fish-tts.mjs                     texto → MP3 con Fish Audio
scripts/build-video.mjs                  guion + cortes → video-<idioma>/index.html
scripts/finish.sh                        render + −14 LUFS
video-{es,en}/                           proyectos de HyperFrames

El brief es lo más importante de la carpeta. Incluye una línea que muchos olvidan: lo que no se puede afirmar. Si no lo escribes, un modelo con ganas de vender se inventará cifras de visitas.

brief/brief.md
- Product: the SKOA tutorial "Build a marketing agent with Claude".
- Audience: founders and marketers who already use Claude.
- Action: read the tutorial at skoa.online/blog/.
- Claims we can prove: the pipeline in this folder and the approval step.
- Do not claim: views, sales or time saved.
05 /

Paso 2: investigar a la competencia con NexLev y el plugin de marketing.

NexLev publica un servidor MCP de solo lectura con datos públicos de YouTube. Su guía da este comando para Claude Code:

Conectar NexLev
claude mcp add -s user --transport http nexlev https://prod.dashboard.nexlev.io/api/claude-mcp
# dentro de claude: /mcp → nexlev → Authenticate (abre el navegador)
claude mcp list   # nexlev: … (HTTP) - ✓ Connected

Las herramientas que usa la skill son search_niche_finder_channels y get_similar_channels para encontrar cinco canales del nicho, y youtube_channel_outliers para ver qué vídeos de cada uno rinden muy por encima de su media. De esos vídeos, al agente le interesan tres cosas: el gancho, el título y la duración.

Lo que no probamos

En esta prueba NexLev no estaba conectado. El comando y los nombres de las herramientas vienen de la guía oficial de NexLev, actualizada el 20 de agosto de 2026. Los límites dependen del plan y se cuentan por herramienta y día: en el plan gratuito, por ejemplo, son 10 búsquedas de canales y 5 de canales similares. Comprueba tu plan antes de lanzar una investigación grande.

Para posicionarte frente a competidores directos, añade el plugin de marketing de Anthropic. Es abierto y trae comandos como /marketing:competitive-brief, /marketing:brand-review, /marketing:campaign-plan y /marketing:seo-audit:

Dentro de Claude Code
/plugin marketplace add anthropics/knowledge-work-plugins
/plugin install marketing@knowledge-work-plugins

La skill exige que cada dato de brief/research.md tenga su enlace. Si NexLev no responde o se queda sin cuota, el agente lo apunta y sigue solo con el plugin. Nunca debe rellenar el hueco con números inventados.

06 /

Paso 3: la skill que convierte a Claude en el agente.

La skill es un procedimiento, no un prompt largo. Claude la carga cuando le pides un promo o un vídeo de lanzamiento. Estas son las partes que más importan:

.claude/skills/marketing-agent/SKILL.md (extracto)
---
name: marketing-agent
description: Turns a product brief into a researched short video for
  YouTube Shorts, Reels or TikTok. Studies competitors (NexLev MCP,
  the marketing plugin's competitive-brief), writes the script, voices
  it with Fish Audio and builds it with HyperFrames. Never publishes.
---
Stop at each **Approval** line and wait for a yes.

## 3. Script
Six sentences, about 15 seconds. Sentence 1 is the hook and must
work muted. Every claim comes from brief.md or research.md.
Run /marketing:brand-review on the script.
**Approval:** show the script and the research summary.

## 6. Finish
**Approval:** the user watches both videos with sound.
Publishing is the user's job, not yours.

Hay dos aprobaciones. La primera llega antes de gastar créditos de voz: corregir un guion no cuesta nada, pero regenerar audio sí. La segunda llega con el vídeo terminado. El agente no puede oír, así que tienes que escucharlo tú.

07 /

Paso 4: el guion, una idea por frase.

Para un Short de 15 segundos, el agente escribe seis frases. La primera tiene que funcionar sin sonido, porque mucha gente ve los vídeos en silencio. Cada frase será una escena, así que cada una lleva una sola idea:

script/es.txt
Este vídeo lo ha montado un agente de marketing.
Primero estudia a tu competencia con NexLev.
Después, Opus 5.5 escribe el guion.
Fish Audio le pone la voz.
Y HyperFrames lo convierte en vídeo.
Pero no publica nada sin tu visto bueno.

El gancho es cierto en este caso, y eso no es casualidad. La skill exige que cada afirmación salga del brief o de la investigación, y /marketing:brand-review repasa el tono antes de tu primera aprobación.

08 /

Paso 5: la voz con Fish Audio y los cortes en las pausas.

Una sola petición por idioma, con la clave en el entorno. El script tiene veinte líneas y no usa dependencias:

scripts/fish-tts.mjs (lo esencial)
const res = await fetch('https://api.fish.audio/v1/tts', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.FISH_API_KEY}`,
             'Content-Type': 'application/json', model: 's2.1-pro-free' },
  body: JSON.stringify({ text, reference_id: voice, format: 'mp3',
                         mp3_bitrate: 192, normalize: true }),
});
Generar las dos voces
node scripts/fish-tts.mjs --text script/es.txt \
  --voice 3f45a7fd7a614655a61eb7027b955783 --out video-es/assets/vo.mp3
node scripts/fish-tts.mjs --text script/en.txt \
  --voice 536d3a5e000945adb7038665781a4aca --out video-en/assets/vo.mp3

Usamos dos voces públicas de la biblioteca de Fish: «voz de locutor k» en español y Ethan en inglés. El reference_id es el identificador que aparece en la URL de cada voz en fish.audio. Fish no devuelve tiempos por palabra, así que los cortes de escena salen de las pausas del audio:

ffmpeg silencedetect (español)
ffmpeg -i video-es/assets/vo.mp3 -af silencedetect=n=-35dB:d=0.18 -f null -
silence_start: 2.42   silence_end: 2.95   → escena 2 en 2.80
silence_start: 5.21   silence_end: 5.77   → escena 3 en 5.62
silence_start: 6.29   silence_end: 6.59   (la coma de «Después,»)
silence_start: 8.75   silence_end: 9.10   → escena 4 en 8.95
silence_start: 10.50  silence_end: 10.93  → escena 5 en 10.78
silence_start: 12.79  silence_end: 13.30  → escena 6 en 13.15

Cada escena empieza 0,15 s antes de que vuelva la voz, para que la imagen se adelante un poco a la palabra. Una de las pausas es solo una coma, y el agente tiene que reconocerla y no cortar ahí. El vídeo acaba 0,3 s después de la última palabra, sin cierre ni fundido.

09 /

Paso 6: el vídeo con HyperFrames.

HyperFrames convierte HTML en vídeo. La animación es una línea de tiempo de GSAP en pausa, y el render recorre esa línea fotograma a fotograma en Chrome sin pantalla. El mismo HTML da siempre el mismo vídeo, y lo puedes abrir y retocar en su vista previa.

Crear el proyecto con la voz
npx hyperframes init video-es --audio vo.mp3 --language es \
  --resolution portrait --non-interactive
# 1080×1920, transcribe la voz con whisper (transcript.json)
# y deja AGENTS.md / CLAUDE.md con las reglas para el agente

El agente no dibuja las escenas a mano, sino que escribe un generador. build-video.mjs lee el guion y los cortes, y escribe un index.html con seis escenas, subtítulos y la línea de tiempo:

scripts/build-video.mjs (extracto)
const CUTS = {
  // inicio de las escenas 2 a 6 y el final (última palabra + 0,3 s)
  es: [2.80, 5.62, 8.95, 10.78, 13.15, 15.58],
  en: [2.39, 5.27, 8.15, 9.91, 12.39, 14.79],
};
// cada escena es un clip con su inicio y duración en segundos
// <div id="s2" class="clip scene" data-start="2.8" data-duration="2.82">
tl.to('#s2 .hot', { scaleY: 1.3, duration: 0.5, ease: 'back.out(1.6)' }, 3.55);

Antes de renderizar, npx hyperframes check pasa el lint, ejecuta la composición y mide la legibilidad. En la primera versión avisó de dos rótulos que no duraban en pantalla lo suficiente para leerlos. Los adelantamos.

npx hyperframes check (avisos de la primera versión)
line_unread  "por encima de su media" (5 words) is on screen 1.07 s,
             under its 1.50 s floor
line_unread  The film's last line "APROBADO ✓" is on screen 1.02 s
nested_structure_needs_subcomposition  (6×, aviso de organización)

Los avisos de estructura sugieren pasar cada escena a su propio archivo dentro de compositions/. Para seis escenas cortas lo dejamos en uno, a propósito, para que el ejemplo se lea de un vistazo. En un proyecto más largo, sepáralas.

10 /

Paso 7: revisar fotogramas, medir el volumen y aprobar.

El agente mira el vídeo antes que tú, a su manera: genera una hoja con un fotograma de cada escena y la revisa. En la primera hoja encontró dos fallos. La barra destacada del gráfico tapaba el buscador, y el cursor que pulsa «Aprobar» era demasiado pequeño para verse en un móvil.

Seis fotogramas del promo en español: el gancho, NexLev, Opus 5.5, Fish Audio, HyperFrames y el botón de aprobar.
04 / UN FOTOGRAMA POR ESCENA, YA CORREGIDO.

Después renderiza y normaliza el volumen a −14 LUFS en dos pasadas:

bash scripts/finish.sh es · bash scripts/finish.sh en
promo-es.mp4  1080×1920  15,6 s   I: −14,1 LUFS   pico: −1,9 dBFS
promo-en.mp4  1080×1920  14,8 s   I: −14,3 LUFS   pico: −0,9 dBFS

Sin normalizar, la voz inglesa salía a −23,1 LUFS y la española a −15,8: dos voces de la misma herramienta, con 7 dB de diferencia. Por eso se mide siempre, nunca se supone.

Lo que solo puedes comprobar tú

La transcripción oyó «Nextlev» donde la voz dice NexLev. Es un fallo de whisper, no de Fish, pero no garantiza que el nombre suene bien. Escucha los nombres propios antes de aprobar: NexLev, Opus, Fish Audio y HyperFrames.

11 /

Costes, límites y dónde falla.

  1. Fish Audio: dos peticiones, de 234 y 228 caracteres. El precio depende de tu plan, así que míralo en tu cuenta. Antes de publicar, revisa también los términos de uso comercial de las voces públicas de la biblioteca: nosotros aún los estamos comprobando.
  2. NexLev: límites diarios por herramienta y por plan. Su web da cifras distintas para el número de herramientas y la cuota de API según la página, así que confía en lo que muestre tu panel.
  3. HyperFrames: el render es local y no gasta créditos. En un Mac con M4 Pro, cada vídeo de 15 s se renderizó en menos de un minuto. La primera vez descarga Chrome sin pantalla y las fuentes.
  4. Opus 5.5: es la parte que más tokens consume, porque escribe código y revisa imágenes. Si usas Claude Code con un plan de suscripción, entra en tu cuota de uso.
  5. Dónde falla: tiempos por palabra que no son exactos, nombres propios mal pronunciados y rótulos que se solapan. Todo eso se ve en la revisión. Ninguno de esos fallos llega a publicarse si respetas la aprobación final.
12 /

El kit y el prompt para hacerlo tú.

PARA EMPEZAR YA

El agente completo, en una carpeta.

Skill, brief de ejemplo, guiones, scripts de Fish y de acabado, y los dos proyectos de HyperFrames con su voz.

Descargar el kit ↓ZIP · 760 KB · sin claves ni secretos · HyperFrames 0.9.16

Descomprímelo, exporta tu clave de Fish y abre Claude Code en la carpeta. Luego pide:

Prompt
Usa la skill marketing-agent con brief/brief.md.
Investiga 5 canales del nicho con NexLev y resume en brief/research.md
qué tienen en común sus vídeos que destacan, con enlaces.
Escribe un guion de 6 frases en español e inglés y enséñamelo
antes de generar la voz. Voces de Fish: <id ES> y <id EN>.
Monta los vídeos con HyperFrames, revisa una hoja de fotogramas,
normaliza a −14 LUFS y dime qué no has podido comprobar.
No publiques nada.

Si no tienes NexLev, quita la segunda línea: la skill sigue funcionando solo con el plugin de marketing. Y si te interesa la parte de motion graphics, en Del chat al vídeo contamos cómo sincronizar la animación palabra a palabra. Más tutoriales en el blog de SKOA.