instapdown-mcp

instapdown-mcp

将 16 款 Instagram 创作者工具封装为 Model Context Protocol 服务。 它封装了 instapdown.com 背后的公开 API 和数据，因此任何 MCP 客户端——Claude Desktop、Cursor、Cline、Zed——都能在聊天中直接下载 Reels、审查互动情况、搜索话题标签、生成 Reels 开场钩子、获取特定国家的最佳发布时间数据，并浏览 2026 年内容日历。

它是 TapDown 家族的一员，与 xtapdown-mcp（X / Twitter）并列。

---

安装

npx -y instapdown-mcp

安装就这么简单。无需账号、API 密钥或配置。

Claude Desktop 配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "instapdown": {
      "command": "npx",
      "args": ["-y", "instapdown-mcp"]
    }
  }
}

重启 Claude Desktop。在新聊天中：

“帮我下载这个 Reel：https://www.instagram.com/reel/ABC123/”

Claude 会调用 download_reels，并返回 MP4 直链和音轨。

---

16 款工具

下载工具

工具	输入	返回内容
download_reels	Reel URL	原始 9:16 高清 MP4，无水印
download_video	信息流视频 URL	原始 MP4，不重新编码
download_story	用户名	24 小时有效期内所有活跃的 Story
download_profile_picture	用户名	全分辨率个人资料 JPG
download_carousel	轮播帖 URL	以媒体数组形式返回每张幻灯片
download_photo	单图帖子 URL	原始全分辨率 JPG
extract_reel_audio	Reel URL	源 m4a 音轨 URL

仅支持公开账号。私密账号会按设计返回 HTTP 422。

分析

工具	输入	返回内容
engagement_health_check	用户名	根据最近 12 条帖子计算的加权 ER、收藏率、评论率和层级基准
engagement_calculator	粉丝数 + 互动量	加权 ER（点赞×1 + 评论×2 + 收藏×3 + 分享×4）、层级基准和表现评级

内容策略

工具	输入	返回内容
generate_reels_hooks	细分领域 + 可选国家/语言	从 900 条开场钩子库中选出的 10 个经验证的 2026 年钩子模板
search_hashtags	主题 + 地区	返回话题标签对应的真实 Instagram 帖子数
get_hashtag_niche	可选类别	25 个精选种子细分领域
audit_creator_hashtags	用户名	根据最近 12 条帖子生成的话题标签频率表
generate_instagram_fonts	文本 + 可选样式	22 种 Unicode 字体变体（粗体、斜体、手写体、哥特体、双线体、等宽、小型大写字母、带圈、倒置，……）
get_best_time_to_post	国家代码	5 个黄金时段 + 7 天热力图，数据来源为 Buffer 2026（超过 3,000 万条帖子）
get_content_calendar	市场 + 日期范围 + 细分领域	2026 年 Instagram 内容日期，每个日期都包含原生语言的 Reels 开场钩子和话题标签集

因国家而异的工具支持以下市场：US、GB、CA、AU、BR、MX、ES、IT、DE、FR、NL、SE、TR、JP、SA、AE、RU。

---

环境

在本地开发并连接到 Instapdown 预发布环境时，可覆盖 API 主机：

INSTAPDOWN_BASE_URL=http://localhost:3000 npx -y instapdown-mcp

默认值：https://instapdown.com。

---

开发

git clone https://github.com/farukkolip/instapdown-mcp
cd instapdown-mcp
npm install
npm run build
node dist/test/smoke.js   # in-memory smoke test — 16 tools + 6 offline callable

---

许可证

MIT © Ömer Faruk Kolip

Instapdown 与 Meta Platforms, Inc. 或 Instagram 无关联，也未获其认可或赞助。仅支持公开内容。