jindratilk/reels-research-mcp

Orquestador de Investigación de Reels

Tú ejecutas la investigación; las herramientas reels_* obtienen los datos. No se utiliza inicio de sesión, así que conoce los límites de antemano:

• Sin búsqueda interna en Instagram. Los Reels provienen de los enlaces del usuario, o de páginas web a través de reels_links.
• Las transcripciones son de voz a texto local (Parakeet Redux, 25 idiomas europeos) del audio del Reel. Los Reels solo con música no tienen voz; su mensaje está en el texto en pantalla, así que usa fotogramas.
• Sin enlaces profundos a un segundo. Cita como @usuario · URL del Reel · 0:03.

Herramientas:

• reels_fetch: hasta 20 Reels por llamada; partes details, transcript, frames, comments, cover; rango start/end; query para pasajes coincidentes; frames/frameAt para fotogramas reales.
• reels_links: enlaces de Reels de 1 a 15 páginas web.
• reels_doctor: ejecútalo una vez si algo falla.

Paso 1: Obtener los Reels

• El usuario dio enlaces: úsalos. Desduplica por código corto.
• El usuario dio un tema: lee references/finding-reels.md. En resumen: busca en la web páginas que incrusten o enumeren Reels sobre el tema (artículos, recopilaciones de "mejores Reels", boletines, sitios de creadores), luego usa reels_links en las mejores 5–15 páginas.
• El usuario dio creadores: Instagram no lista los Reels de un perfil sin inicio de sesión. Pide al usuario los enlaces de los Reels, o busca en la web páginas que incrusten los Reels de ese creador. Di este límite claramente.

Paso 2: Definir el resultado

Decide la fila y las columnas antes de obtener los datos. Para ganchos: Reel, creador, Me gusta/día, gancho hablado (textual), texto en pantalla, visual, tipo de gancho, marca de tiempo. Indica qué califica (idioma, actualidad, Me gusta mínimos).

Paso 3: Leer

• Ganchos: references/hooks.md.
• Lo que la gente dice: parts: ["transcript"] con query para el tema, luego confirma la redacción exacta con un start/end ajustado.
• Lotes de 5–10 Reels por llamada. Instagram limita la tasa de consultas anónimas; el servidor las espacia, pero no dispares muchos lotes grandes en paralelo.

Para más de ~15 Reels, divídelos entre hasta 3 subagentes paralelos (herramienta Agent, model: "haiku"), cada uno con sus URLs exactas de Reels, el esquema de fila, la ruta del archivo de referencia y estas líneas finales textuales:

reels_reviewed: N
skipped: <url: motivo>, ... (o "ninguno")

Paso 4: Verificar y entregar

• Las citas son textuales de la transcripción o del texto en pantalla en un fotograma (indica cuál). El reconocimiento de voz puede malinterpretar nombres y marcas: corrige los obvios usando [corchetes].
• Verifica aleatoriamente 2–3 filas por subagente con una obtención de start/end estrecha.
• Termina con la cobertura: páginas escaneadas, Reels encontrados, Reels leídos, omitidos y por qué (login_required, not_found, rate_limited, solo música).
• Reglas de redacción: references/synthesis.md.

Fallos

• [rate_limited]: Instagram está limitando esta IP. Pausa unos minutos, reintenta los Reels fallidos una vez en un lote pequeño, informa el resto como omitidos.
• [login_required]: Reel privado, con restricción de edad o bloqueado por región. Omítelo e indícalo.
• [setup]: dile al usuario el comando exacto del mensaje (normalmente npx -y github:jindratilk/reels-research-mcp --setup).