Ruido a Blog

Toma cualquier entrada sin procesar (viñetas, transcripciones de voz, volcados de tweets o borradores cortos) y produce una entrada de blog pulida y lista para publicar. Cada afirmación se remite al material original o a una investigación verificada por Tavily.

Regla crítica: NO INVENTES DATOS ESPECÍFICOS. Cada afirmación, métrica y ejemplo en la entrada de blog debe provenir de la entrada sin procesar o de un resultado de búsqueda de Tavily. Nunca fabriques datos, citas o resultados.

Paso 1: Verificación de Configuración

Confirma que las variables de entorno requeridas estén configuradas:

echo "GEMINI_API_KEY: ${GEMINI_API_KEY:+set}"
echo "TAVILY_API_KEY: ${TAVILY_API_KEY:-no configurada, el enriquecimiento con Tavily se omitirá}"

Si falta GEMINI_API_KEY: Detente. Dile al usuario: "Se requiere GEMINI_API_KEY. Consíguela en aistudio.google.com → Obtén la clave API. Agrégala a tu archivo .env."

Si falta TAVILY_API_KEY: Continúa. Ten en cuenta que el enriquecimiento con Tavily se omitirá. La entrada de blog se basará completamente en el contenido proporcionado. Esto está bien para historias personales, tutoriales basados en experiencia o artículos de opinión.

Confirma que la entrada está presente. El usuario debe proporcionar una de:

Texto pegado (viñetas, notas sueltas, transcripción, volcado de tweets, borrador corto)
Una URL para obtener

Si no hay entrada, pregunta: "Comparte tus notas sueltas, viñetas o transcripción. Pégalas directamente, o dame una URL para obtener la fuente."

Paso 2: Leer y Analizar la Entrada

Si la entrada es una URL: Obtén el contenido de la página usando WebFetch. Extrae: título, autor, fecha de publicación, todo el texto del cuerpo, estadísticas clave, listas numeradas, subtítulos, citas.

Si la entrada es texto pegado: Léelo directamente. Identifica el tipo de entrada:

Viñetas o notas sueltas: ideas fragmentadas, oraciones incompletas, flujo de conciencia
Transcripción de voz: conversacional, repetitiva, palabras de relleno (um, eh, como, sabes), oraciones divagantes
Volcado de hilo de tweets: fragmentos cortos, @menciones, hashtags, numeración "1/8"
Borrador corto: estructurado pero delgado, necesita expansión y pulido

Punto de control QA: Indica antes de continuar:

Tipo de entrada detectado
Tesis central o argumento principal en una oración
Las 3-5 ideas, hechos o conclusiones más sólidas del contenido sin procesar
Cualquier afirmación que necesite verificación externa (puntos de referencia, estadísticas, comparaciones de productos, hallazgos de investigación)

Si no puedes identificar una tesis central, pregunta: "¿Cuál es la única cosa más importante que quieres que los lectores se lleven de esto?"

Paso 3: Elegir el Estilo de la Entrada de Blog

Cuatro estilos. Detectado automáticamente a partir de las señales del contenido. La anulación por parte del usuario siempre se respeta.

Estilo	Cuándo usarlo	Señales
Tutorial Técnico	Guía paso a paso, cómo se hace, explicación de código	Pasos numerados, comandos, fragmentos de código, "cómo se hace" en el contenido
Estudio de Caso	Historia de antes/después, registro de construcción, lecciones aprendidas	Resultados específicos, cronologías, viaje en primera persona
Liderazgo de Pensamiento	Opinión, argumento, afirmación contraintuitiva	"Creo que", "el problema con X", posición contraria, marco de debate
Explicativo	Qué es X, por qué importa, cómo funciona	Concepto primero, comparativo, "la mayoría de la gente no sabe"

Lógica de detección:

El contenido tiene pasos numerados o comandos → Tutorial Técnico
El contenido tiene antes/después, métricas específicas o arco narrativo → Estudio de Caso
El contenido argumenta en contra del sentido común o hace una afirmación de opinión fuerte → Liderazgo de Pensamiento
El contenido explica un concepto, herramienta o tendencia para personas no familiarizadas con él → Explicativo

Indica el estilo elegido y el razonamiento. Si es ambiguo, elige uno y anota la elección.

Paso 4: Enriquecer con Investigación de Tavily

Omite este paso en silencio si TAVILY_API_KEY no está configurada.

Busca evidencia de respaldo para las afirmaciones en el contenido sin procesar que podrían beneficiarse de verificación o datos. Buenos candidatos:

Puntos de referencia de productos o cifras de rendimiento
Estadísticas de mercado o tendencias de la industria
Comparaciones técnicas ("X es más rápido que Y")
Cualquier número que el usuario haya mencionado de memoria en lugar de una fuente citada

Ejecuta una búsqueda de Tavily por cada afirmación que necesite verificación. Limita a 3 búsquedas como máximo para evitar un exceso de fuentes:

curl -s -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "'"$TAVILY_API_KEY"'",
    "query": "AFIRMACIÓN_O_TEMA_ESPECÍFICO",
    "search_depth": "advanced",
    "max_results": 5,
    "include_answer": true
  }'

Conserva los resultados con score >= 0.65. Extrae: título, url, fragmento de contenido.

Reglas para usar los resultados de Tavily:

Úsalos para respaldar o verificar afirmaciones ya presentes en la entrada sin procesar. Nunca introduzcas nuevas afirmaciones a partir de los resultados de búsqueda.
Atribuye las fuentes de forma natural en el texto: "según [Fuente]", "datos de [X] muestran"
Si ningún resultado de Tavily confirma una afirmación, deja la afirmación sin verificar en lugar de sustituir un resultado no relacionado

Paso 5: Generar la Entrada de Blog

Lee references/blog-format.md completo. Selecciona la plantilla correspondiente de references/output-template.md. Interioriza todas las reglas antes de generar.

Escribe la solicitud de Gemini en un archivo temporal para manejar los caracteres especiales de forma segura:

cat > /tmp/noise2blog-solicitud.json << 'ENDJSON'
{
  "system_instruction": {
    "parts": [{
      "text": "Eres un escritor técnico que suena como una persona real. Reglas: Solo voz activa. Párrafos cortos, de 1 a 3 líneas como máximo, luego una línea en blanco. Usa contracciones de forma natural (no, será, es, no puedes, eres, son). Sin guiones largos — usa una coma o un punto en su lugar. Sin punto y coma. Cada oración necesita un detalle concreto: un número, un nombre de herramienta, un nombre de archivo, un comando, un resultado. Sin frases de relleno: sin 'En el mundo rápidamente cambiante de hoy', sin 'Profundicemos', sin 'Vale la pena señalar', sin 'En conclusión', sin 'Espero que esto haya sido útil'. Sin palabras prohibidas: increíble, asombroso, apalancamiento, sinergia, innovador, revolucionario, pionero, paradigma, de vanguardia, perfecto, robusto, sin precedentes, profundizar, aprovechar, utilizar, transformador, disruptivo, desbloquear, integral, procesable, crucial, fundamental. El título no debe comenzar con Yo, Mi o Nosotros. Abre con un párrafo de gancho que no anuncie el tema. Cierra con algo procesable. No inventes afirmaciones, métricas o resultados que no estén presentes en el material original."
    }]
  },
  "contents": [{
    "parts": [{
      "text": "CONTENIDO_SIN_PROCESAR_E_INSTRUCCIONES_AQUÍ"
    }]
  }],
  "generationConfig": {
    "temperature": 0.7,
    "maxOutputTokens": 4096
  }
}
ENDJSON

Reemplaza CONTENIDO_SIN_PROCESAR_E_INSTRUCCIONES_AQUÍ con:

El contenido sin procesar de la entrada
Las instrucciones de estilo y estructura de la entrada de blog (de la plantilla seleccionada)
Cualquier resultado de investigación de Tavily recopilado en el Paso 4
Objetivo de palabras: 800-1,800 palabras

Envía la solicitud:

curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @/tmp/noise2blog-solicitud.json \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['candidates'][0]['content']['parts'][0]['text'])"

También produce:

(B) Una meta descripción de 1-2 oraciones para el texto de vista previa SEO
(C) Un título alternativo usando un ángulo de gancho diferente

Paso 6: Autoverificación (Self-QA)

Ejecuta cada verificación y corrige las infracciones antes de presentar:

Corrige cualquier infracción antes de presentar. Indica el recuento final de palabras.

Paso 7: Resultado

Presenta la entrada de blog completa en un bloque de código.

Presenta la meta descripción y el título alternativo debajo de la publicación principal.

Pregunta: "¿Listo para copiar esto a tu editor? Si vas a publicar en una plataforma específica, dímelo y puedo formatear el frontmatter."

Ante una solicitud de plataforma específica:

Ghost:

---
title: "TÍTULO_PUBLICACIÓN"
date: YYYY-MM-DD
tags: [etiqueta1, etiqueta2]
status: draft
---

dev.to:

---
title: TÍTULO_PUBLICACIÓN
description: META_DESCRIPCIÓN
tags: [etiqueta1, etiqueta2, etiqueta3]
published: false
---

Substack: Preséntalo como Markdown sin formato. El editor de Substack importa markdown directamente.

Hashnode:

---
title: TÍTULO_PUBLICACIÓN
subtitle: META_DESCRIPCIÓN
tags: [etiqueta1, etiqueta2]
---

Varnan-Tech/opendirectory

¿Qué es opendirectory?

Preguntar en tu IA favorita

Documentación