creatorloop

为什么选择它

有很多面向 Claude 的“Instagram API”服务。creatorloop 则围绕创作者的内容循环构建：

• 从数据中学习，而不是凭感觉。 查看表现最好和最差的帖子及其开场文案、格式对比、每 1,000 次触达带来的关注数、Reels 观看时长、最佳日期和时段，以及哪些说明文字（语言、疑问式开场、CTA、长度）确实有效。
• 合法地了解竞争对手。 追踪专业账号并保留其粉丝数历史，在他们的帖子表现高于其中位数 N× 时收到提醒。通过 URL 分析任意公开帖子，包括轮播页。
• 制作内容。 提供 Remotion Reel 模板和自动检查（首秒规则、安全区域、“不能照搬轮播帖子”），以及原创音乐和授权 3D 对象。
• 安全发布。 采用带预览的两步发布流程，提供带文件指纹的队列（文件发生变化就会阻止发布）、24 h / 72 h 帖子复盘和评论回复——每项公开操作都需要你明确确认。
• 仅使用官方 API。 不抓取数据，不自动化浏览器，不会让你的账号面临风险。

快速开始

你需要安装 uv 和 Claude Desktop，拥有一个关联到 Facebook Page 的 Instagram Business 或 Creator 账号，并创建自己的 Meta 应用 （5 分钟指南）。

uvx --from creatorloop creatorloop-setup

它会连接 Claude Desktop 并在浏览器中打开设置页面：输入应用的 App ID 和 App Secret， 点击 Continue with Facebook，即可完成。然后询问 Claude：“我最近 10 个帖子的表现如何？接下来应该发什么？”

已经在使用 Claude？询问 “连接我的 Instagram”：Claude 会打开同一个页面（open_setup）。你的 App Secret 和令牌只会输入到这个本地页面，不会进入聊天。

creatorloop-setup 可以在 Windows（包括 Microsoft Store 版本）、macOS 和 Linux 上找到 Claude Desktop 配置文件，保留其他服务，创建备份并生成设置文件。Claude Desktop 运行时会重写其配置，因此在 macOS 上，该命令会为你退出并重新打开 Claude Desktop；在 Windows 和 Linux 上，则会先提示你退出。

一键安装（Claude Desktop）

不想打开终端？从最新版本下载 .mcpb 文件并双击（或将其拖入 Claude Desktop → Settings → Extensions）。Claude Desktop 会自行设置 Python 和依赖项，因此首次启动需要一分钟。 将两个可选字段留空，然后向 Claude 提问 “连接我的 Instagram”：同一个设置页面就会打开。只有在你已经有令牌和账户 ID 时才填写这些字段——此处输入的值会优先于设置页面中的值。如果 Claude Desktop 提示找不到 uv，请安装它（见上文 安装 uv），然后重启 Claude Desktop。

docker build -t creatorloop https://github.com/pandich93/creatorloop.git
mkdir "$HOME/creatorloop"

docker run --rm -it -p 127.0.0.1:8765:8765 -v "$HOME/creatorloop:/data" --entrypoint creatorloop-auth creatorloop \
  login --no-browser --port 8765 --bind 0.0.0.0

{
  "mcpServers": {
    "creatorloop": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/Users/you/creatorloop:/data", "creatorloop"]
    }
  }
}

你可以询问什么

• “为我过去 60 天的内容制作一份报告。Reels 还是轮播帖效果更好？我应该什么时候发布？”
• “将我的账号与 @competitor1 和 @competitor2 进行比较。谁的互动率更高？原因是什么？”
• “分析这篇帖子 https://www.instagram.com/p/… 并为我写一篇类似的内容。”
• “跟踪 @competitor，每周告诉我他们哪些帖子火了。”
• “检查话题标签 #ai、#productivity 和 #startup。先检查配额。”
• “将文件夹 my-first-reel 中的帖子排入下一个空闲时段。” → 预览 → “是” → 按时发布。
• “有哪些新评论我还没回复？起草回复。” → 由你逐条批准回复。

Claude Desktop 的 + 菜单中提供现成提示词：每周 Instagram 报告、竞争对手简报、数据驱动的内容创意。

工具

总计 34 个工具。会更改 Instagram 内容的工具已标注，供 Claude 识别；工具描述会告知 Claude 只有在你批准后才能执行：publish_media 和 reply_comment 需在你确认预览或确切文本后执行，queue_post 则只有在你看过预览后，且使用 confirm=true 时才会执行。

发布

将文件放入 内容文件夹（<creatorloop home>/content/<name>/）中的一个文件夹：

my-carousel/                   my-reel/
  slide_01.png … slide_10.png    reel.mp4        # H.264/HEVC, 23–60 fps, ≤1920 px wide, 3 s–15 min, ≤300 MB
  caption.txt                    caption.txt
                                 reel.json       # optional: {"cover_ms": 1667, "share_to_feed": true, "trial": "SS_PERFORMANCE"}

• 幻灯片：1–10 张 PNG/JPG（API 限制），宽高比为 4:5 至 1.91:1，按文件名排序。caption.txt 中 --- 行之后的内容为备注，不会发布。
• 然后：“prepare the post from folder my-carousel” → 预览 → “publish”。或者将其排入某个时段。
• 轮播：Instagram 会从公共 URL 下载图片，因此 creatorloop 会在那一分钟开启一个临时的 Cloudflare Quick Tunnel。 只需安装一次 cloudflared：winget install --id Cloudflare.cloudflared -e（Windows）、 brew install cloudflared（macOS），或从 pkg.cloudflare.com 下载软件包（Linux）。
• Reels 会直接上传到 Meta（无需隧道）。上传前会检查 MP4 标头（时长、大小、宽度、 moov 是否位于首位）；如果有问题，会提供精确的 ffmpeg 修复命令。
• 队列时段默认按你所在时区设为周二／周四／周日 19:00——这只是一个示例，可在设置文件中更改 QUEUE_SLOTS。 如果已批准的排队帖子，其文件或说明文字发生更改，该帖子将被阻止；如果你的电脑在预定时段结束 3 小时后仍处于休眠状态，则会标记为错过。
• Meta 的限制是每滚动 24 小时发布 100 条帖子；list_publications 会显示剩余数量。发布操作绝不会自动重试，因此不会产生重复内容。

关于内容本身的制作方法，请参阅 examples/ 和内容工作流——其中包括轮播示例、Reel 分镜示例和 Remotion Reel 模板。

Instagram API 允许和不允许的内容

你发布内容的互动率 = Σ（赞 + 评论 + 收藏 + 分享）/ Σ触达人数 × 100（按触达人数加权，因此小帖子不会造成偏差）。发布未满 72 小时的帖子会单独报告为“仍在增长”。竞争对手的互动率按关注者计算——API 不会公开其触达人数。

设置

creatorloop-setup 会在你的 creatorloop 主文件夹中创建 .env：

设置 CREATORLOOP_HOME 可使用其他文件夹。主文件夹包含 .env、creatorloop.db 数据库和 content/ 文件夹。

令牌过期时间会显示在 get_api_status 中，且每个工具的答复都会在令牌过期前 14 天附带 token_warning。

常见问题

数据与隐私

• 你的令牌、设置、数据库和内容都保留在电脑上的 creatorloop 主文件夹中。
• creatorloop 只与 Meta 通信：Instagram Graph API（graph.facebook.com，视频上传使用 rupload.facebook.com），以及在下载你要求分析的帖子的幻灯片时使用 Instagram 的媒体服务器。
• 发布轮播内容（以及直接上传遭拒时的 Reels）时，它会临时开启 Cloudflare Quick Tunnel，将本地文件提供给 Meta，以便 Meta 获取这些文件；一分钟后关闭隧道并删除临时副本。
• 不会使用分析、遥测或第三方服务。

开发

git clone https://github.com/pandich93/creatorloop && cd creatorloop
uv sync
uv run pytest            # offline: mocked Graph API and captured response shapes
uv run creatorloop-setup # points Claude Desktop at this checkout instead of the PyPI package

请参阅 CONTRIBUTING.md。安全问题：SECURITY.md。

免责声明

creatorloop 是一个独立的开源项目。与 Meta 或 Instagram 无关，亦未获得其认可或赞助。“Instagram”是 Meta Platforms, Inc. 的商标。使用本项目时，你有责任遵守 Meta 平台条款和 Instagram 的政策。

许可证

MIT。examples/reel-template 中的 Reel 模板使用了 Remotion，其有自己的许可证；打包的资源和字体列于 examples/reel-template/public/assets/LICENSES.md。