scrapesocial-instagram

Scrapesocial Instagram

使用此 skill 进行只读的 Instagram 研究和信息检索。保持在任务到命令的层级：快速选择合适的入口，优先使用较精简的响应，并复用先前命令返回的 ID 或游标。

前提条件

• 使用此 skill 需要 Scrape Creators API 密钥。请前往 scrapecreators.com 获取。

快速设置

安装一次 CLI：

npm install -g scrapesocial

使用 SCRAPECREATORS_API_KEY 进行身份验证，然后通过 scrapesocial 运行命令：

SCRAPECREATORS_API_KEY=... scrapesocial instagram ...

常用全局标志：

• 支持时使用 --trim 获取较小的响应。
• 将列表流式传输到下游工具时使用 --format jsonl。
• 想让 CLI 隐藏或阻止高成本请求时，使用 --credit-limit <n>。

快速入门

• 如果任务涉及整个账号，请从 instagram profiles get 开始。
• 如果任务涉及创作者的常规动态，请使用 instagram posts。
• 如果任务涉及某条特定帖子或短视频，请使用 instagram posts get。
• 如果任务涉及短视频或视频帖子的口述内容，请使用 instagram transcript。
• 如果任务涉及按主题查找相关短视频，请使用 instagram reels search。
• 如果任务涉及某条帖子的受众反馈，请使用 instagram comments。
• 如果任务涉及创作者的短视频库，请使用 instagram reels。
• 如果任务涉及快拍精选，请使用 instagram highlights，然后使用 instagram highlights detail。
• 如果任务涉及可嵌入的个人主页标记，请使用 instagram embed。

目标导向的工作流

目标	适用场景	开始方式
潜在客户开发	用于筛选已知的创作者或品牌账号，或将 Reels 搜索结果整理成候选名单。可搭配其他来源获取联系方式。	从 instagram reels search 开始，然后切换到 instagram profiles get、instagram posts 或 instagram reels 进行筛选。
网红发现	当用户希望通过细分领域的 Reels、反复出现的主题和账号质量来发现或评估创作者时使用。	从 instagram reels search 开始，然后用 instagram profiles get、instagram reels 和 instagram highlights 验证入围账号。
品牌监测	用于监测已知品牌或创作者账号的动态帖子、Reels 和精选动态。	从 instagram profiles get 开始，然后扩展到 instagram posts、instagram reels 和 instagram highlights。
竞品分析	用于比较多个品牌或创作者如何呈现其动态、Reels、精选动态以及受众反馈。	对每个账号使用 instagram profiles get 开始，然后比较代表性内容中的 instagram posts、instagram reels 和 instagram comments。
内容分析	结合内容详情、评论和转录文本，解释某些帖子或 Reels 表现出色的原因。	从 instagram posts 或 instagram reels 开始，然后用 instagram posts get、instagram comments 和 instagram transcript 深入分析表现突出的内容。
趋势研究	用于基于 Reels 发掘主题，并验证新兴的创意模式。	从 instagram reels search 开始，然后用 instagram posts get 查看最佳示例。
受众分析	用于分析受众使用的定性语言、常见问题和异议。不提供受众人口统计数据细分。	对具有代表性的帖子或 Reels 使用 instagram comments 开始，然后用 instagram profiles get 和 instagram highlights 获取背景信息。

需要完整的命令选择表时，请阅读 references/instagram-command-map.md。

选择起始输入

• 用户正在研究某个账号，且暂时没有更具体的标识符时，优先使用 --handle。
• 用户提供了某条具体帖子或 Reel 时，优先使用 --url。这是检查单条内容或获取其评论、转录文本的最简便方式。
• 仅在其他命令已返回 --user-id 后才使用它。对于 Reels 和精选动态，使用它可能比再次通过账号名称解析更快。
• 优先使用返回的分页令牌，而不是重新开始查询。Instagram 命令使用特定于命令的游标字段，例如 next_max_id、max_id 或 cursor。
• 列出精选动态后，若要深入查看某个精选动态，优先使用返回的精选动态 ID。

工作模式

1. 从与任务匹配的最高级别命令开始。
2. 如果目标是快速检查、总结或便于后续处理，请在支持 --trim 的命令中使用它。
3. 保留响应中的 ID 和游标，以便后续命令无需重复相同的发现步骤。
4. 只有在需要较小响应可能省略的字段时，才在不使用 --trim 的情况下重新运行命令。
5. 首次查找后，如果命令支持且工作流需要分页，请从基于句柄的命令切换为基于 ID 的命令。

常见流程

审核创作者账号

先使用 instagram profiles get 了解账号，然后按需选择：

• 使用 instagram posts 查看信息流历史记录。
• 使用 instagram reels 查看短视频内容。
• 使用 instagram highlights 查看归档的快拍。
• 如果需要的是可嵌入标记而非分析结果，请使用 instagram embed。

分析单条帖子或短视频

如果用户提供了单个 Instagram URL，并希望获取元数据或内容详情，请使用 instagram posts get。仅在需要时继续选择：

• 使用 instagram comments 查看受众反应。
• 使用 instagram transcript 提取视频内容中的语音对话。

研究 Instagram Reels 上的某个主题

使用 instagram reels search 发现主题内容、考察趋势或收集种子内容。如果发现了感兴趣的特定短视频，请使用该短视频的 URL 转而运行 instagram posts get 或 instagram comments。

命令说明

• 如果你已拥有用户 ID，且只需要更精简的基本个人资料视图，那么 instagram profiles basic 是一个较少用到的后续命令。
• instagram highlights detail 并非发现命令。只有在 instagram highlights 返回了你需要的精选动态 ID 后，才使用它。
• instagram comments、instagram posts 和 instagram reels 支持分页。迭代收集时请保留返回的游标值。
• instagram transcript 仅适用于包含语音的媒体内容。
• 此 CLI 用于检索和分析，不用于在 Instagram 上发布内容、发送消息、点赞或执行其他写入操作。

参考

请阅读 references/instagram-command-map.md，其中包含逐条命令的对照表，介绍了典型输入、结果和后续操作。