Instagram Mcp Server

📸 Instagram MCP 服务

通过 Claude 控制你的 Instagram——发布内容、分析数据、回复私信、管理评论。只需聊天即可完成。

---

🎬 演示 GIF 即将推出——Claude 发布 Reels、查看数据分析，并实时回复评论。

---

你可以做什么

用日常语言向 Claude 提出请求。它会处理 API。

"Show my last 10 posts and which got the most reach"
"Post this image with caption: Monday motivation 💪 #AI #Health"
"Read my DMs from today and draft replies for the questions"
"Hide all spam comments on my latest reel"
"What are my account insights for this week?"
"Which of my reels got the best watch time?"

---

使用场景

📊 内容创作者

• 每日简报：“展示昨天帖子的表现——触达人数、收藏量、分享量”
• 策略：“按触达人数比较我最近的 5 条 Reels，并告诉我哪些内容效果好”
• 排期准备：“为这条健身帖子起草 3 个文案选项”

🏥 医生 / 专业人士

• 互动：“以专业的方式回复我最近帖子下的所有评论”
• 增长追踪：“我这周增加了多少粉丝？”
• 内容审查：“列出本月的所有帖子及其互动率”

🛍️ 小型企业

• 客户服务：“显示过去 24 小时内的私信，并回复有关订单的问题”
• 发布内容：“发布这张产品照片，配上这段文案和这些话题标签”
• 数据分析：“哪种帖子类型（Reel / 轮播 / 照片）能带来最多触达？”

---

工具（共 14 个）

类别	工具	功能
账户	get_account_info	粉丝数、简介、帖子数
	update_profile	更新简介文本和 / 或网站 URL
	list_recent_media	最近 N 条帖子的互动数据
	get_account_insights	触达人数、主页浏览量、粉丝增长情况
数据分析	get_media_insights	单条帖子的触达人数、收藏量、浏览量、互动量
发布内容	publish_photo	发布带有文案和话题标签的照片
	publish_reel	发布 Reel（视频）
	publish_carousel	将 2–10 张图片作为轮播内容发布
评论	get_comments	查看帖子下的所有评论
	reply_to_comment	回复评论
	hide_comment	隐藏垃圾评论 / 不想要的评论
	delete_comment	永久删除评论
互动	like_media	为帖子或 Reel 点赞
	unlike_media	取消对帖子或 Reel 的点赞
	like_comment	为评论点赞
内容	delete_post	永久删除帖子
话题标签	search_hashtag	按话题标签搜索公开帖子
活动	list_events	列出即将举行的活动
	create_event	创建新活动（健康营、工作坊）
广告	get_ad_accounts	列出关联的广告账户
	get_ad_insights	获取广告支出、触达人数、点击率
私信	list_conversations	列出活跃的私信对话
	get_messages	查看对话中的消息
	send_dm	回复私信（24 小时窗口期）
	send_human_agent_dm	在 7 天人工客服窗口期内回复

---

快速开始

选项 A — Claude 网页版 + 移动端（推荐）

1. 部署你的服务（免费，2 分钟）：

按提示填写 META_ACCESS_TOKEN 和 IG_USER_ID。（如何获取这些信息 ↓）

2. 连接到 Claude 网页版：

• claude.ai → Settings → Integrations → Add Integration
• 粘贴：https://your-app-name.onrender.com/mcp

3. 完成。 开启新聊天并尝试：“显示我最近的 Instagram 帖子”

---

选项 B — Claude Desktop（本地）

git clone https://github.com/drashrafsaiyed-cyber/instagram-mcp
cd instagram-mcp
uv sync
cp .env.example .env
# Fill .env with your token and user ID
uv run server.py

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "instagram": {
      "command": "uv",
      "args": ["--directory", "/path/to/instagram-mcp", "run", "server.py"],
      "env": {
        "META_ACCESS_TOKEN": "your_token",
        "IG_USER_ID": "your_ig_user_id",
        "ACCOUNT_NAME": "My Instagram"
      }
    }
  }
}

---

选项 C — 多个 Instagram 账号（Claude Desktop）

使用不同的环境变量，多次运行同一个服务文件夹。Claude 会将它们识别为名称不同的独立 MCP，绝不会混淆。

{
  "mcpServers": {
    "instagram-personal": {
      "command": "uv",
      "args": ["--directory", "/path/to/instagram-mcp", "run", "server.py"],
      "env": {
        "META_ACCESS_TOKEN": "TOKEN_FOR_ACCOUNT_1",
        "IG_USER_ID": "IG_USER_ID_1",
        "ACCOUNT_NAME": "Personal"
      }
    },
    "instagram-business": {
      "command": "uv",
      "args": ["--directory", "/path/to/instagram-mcp", "run", "server.py"],
      "env": {
        "META_ACCESS_TOKEN": "TOKEN_FOR_ACCOUNT_2",
        "IG_USER_ID": "IG_USER_ID_2",
        "ACCOUNT_NAME": "My Business"
      }
    }
  }
}

Claude 会为每个账号显示单独的工具——“把这条内容发布到我的企业账号” 会自动选择正确的工具。

每个账号都必须是 Business 或 Creator Instagram 账号，并且必须在 Meta 应用中添加为测试者 → 用例 → 第 2 步：生成访问令牌 → 添加账号。

---

获取令牌

此服务使用 Instagram Login API（graph.instagram.com）——这是 Meta 为 Instagram Business/Creator 账号提供的现代方案。

第 1 步 — 创建或打开 Meta 应用

1. 前往 developers.facebook.com → My Apps
2. 创建新应用或打开现有应用
3. 添加用例：“管理 Instagram 上的消息和内容”

第 2 步 — 生成访问令牌

1. 用例 → 自定义 → 使用 Instagram Login 进行 API 设置
2. 第 2 步：生成访问令牌 → 点击账号旁边的“生成”
3. 复制令牌 → 这就是你的 META_ACCESS_TOKEN
4. 数字形式的 IG User ID 显示在同一页面上的用户名下方

第 3 步 — 在令牌过期前刷新（60 天）

curl "https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=YOUR_TOKEN"

或者直接在项目文件夹中运行：

uv run python -c "
import httpx, re
from pathlib import Path
env = Path('.env').read_text()
token = re.search(r'META_ACCESS_TOKEN=(.+)', env).group(1).strip()
r = httpx.get('https://graph.instagram.com/refresh_access_token', params={'grant_type':'ig_refresh_token','access_token':token})
new = r.json()['access_token']
Path('.env').write_text(env.replace(token, new))
print('Refreshed. Expires in:', r.json()['expires_in']//86400, 'days')
"

---

要求

• Instagram Business 或 Creator 账号
• Meta Developer 应用，且包含 “管理 Instagram 上的消息和内容” 用例
• Python 3.11+

发布须知： 图片和视频必须使用公开的 HTTPS URL——Instagram 会从你的 URL 获取内容。可以使用 Cloudinary（免费）、S3，或公开的 GitHub raw URL。本地文件路径无法使用。

---

架构

Claude (Web/Desktop)
      │  MCP protocol
      ▼
instagram-mcp server  (FastMCP 3.x, streamable-http or stdio)
      │  HTTPS REST
      ▼
graph.instagram.com   (Instagram Login API v21.0)
      │
      ▼
Your Instagram account

为什么使用 graph.instagram.com，而不是 graph.facebook.com？ 此服务使用较新的 Instagram Login API，该 API 会颁发 IGAA... 令牌，并通过 graph.instagram.com 路由。较早的 Facebook Graph API 方案要求关联 Facebook Page，并使用 EAA... 令牌。新流程更简单——只需 Instagram 账号，无需 Facebook Page。

---

故障排除

错误	解决方法
Cannot parse access token	令牌已过期或类型不正确。按照上述步骤重新生成。
insights 中出现 code 100	指标名称无效。账号端点和媒体端点的指标有所不同。
code 190	令牌已过期。运行刷新命令。
容器处理失败	视频过长（>90s）、编码格式错误，或 URL 在首次获取后返回 404。
DM 列表为空	当前没有有效的 24 小时消息窗口。需要有人先给你发 DM。
Claude 看不到工具	完全重启 Claude Desktop（托盘图标 → 退出）。查看 %APPDATA%\Claude\logs\ 中的日志。

---

贡献

欢迎提交 PR。如果你添加新工具或修复指标名称不匹配的问题，请：

1. 使用真实的 Instagram 账号进行测试
2. 更新此 README 中的工具表格
3. 注明新工具需要的 API 权限

---

许可证

MIT — 可免费使用、分叉和用于商业部署。

---

基于 FastMCP 构建 · 由 Instagram Graph API 提供支持