mcpField
I
instagram-replicate

instagram-replicate

github.com/jpcaparas创意与媒体5690 次安装1 天前更新
代码仓库

关于 instagram-replicate

将一个公开 Instagram 视频帖子或 reel 制作为可重渲染本地副本的 Skill，适合制作可播放的帖子风格素材。它冻结帖子数据和媒体，并输出 MP4 与不超过 24 MB 的 GIF。

主要功能

  1. 01捕获公开帖子的快照
  2. 02下载头像、封面帧和视频
  3. 03用本地 HTML/CSS 重建帖子布局
  4. 04通过 Playwright 录制副本
  5. 05导出 MP4 和 GIF 素材

适用场景

  1. 01制作可播放的 reel 副本
  2. 02保存帖子的文案和计数
  3. 03稍后重新渲染冻结帖子
  4. 04基于本地 HTML 调整布局

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jpcaparas/skills --skill instagram-replicate

安装后在 Claude Code 中输入/instagram-replicate确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

AGENTS.md
metadata.json
README.md
skill-card.prompt.md
agents/
openai.yaml
assets/
.gitkeep
evals/
evals.json
references/
gotchas.md
layout.md
workflow.md
scripts/
fetch_instagram_snapshot.py
probe_instagram_replica.py
record_instagram_replica.py
render_instagram_replica.py
test_skill.py
validate.py
templates/
instagram_replica.html

详细介绍

Instagram Replicate

将一个公开的 Instagram 视频帖子或 Reels 固定为可重新渲染的本地构建，始终生成 instagram-replica.mp4 和 instagram-replica.gif，并将 GIF 控制在 24 MB 以下。

已于 2026 年 4 月 12 日根据 Instagram 公开页面进行验证。

先说清楚限制

不要承诺能克隆出浏览器级别的 Instagram，也不要承诺结果永远稳定。Instagram 可能会更改布局，计数会有变化，可能出现登录拦截页，媒体 URL 也会过期。本地渲染器有意采用确定性方式，而不是复现 Instagram 的私有渲染器。

此技能擅长完成以下工作：

  • 将一个公开 Instagram 帖子捕获到固定的 snapshot.json
  • 在本地下载头像、海报帧和主视频
  • 使用确定性的本地 HTML/CSS 重建桌面端未登录帖子的界面
  • 使用 Playwright 录制本地页面
  • 在同一目录中导出稳定的 MP4 和配套 GIF

决策树

  1. 如果用户想将一个公开的 Instagram 视频帖子或 Reels 重建为本地视频资源，运行 scripts/render_instagram_replica.py。
  2. 如果用户只需要说明文字、计数、评论或媒体 URL，请使用文本／媒体提取工作流，而不是此技能。
  3. 如果用户只需要原始媒体文件，请使用媒体下载工具，而不是此技能。
  4. 如果用户想要实时录制 Instagram 浏览器页面，请停止并说明此技能用于制作确定性的本地副本，而不是录制真实的 Instagram UI。
  5. 如果用户需要轮播帖子、个人主页网格、Stories、私信或已认证状态，请说明此版本仅支持对单个公开帖子页面进行副本重建，且只包含一个主要媒体项目。

默认保存路径规则

如果用户未指定目标路径，首先建议使用 ./pieces/。如果用户同意或不介意，请使用 --save-root ./pieces 运行，或让脚本默认使用当前工作目录下的 pieces/ 文件夹。

生成的构建目录结构保持不变：

<save-root>/instagram-replicate-post-<shortcode>-<timestamp>/
  assets/
  snapshot.json
  instagram-replica.html
  capture.webm
  instagram-replica.mp4
  instagram-replica.gif

快速参考

任务命令用途
将公开 Instagram 帖子渲染到默认指定的保存根目录python3 scripts/render_instagram_replica.py 'https://www.instagram.com/p/...' --save-root ./pieces在 ./pieces/ 下创建可重新渲染的构建文件夹
稍后重新渲染同一已固定的帖子python3 scripts/render_instagram_replica.py ./instagram-build/snapshot.json保存到快照旁边，并避免计数变化
将所有内容保存在同一个命名构建文件夹中python3 scripts/render_instagram_replica.py '<url>' --workdir ./instagram-build将快照、本地资源、HTML、WebM、MP4 和 GIF 放在一起
仅检查提取出的快照python3 scripts/fetch_instagram_snapshot.py '<url>' --output ./instagram-build/snapshot.json --asset-dir ./instagram-build/assets适用于微调布局前的检查
仅录制已准备好的 HTML 副本python3 scripts/record_instagram_replica.py ./instagram-build/instagram-replica.html ./instagram-build/capture.webm适用于调整 CSS 而无需重新获取数据
使用 Instagram 实时 URL 运行真实管线检查python3 scripts/probe_instagram_replica.py 'https://www.instagram.com/p/...' --save-root ./tmp-tests --cleanup验证 MP4、GIF、时长以及 GIF 大小上限

范围

正向触发条件
  • “复刻这个 Instagram 帖子”
  • “复刻这个 Reels”
  • “把这个 Instagram 视频转换成 MP4 和 GIF”
  • “将这个 Instagram 帖子固定为视频”
  • “让这个帖子看起来像 Instagram”
  • “可播放的 Instagram 截图”
  • “保留说明文字、计数、评论预览、播放效果和可重新渲染的构建”
负向触发条件
  • 仅阅读或提取 Instagram 说明文字
  • 仅下载原始媒体
  • 实时嵌入调试
  • 个人主页网格、信息流、Stories、私信
  • 重建轮播帖子
  • 声称输出是 Instagram 的精确浏览器级克隆

工作原则

以快照为准，而不是以实时 Instagram 页面为准。只获取一次数据，固定数据，然后基于 snapshot.json 在本地迭代。

阅读指南

需求阅读
端到端工作流、保存根目录行为和产物布局references/workflow.md
布局启发式规则、尺寸规则和调优选项references/layout.md
故障模式、GIF 尺寸、偏移和不支持的情况references/gotchas.md

注意事项

  1. 计数很快就会变化。如果用户关注特定时刻的点赞数或评论数，请从 snapshot.json 重新渲染。
  2. GIF 是预览资源，不是第二个主视频。为确保文件大小不超过 24 MB，渲染器会按需降低 GIF 的分辨率、帧率和调色板深度。
  3. 此渲染器会在本地重建桌面版帖子界面，不保证与 Instagram 自身的渲染结果逐字节或逐像素一致。
  4. Instagram 的公开媒体 URL 可能会过期。如果之后可能需要复现输出，请将下载的本地媒体保存在工作目录中。
  5. Playwright 的视口录制仅包含视觉内容。如果本地视频文件带有音轨，最终 MP4 会重新混入原始媒体音频。GIF 不包含音频。
  6. 登录弹窗、相关帖子网格和部分账户元数据会因地区和时间而异。此技能会有意渲染简洁的帖子页面外壳，而不是重放所有实时插页内容。

评论

支持 Markdown