Communitygithub.com

jindratilk/reels-research-mcp

通过 reels_* MCP 工具研究 Instagram Reels:从 URL 读取 Reels(详细信息、带时间戳的转录、真实帧),提取多个 Reel 中的吸引点、引用和屏幕文字,比较创作者的开场方式,并从网页收集 Reel 链接。适用于“分析这些 Reels 的吸引点”、“这些创作者对 X 有什么看法”、“找到关于 Y 的 Reels 并分析其开场方式”等请求。

reels-research-mcp 是什么?

Reels Research Orchestrator 是一个 Instagram Reels 研究工具,通过 MCP 协议提供 reels_* 系列工具。它无需登录即可从用户提供的链接或网页中提取 Reels 数据,支持详细资料、语音转文本转录(基于 Parakeet Redux 模型,覆盖 25 种欧洲语言)、实时刻画帧、评论和封面。该技能特别适用于分析创作者的内容策略,如研究吸引点(hooks)、引用和屏幕文字。它支持并行子代理处理大规模 Reels 集合(最多 20 个 Reels 每调用),并提供错误处理机制(速率限制、登录要求、未找到等)。主要限制包括无法在 Instagram 内部搜索、无法查看个人主页的 Reels 列表、以及音乐 Reels 无语音转录。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jindratilk/reels-research-mcp/tree/HEAD/skills/reels-research

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Reels 研究编排器

您进行研究;reels_* 工具负责获取数据。无需登录,因此请提前了解限制:

  • 不支持在 Instagram 内部搜索。 Reels 来自用户提供的链接,或通过 reels_links 来自网页。
  • 转录是本地语音转文本(Parakeet Redux,支持 25 种欧洲语言),来自 Reel 的音频。纯音乐 Reels 没有语音;其信息在屏幕文字中,因此请使用帧。
  • 不支持深度链接到具体秒数。 引用格式为:@用户 · Reel URL · 0:03。

工具:

  • reels_fetch:每次调用最多 20 个 Reels;参数包括 details、transcript、frames、comments、cover;start/end 范围;query 用于匹配段落;frames/frameAt 用于实时刻画帧。
  • reels_links:从 1-15 个网页获取 Reel 链接。
  • reels_doctor:如果任何操作失败,运行一次。

第一步:获取 Reels

  • 用户提供了链接: 直接使用。按短码去重。
  • 用户提供了一个主题: 阅读 references/finding-reels.md。简而言之:在网页上搜索嵌入或列出该主题 Reels 的页面(文章、“最佳 Reels”合集、新闻通讯、创作者网站),然后在最佳的 5-15 个页面上执行 reels_links。
  • 用户提供了创作者: Instagram 不登录无法列出某个主页的 Reels。向用户索要 Reel 链接,或搜索嵌入该创作者 Reels 的网页。明确说明这一限制。

第二步:定义结果格式

在获取数据之前确定行和列。例如,对于吸引点:Reel、创作者、平均每日点赞数、语音吸引点(逐字)、屏幕文字、视觉效果、吸引点类型、时间戳。明确说明筛选条件(语言、时效性、最低点赞数)。

第三步:读取数据

  • 吸引点:参考 references/hooks.md。
  • 人们谈论的内容:使用 parts: ["transcript"] 配合 query 搜索主题,然后通过紧密的 start/end 范围确认准确措辞。
  • 每次调用处理 5-10 个 Reels。Instagram 对匿名查询有速率限制;服务器会间隔处理,但不要并行发起大量大规模批次。

对于超过约 15 个 Reels 的情况,将它们拆分为最多 3 个并行子代理(Agent 工具,model: "haiku"),每个子代理包含确切的 Reel URL、行模式、参考文件路径,以及以下结尾行(逐字):

reels_reviewed: N
skipped: <url: 原因>, ... (如果没有则为 "none")

第四步:验证并交付

  • 引用必须逐字来自转录或帧中的屏幕文字(注明来源)。语音转文本可能误听名称和品牌:在[方括号]中修正明显错误。
  • 对每个子代理的 2-3 行使用狭窄的 start/end 范围进行抽查。
  • 最后提供覆盖范围:扫描的页面数量、找到的 Reels 数量、读取的 Reels 数量、跳过的 Reels 及原因(login_required、not_found、rate_limited、音乐-only)。
  • 撰写规则:参考 references/synthesis.md。

故障处理

  • [rate_limited]:Instagram 正在限制此 IP。暂停几分钟,将失败的 Reels 以小型批次重试一次,其余报告为跳过。
  • [login_required]:Reel 为私密、年龄限制或地区限制。跳过并说明原因。
  • [setup]:告诉用户消息中的确切命令(通常是 npx -y github:jindratilk/reels-research-mcp --setup)。

相关技能