Guías de uso real

Playbook: automatización de SEO y GEO

El SEO (Search Engine Optimization) es la práctica de hacer que las páginas web aparezcan más arriba en los resultados de Google y Bing. El GEO (Generative Engine Optimization) es la disciplina más reciente que busca hacer visible tu contenido dentro de las respuestas generadas por IA de ChatGPT, Perplexity, Claude y herramientas similares. Ambos requieren auditar lo que está roto, corregirlo y señalar a los rastreadores que la corrección existe. Claude Code y la API de Anthropic automatizan cada uno de estos pasos a escala.

Un pipeline SEO automatizado típico tiene cuatro fases:

1. Auditoría: rastrear el sitio, extraer etiquetas meta, encabezados, texto alternativo, datos estructurados (JSON-LD) y puntuaciones de velocidad de página. Claude lee el HTML sin procesar y produce una lista de problemas priorizada.
2. Inyección on-page: Claude Code edita los archivos fuente directamente, insertando etiquetas title corregidas, atributos meta description, atributos alt en imágenes y bloques JSON-LD de schema.org.
3. Señales de indexación: un pequeño script Node.js llama a la API IndexNow (compatible con Bing y Yandex) para enviar las URLs actualizadas de inmediato, y llama a la API de Google Search Console para solicitar un nuevo rastreo.
4. Visibilidad IA (GEO): agrega un archivo llms.txt en la raíz de tu sitio para que los rastreadores de IA puedan leer un resumen estructurado, y agrega bloques JSON-LD speakable para que los asistentes de voz e IA citen tu contenido de manera preferente.

Claude Code es ideal para la fase de inyección porque lee, edita y verifica archivos en una sola sesión sin necesidad de copiar y pegar. La Batch API de Anthropic (50 por ciento más económica, límite de velocidad independiente) gestiona la generación masiva cuando necesitas cientos de meta descripciones o resúmenes de página en una sola ejecución.

Guía práctica: un pipeline de contenido

Un pipeline de contenido es una secuencia repetible de pasos que toma una idea en bruto y la convierte en una pieza publicada. Claude puede actuar como motor en cada etapa: brief, redacción, ajuste de voz, revisión y preparación para la publicación. Ejecutar estos pasos como prompts distintos y enfocados produce mejores resultados que una sola solicitud gigante del tipo "escríbeme un artículo".

Las cinco etapas siguen un orden claro:

1. Brief: define el tema, la audiencia, el número de palabras y el objetivo en un solo prompt. Pide a Claude que devuelva un esquema estructurado para tu aprobación antes de escribir nada.
2. Redacción: envía el esquema aprobado junto con cualquier material fuente. Claude escribe el borrador completo en una sola pasada.
3. Voz: pega dos o tres muestras de tu escritura existente y pide a Claude que reescriba el borrador para que coincida con tu tono, la longitud de tus oraciones y tu vocabulario.
4. Revisión: ejecuta un prompt separado pidiendo a Claude que actúe como editor. Verifica vacíos lógicos, repeticiones, introducciones débiles y afirmaciones sin respaldo.
5. Publicación: genera el entregable final, ya sea HTML limpio, un archivo Markdown o un correo formateado, listo para pegar en tu CMS (sistema de gestión de contenido) o enviar directamente.

Mantener cada etapa en su propio prompt te da un punto de control para aprobar o ajustar antes de continuar. También te permite cambiar de modelo Claude: usa claude-opus-4-8 para las etapas de brief y ajuste de voz donde importa el juicio, y claude-sonnet-4-6 para la redacción masiva para mantener los costos bajos.

Playbook: conjuntos de datos sintéticos

Un conjunto de datos sintético es información de entrenamiento o evaluación generada por un modelo en lugar de recopilada de personas. Cuando se necesitan miles de pares de preguntas y respuestas, escribirlos a mano es impractico. El Batch API (el punto de enlace asíncrono de Anthropic para solicitudes en volumen) permite enviar hasta 10.000 solicitudes en una sola llamada, las procesa en menos de 24 horas y cobra un 50 % menos que la API estándar. Para la mayoría de los trabajos de creación de conjuntos de datos, el tiempo de ejecución real es inferior a 10 minutos.

El patrón principal es: construir una lista de objetos prompt, enviarlos como un batch, consultar el estado hasta la finalización y luego descargar y validar los resultados. Cada solicitud en el batch recibe su propio custom_id (una cadena que usted elige) para poder asociar cada respuesta con su registro de origen.

Decisiones clave antes de comenzar:

• Elección del modelo: claude-opus-4-8 para pares de la máxima calidad; claude-sonnet-4-6 para equilibrio entre velocidad y costo; claude-haiku-4-5 para volumen con formatos simples.
• Plantilla de prompt: un system prompt que imponga el formato de salida (JSON, sin guion largo, sin nombres de marca que se deseen excluir) y un user prompt por fila de los datos de origen.
• Pasada de validación: tras la descarga, ejecutar un script que verifique cada elemento contra el esquema y marque vacíos, duplicados o cadenas prohibidas antes de usar los datos para el fine-tuning.
• Límites de velocidad: el Batch API tiene su propio límite de velocidad independiente, separado de la API en tiempo real, por lo que no compite con el tráfico de producción.

La salida es un archivo JSONL (JSON Lines: un objeto JSON por línea), que es el formato de entrada estándar para pipelines de fine-tuning como Hugging Face Trainer o los scripts de fine-tuning de Llama.

Playbook: investigación con herramientas web

Cuando Claude Code funciona con herramientas web activadas, puede desplegarse en abanico (ejecutar varias búsquedas al mismo tiempo) en lugar de buscar una consulta por vez. Esto reduce drásticamente el tiempo real en tareas de investigación que requieren una docena de fuentes.

El ciclo de investigación tiene cuatro etapas:

1. Planificar las consultas: descomponer la pregunta en 3 a 6 subpreguntas distintas antes de recuperar nada.
2. Despliegue en abanico: lanzar todas las consultas en paralelo para que los resultados lleguen juntos.
3. Recuperar y verificar: acceder a las principales URL, contrastar las afirmaciones en al menos dos fuentes independientes y marcar las contradicciones.
4. Sintetizar con citas: redactar la respuesta vinculando cada afirmación factual a una fuente numerada para que el lector pueda auditarla.

La verificación adversarial consiste en intentar activamente refutar lo que se acaba de encontrar. Antes de aceptar una afirmación, hay que preguntarse: ¿alguna otra fuente la contradice? ¿La fuente es actual? ¿Es primaria (estudio original, documentación oficial) o secundaria (un blog que resume el trabajo de otro)? Prefiera las fuentes primarias y anote las fechas de publicación.

Al redactar la síntesis final, cada oración que afirme un hecho debe terminar con una cita entre corchetes como [1], y la lista de fuentes debe incluir la URL y la fecha de acceso. Esto hace que el informe sea auditable y lo protege si una fuente cambia posteriormente.

Playbook: construir una base de conocimiento

Una base de conocimiento es una colección estructurada de documentos, notas o registros que un agente de IA puede buscar y citar. Las cuatro operaciones clave son: ingerir (incorporar el contenido), deduplicar (eliminar duplicados), enlazar (conectar elementos relacionados) y recuperar (obtener el fragmento correcto en el momento oportuno).

Claude Code es el punto de entrada para las cuatro operaciones. Apúntelo a una carpeta y podrá leer cada archivo, resumir su contenido, escribir una salida estructurada (JSON, Markdown) y establecer referencias cruzadas entre temas. Lo fundamental es proporcionarle a Claude un esquema coherente desde el principio para que cada elemento ingerido tenga los mismos campos: id, source, summary, tags y links.

La deduplicación consiste en detectar contenido semánticamente idéntico aunque la redacción sea diferente. Pida a Claude que compare los resúmenes y marque los elementos cuyo significado se superpone por encima de un umbral (por ejemplo, el 80 por ciento). El enlazado consiste en encontrar elementos que referencian el mismo concepto y escribir [[wikilink]] explícitos o referencias cruzadas en JSON entre ellos.

Para la recuperación, el patrón más sencillo y duradero es un archivo de índice en texto plano (habitualmente llamado INDEX.md) que Claude actualiza tras cada ejecución de ingestión. En el momento de la recuperación, Claude lee primero el índice y luego obtiene únicamente los archivos que necesita. Esto mantiene el consumo de tokens bajo y las respuestas precisas. El pipeline completo es el siguiente:

• Paso 1 - Ingestión: Claude lee los archivos fuente, extrae metadatos estructurados y escribe un registro JSON por documento.
• Paso 2 - Deduplicación: Claude compara los resúmenes, fusiona los duplicados y agrega un campo merged_into al registro descartado.
• Paso 3 - Enlazado: Claude analiza todos los registros y escribe arrays related que apuntan a los identificadores relacionados.
• Paso 4 - Indexación: Claude regenera INDEX.md con una línea por registro: identificador, título, etiquetas.
• Paso 5 - Recuperación: En el momento de la consulta, Claude lee el índice, selecciona los identificadores candidatos, lee solo esos archivos y responde.

Playbook: desarrollo de aplicaciones móviles

Crear una aplicación móvil con Expo (un framework que envuelve React Native para que puedas ejecutar tu app en iOS y Android desde una sola base de código) se combina de forma natural con Claude Code. Describes una pantalla o funcionalidad en lenguaje sencillo, Claude Code genera el componente, y Expo Go (la app de previsualización que instalas en tu teléfono) refleja el cambio en segundos mediante hot reload.

El ciclo principal es: abre Claude Code en la raíz de tu proyecto, pide una funcionalidad, revisa el diff, ejecuta npx expo start para mostrar un código QR y escanea con Expo Go. Sin esperar pipelines de compilación durante el desarrollo.

Cuando estés listo para distribuir, Expo ofrece dos caminos:

• EAS Build (Expo Application Services): compilación en la nube que produce un binario real .apk o .ipa sin necesitar Xcode ni Android Studio localmente.
• EAS Submit: envía ese binario directamente al App Store o Google Play desde la línea de comandos.

Una regla importante: después de cualquier comando npx expo install que agregue una dependencia nativa, reinicia el bundler Metro (el servidor de desarrollo local que usa Expo) con el flag --clear, de lo contrario la app puede mostrar una pantalla en blanco. Pide a Claude Code que te lo recuerde en sus propias instrucciones.

Playbook: entregables multilingues

Un entregable multilingues es cualquier activo (página web, correo electrónico, conjunto de datos, aviso legal) que debe existir en dos o más idiomas y mantenerse coherente: mismos hechos, mismo tono, misma estructura, sin divergencias a lo largo del tiempo. El riesgo es la deriva: un idioma se actualiza y los demás no.

El enfoque profesional es la traducción de fuente única: un archivo fuente autorizado es el único lugar donde las personas redactan y aprueban el contenido. Cada versión en otro idioma se deriva de él, nunca se edita de forma independiente. Claude trata esto como un pipeline de tres etapas.

• Etapa 1 - Redactar: Escribir o finalizar la fuente en un solo idioma (generalmente francés o inglés). Bloquearla antes de traducir.
• Etapa 2 - Traducir: Enviar la fuente bloqueada a Claude con un brief de estilo explícito. Una llamada por idioma de destino, o una llamada batch para todos los idiomas a la vez.
• Etapa 3 - Validar: Ejecutar una verificación de coherencia: comparar términos clave, números y fórmulas legales en todos los resultados antes de publicar.

En Claude Code (el agente de codificación CLI e IDE), puedes automatizar este pipeline con un pequeño script que lee el archivo fuente, llama a la Anthropic API una vez por idioma, escribe cada resultado en un archivo versionado y registra un resumen de diferencias. La Anthropic Batch API permite enviar todas las solicitudes de traducción en una sola llamada HTTP con un descuento del 50 por ciento y aproximadamente cinco minutos de tiempo real para cien solicitudes, lo que hace que los grandes conjuntos de datos multilingues sean prácticos y económicos.

Playbook: un entregable HTML para compartir

El entregable más sencillo que puedes compartir por correo electrónico o mensajería es un único archivo HTML autocontenido: un solo archivo, sin servidor, sin dependencias, que se abre en cualquier navegador con doble clic. El principio clave es incluir todo de forma inline, es decir, el CSS va dentro de una etiqueta <style>, el JavaScript dentro de una etiqueta <script>, y las imágenes se incrustan como URIs de datos Base64 (una codificación textual de datos binarios). Nada se carga desde la red.

Cuando le pides a Claude que produzca este tipo de archivo, el patrón más fiable es proporcionarle una lista de restricciones explícitas para que no pueda añadir accidentalmente una referencia externa. Errores comunes que hay que prohibir: un atributo href apuntando a un CDN, un atributo src apuntando a una URL externa, y cualquier enunciado import que realice solicitudes en tiempo de ejecución.

Antes de enviar el archivo, valídalo sin conexión: desconéctate de Internet (o desactiva el Wi-Fi), abre el archivo en tu navegador e interactúa con cada función. Si algo aparece en blanco o no funciona, la causa es casi siempre un recurso inline que falta.

• Coloca todo el CSS en un solo bloque <style> dentro del <head>.
• Coloca todo el JS en un solo bloque <script> antes de </body>.
• Convierte las imágenes con Node: Buffer.from(fs.readFileSync(path)).toString('base64'), luego agrega el prefijo data:image/png;base64,.
• Si los datos son extensos (una lista, un quiz), inclúyelos como una variable JS, no como una llamada fetch.

Playbook: una pila de automatización personal

Una pila de automatización personal combina tres capas: tareas programadas (ejecutar un agente Claude Code según un calendario cron), hooks (disparar acciones antes o después de eventos específicos de Claude Code) y un segundo cerebro (un almacén de conocimiento estructurado, como un vault de Obsidian, que Claude puede leer y actualizar). Juntos convierten a Claude en un asistente persistente que trabaja incluso cuando no estás frente al teclado.

Las tareas programadas usan el planificador de tareas de tu sistema operativo (Programador de tareas de Windows, cron en Linux/macOS) para llamar a claude en modo headless (es decir, sin terminal interactiva, completamente automatizado). El flag --print hace que Claude escriba su respuesta en stdout y salga de inmediato, lo cual es ideal para scripts. Combínalo con -p "tu prompt" y redirige la salida a un archivo de registro o envíala a otra herramienta.

Los hooks son comandos de shell registrados en .claude/settings.json bajo la clave hooks. Claude Code los dispara en puntos definidos del ciclo de vida: PreToolUse, PostToolUse, Stop y Notification. Un hook Stop, por ejemplo, puede sincronizar automáticamente un archivo de memoria con tu vault cada vez que termina una sesión, para que nunca pierdas contexto entre sesiones.

• Actualización programada: un agente nocturno obtiene datos nuevos, actualiza notas y confirma cambios.
• Hook Stop: escribe un resumen de sesión en MEMORY.md en el momento en que Claude termina.
• Hook PreToolUse: valida o registra cada escritura de archivo antes de que ocurra.
• Lecturas del segundo cerebro: Claude lee archivos markdown estructurados de tu vault al inicio de sesión para restaurar el contexto completo en segundos, en lugar de releer código sin procesar.

Playbook: convertir una tarea repetitiva en un skill

Todo flujo de trabajo tiene tareas repetitivas: ejecutar la misma auditoría, generar el mismo informe, aplicar la misma lista de verificación en la revisión de código. La primera vez se improvisa. La segunda, se copia del historial. La tercera, debería existir un skill. Un skill es un archivo de instrucciones reutilizable que Claude Code carga bajo demanda mediante un comando slash, para dejar de resolver el mismo problema dos veces.

El disparador para capturar un skill es sencillo: notar el momento en que se busca una conversación anterior para copiar un prompt ya escrito. Ese momento es una señal. La tarea ha ganado un nombre.

Un archivo skill se ubica en ~/.claude/skills/<skill-name>/SKILL.md para uso global, o en .claude/skills/<skill-name>/SKILL.md dentro de un proyecto para uso exclusivo de ese proyecto. Claude Code lo expone como /skill-name en la barra de chat. El archivo es Markdown simple: una descripción al principio, seguida de las instrucciones exactas que Claude debe seguir cada vez.

Para construir un buen skill, extraiga las partes invariantes (los pasos que nunca cambian) y deje marcadores de posición para las partes que varían en cada ejecución. Los patrones comunes incluyen:

• Una lista de verificación de revisión de código aplicada a cada pull request
• Un generador de notas de versión que lee git log y formatea la salida
• Un escaneo de seguridad que verifica una lista fija de reglas OWASP
• Una auditoría de calidad de dataset ejecutada antes de cada fine-tune