如何使用 Claude Code 将 Instagram Reels 转变为每日内容研究系统

Instagram 研究工具的功能

Instagram 研究工具会将已保存的 Reels 和细分领域搜索结果转换为可搜索的研究库。借助 Claude Code，它可以分析 Reel 的文字稿、钩子、形式、切入角度、表现数据、视觉结构以及可能吸引用户停留的关键时刻。

它还会生成每日异常表现报告，突出显示在你的细分领域中表现异常出色的 Reels。每份分析最后都会根据你的 voice.md 文件中描述的风格，创作一个新的钩子和脚本，而不是复制原创作者的内容。

生成的素材库会在浏览器中打开，你可以比较已研究的 Reels，并在拍摄前重新查看创意。

所需条件

• Claude Code
• Node.js 18 或更高版本
• 一个数据源，例如 Sandcastles、Apify、yt-dlp 或你自己的数据
• 可选：ffmpeg，用于逐帧视觉分析
• 可选：Whisper，当你的服务提供商不提供文字稿时用于本地转录
• 可选：一部 iPhone，用于通过“分享”按钮保存 Reels

该项目没有任何 npm 依赖项。如果你需要提取视频帧，请使用 brew install ffmpeg 安装 ffmpeg。如需本地转录，请使用 pipx install openai-whisper 安装 Whisper。

选择数据源

数据提供商负责获取视频文件、字幕、文字稿和表现数据等源材料。分析由 Claude Code 执行，因此你可以更换数据提供商，而无需改变分析流程。

• Sandcastles：付费 MCP 提供商，提供 Reel 分析数据、带时间戳的文字稿、钩子分析和异常表现搜索。MCP 要求 Pro 计划或更高版本。
• Apify：通过按结果付费的 Actor 提供 Reel 数据和视频文件。它支持每日主题标签搜索，并按每小时观看次数排序，而不是按异常表现分数排序。
• yt-dlp：适用于单个公开 Instagram、TikTok 和 YouTube Shorts 链接的免费选项。它可以使用本地 Whisper 生成文字稿，但 Instagram 的观看次数可能无法获取。
• 任意来源：你可以使用视频文件、其他服务的导出数据，或自行输入的数据。

你可以针对不同任务使用不同的提供商，例如使用 yt-dlp 处理单个 Reel，使用 Apify 或 Sandcastles 进行每日搜索。提供商专属说明位于仓库的 providers 目录中。

安装并运行设置向导

1. 克隆仓库并进入其目录：

git clone https://github.com/manthanpatelll/instagram-research-tool.git
cd instagram-research-tool
claude

1. 在 Claude Code 中启动首次运行向导：

/research-setup

向导会询问你想使用的提供商，连接所需服务，询问你的细分领域，创建每日搜索查询，并通过你的三条字幕了解你的写作风格。它还会指导你完成可选的 iPhone 分享流程，并运行自检。

仓库会将主要设置存储在 config.json 中，将细分领域搜索存储在 niche.json 中，并将写作指导存储在 voice.md 中。设置完成后，如需手动优化结果，可以查看这些文件。

先体验示例工作流

无需连接数据提供商即可查看项目。随附的示例使用合成数据，不代表真实创作者。

npm run library
npm run sample-report
npm run selftest

• npm run library 打开示例 Reel 素材库。
• npm run sample-report 打开示例异常表现报告。
• npm run selftest 运行离线检查。运行成功时会以代码 0 退出。

分析单个 Reel

完成设置后，将公开 Reel 链接传递给 Reel 研究技能：

/reel-research <reel link>

工具会获取可用的源数据，将其标准化，在必要时转录视频，并使用提取的帧进行视觉分析。结果会保存为 library/reels/ 中的 JSON 文件，并显示在浏览器素材库中。

典型的分析包括：

• 观看次数、点赞数、评论数、互动率、可用时的异常表现分数，以及发布日期
• 带时间戳的文字稿
• 开场钩子、钩子类型、词数、表达时长、关键有力词，以及有效原因说明
• Reel 的类别、视觉布局、节奏和形式
• 主题、具体切入角度、普遍认知和对比性观点
• 逐镜头视觉时间线，包括屏幕文字和留存目的
• 两个至五个可能吸引用户停留的关键时刻及其时间戳
• 以你的声音创作的新钩子和完整脚本

从收件箱处理已保存的 Reels

如果你使用可选的 iPhone 工作流，请在 Reel 上点击“分享”，然后选择保存到研究。该快捷指令会将链接写入 iCloud Drive 中的收件箱文件，并可同步到 Mac。

要处理已保存的链接，请运行：

/reel-research inbox

工具会读取新链接，使用你选择的提供商进行分析，并将结果添加到素材库。没有 iPhone 时，你可以直接将链接粘贴到 Claude Code 中，或将 config.json 中的 inboxPath 指向另一个会与电脑同步的文本文件。

生成每日异常表现报告

异常工作流会搜索你配置的细分领域、筛选结果、合并重复项，并为符合条件的 Reels 排名。默认情况下，它会检查过去 24 小时的数据，并排除观看次数少于 2,000 的 Reels。如果符合条件的 Reels 少于 15 条，时间范围最多可扩展至 48 小时。

/outliers

报告会保存到 reports/，并以 HTML 页面打开。Claude Code 还会在聊天中解释排名前 10 的结果，并为你的内容提出一个创意角度。

如需扩大搜索时间范围，请使用：

/outliers --48h

默认的每日搜索会使用 niche.json 中的查询词。请将这些查询词整理成不同集群，以反映你所在细分领域的创作者实际为 Reels 添加说明和撰写文案的方式。

了解处理流程

项目按照清晰的顺序，将源数据转化为研究输出：

1. Reel 链接、视频文件或源导出文件进入工作流。
2. 选定的提供商提供数据、说明文字、视频或转录文本。
3. 工具使用提供商的转录文本；当转录设置为 auto 时，则回退到本地 Whisper。
4. frames.mjs 使用 ffmpeg 创建联系表，以便进行视觉查看。
5. Claude Code 分析开场钩子、格式、角度、视觉内容和留存关键时刻。
6. 完成的拆解结果会保存为 JSON，并通过 out/library.html 显示。
7. 异常工作流会保存原始搜索数据、进行筛选和排名，并生成 HTML 报告。

配置重要设置

打开 config.json 以调整工作流：

• provider 选择单个 Reel 的来源：sandcastles、apify、ytdlp 或 any。
• searchProvider 选择 Sandcastles 或 Apify 作为每日搜索提供商。
• inboxPath 指定同步收件箱文件。
• windowHours 控制正常的异常搜索时间范围。
• maxWindowHours 限制报告可扩展的最大搜索时间范围。
• minViews 从报告中移除低观看次数结果。
• transcription 控制使用源转录文本还是本地 Whisper。
• myHandle 可选，用于保存你的 Instagram 用户名。

缺失的表现数据会保持为空。工具不会编造数值，因此来自元数据有限的来源的结果可能会显示未知的观看次数或互动次数。

自动化每日早晨研究

该代码库包含使用 cron 或 macOS launchd 自动执行收件箱和异常工作流的指南。相关示例会运行如下命令：

claude -p "/reel-research inbox"
claude -p "/outliers"

有关 iPhone 分享设置和可选的每日自动化示例，请参阅 docs/iphone-shortcut.md。启用任何计划任务前，请先进行检查，尤其是在所选提供商按结果或按分析收费的情况下。

使用研究成果，而不是照搬内容

该工具用于研究创意，而不是转载内容。将 Reel 的主题、角度和形式作为研究素材，然后加入你自己的经历、成果、产品或观点。

生成的我的版本部分旨在用你的声音生成新的措辞。它不会重复使用创作者的原话、笑话或故事，项目还会在保存前检查是否存在抄袭短语。下载的视频会保留在你的电脑上用于分析，不应重新上传。

结语

Instagram Research Tool 将 Claude Code 与数据提供商结合起来，让 Reel 研究变得可重复。完成设置后，你可以从手机保存 Reels、逐条分析、查看每日异常报告，并根据已验证的形式和角度开发原创脚本。

先从示例命令开始，运行 /research-setup，然后完善 niche.json 和 voice.md，让研究结果符合你的受众和写作风格。