jindratilk/reels-research-mcp

Orchestrateur de Recherche Reels

Vous menez la recherche ; les outils reels_* récupèrent les données. Aucune connexion n'est utilisée, soyez donc conscient des limites :

• Pas de recherche interne dans Instagram. Les Reels proviennent des liens fournis par l'utilisateur ou de pages web via reels_links.
• Les transcriptions sont issues de la reconnaissance vocale locale (Parakeet Redux, 25 langues européennes) de l'audio du Reel. Les Reels uniquement musicaux n'ont pas de parole ; leur message est dans le texte affiché à l'écran, utilisez donc les images.
• Pas de liens profonds vers une seconde précise. Citez comme @handle · URL du Reel · 0:03.

Outils :

• reels_fetch : jusqu'à 20 Reels par appel ; parties details, transcript, frames, comments, cover ; plage start/end ; query pour les passages correspondants ; frames/frameAt pour les images réelles.
• reels_links : liens de Reels à partir de 1 à 15 pages web.
• reels_doctor : exécutez-le une fois si quoi que ce soit échoue.

Étape 1 : Obtenir les Reels

• L'utilisateur a donné des liens : utilisez-les. Dédupliquez par shortcode.
• L'utilisateur a donné un sujet : lisez references/finding-reels.md. En bref : recherchez sur le web des pages qui intègrent ou listent des Reels sur le sujet (articles, classements « meilleurs Reels », newsletters, sites de créateurs), puis reels_links sur les 5 à 15 meilleures pages.
• L'utilisateur a donné des créateurs : Instagram ne liste pas les Reels d'un profil sans connexion. Demandez à l'utilisateur les liens des Reels, ou recherchez sur le web des pages qui intègrent les Reels de ce créateur. Exprimez cette limite clairement.

Étape 2 : Définir le résultat

Décidez de la ligne et des colonnes avant de récupérer. Pour les accroches : Reel, créateur, likes/jour, accroche orale (textuelle), texte à l'écran, visuel, type d'accroche, horodatage. Précisez ce qui est qualifié (langue, récence, nombre minimum de likes).

Étape 3 : Lire

• Accroches : references/hooks.md.
• Ce que disent les gens : parts: ["transcript"] avec query pour le thème, puis confirmez le libellé exact avec une plage start/end resserrée.
• Lots de 5 à 10 Reels par appel. Instagram limite les requêtes anonymes en débit ; le serveur les espace, mais n'envoyez pas trop de gros lots en parallèle.

Pour plus d'environ 15 Reels, répartissez-les entre jusqu'à 3 sous-agents parallèles (Agent tool, model: "haiku"), chacun avec ses URL exactes de Reel, le schéma de la ligne, le chemin du fichier de référence, et ces lignes de fin textuelles :

reels_reviewed: N
skipped: <url: raison>, ... (ou "none")

Étape 4 : Vérifier et livrer

• Les citations sont textuelles issues de la transcription ou du texte affiché dans une image (indiquez lequel). La reconnaissance vocale peut mal entendre les noms et marques : corrigez les évidences entre [crochets].
• Vérifiez 2 à 3 lignes par sous-agent avec une récupération start/end étroite.
• Terminez par la couverture : pages scannées, Reels trouvés, Reels lus, ignorés et pourquoi (login_required, not_found, rate_limited, musique uniquement).
• Règles de rédaction : references/synthesis.md.

Échecs

• [rate_limited] : Instagram limite ce IP. Faites une pause de quelques minutes, réessayez les Reels échoués une fois en petit lot, signalez le reste comme ignoré.
• [login_required] : Reel privé, restreint par âge ou par région. Ignorez-le et dites-le.
• [setup] : dites à l'utilisateur la commande exacte du message (généralement npx -y github:jindratilk/reels-research-mcp --setup).