Investigador de Contenido para Shorts (TikTok / Reels / YouTube Shorts)

Actor de Apify que recibe un tema y genera contenido estructurado y verificado, listo para guionizar videos cortos: titulo, resumen, 5 datos importantes, 3 curiosidades y las fuentes utilizadas.

Como funciona

1. Busca el tema en DuckDuckGo.
2. Extrae el contenido de las paginas mas relevantes (excluyendo redes sociales y sitios de video, que no aportan texto util).
3. Envia ese contenido a un modelo de Google Gemini (con nivel gratuito), que sintetiza la informacion en el formato solicitado, sin inventar datos fuera de las fuentes.
4. Guarda el resultado en el Dataset del Actor y en el registro OUTPUT.

Input

Campo	Tipo	Obligatorio	Descripcion
topic	string	si	Tema a investigar (ej. "Efecto Mandela").
maxSources	integer	no	Maximo de fuentes a analizar (por defecto 5).
model	string	no	Modelo de Gemini a usar (por defecto gemini-2.5-flash).
geminiApiKey	string	ver nota	Clave de Gemini (o definila como variable de entorno GEMINI_API_KEY).

Ejemplo:

{
  "topic": "Efecto Mandela"
}

Importante: este Actor necesita una clave de API de Google Gemini (gratuita) para generar el contenido. Puedes crear una en https://aistudio.google.com/apikey con tu cuenta de Google, sin costo, dentro de los limites del nivel gratuito. Se recomienda configurarla como variable de entorno GEMINI_API_KEY en la pestana "Environment variables" del Actor (no en el input), para que no quede visible en las corridas.

Output

El Actor guarda un registro en el Dataset y en el key-value store (OUTPUT) con este formato:

{
  "topic": "Efecto Mandela",
  "title": "...",
  "summary": "...",
  "facts": ["...", "...", "...", "...", "..."],
  "curiosities": ["...", "...", "..."],
  "sources": ["https://...", "https://..."]
}

Buenas practicas aplicadas

• Uso de Actor.init() / Actor.exit() y manejo de errores con Actor.fail().
• Validacion estricta del input antes de ejecutar cualquier logica.
• Uso de CheerioCrawler (Crawlee) para scraping liviano y eficiente.
• Limite de solicitudes (maxRequestsPerCrawl) para controlar el consumo.
• Exclusion de dominios que no aportan texto util (redes sociales/video).
• La clave de API se puede definir como variable de entorno para mayor seguridad.
• Uso del modo de salida JSON nativo de Gemini (responseMimeType: "application/json").
• Salida validada y normalizada exactamente al esquema solicitado.

Ejecutar localmente

npm install
export GEMINI_API_KEY=tu_clave_aqui
npm start