INSSIST

@inssist/mcp

通过 INSSIST Chrome 扩展，让 AI Agent 在你自己已登录的 Instagram 会话中工作的 MCP 服务。

完整文档和安装说明：https://inssist.com/instagram-mcp

为什么选择它

其他所有 Instagram MCP 都封装了 Graph API：仅支持商业账号，不支持快拍、音乐和私信，而且只能访问 Meta 选择开放的内容。INSSIST 驱动你已登录的浏览器，因此 Claude Code、Codex、Cursor 或 Claude Desktop 可以读取个人资料和私信，发布和安排带音乐的帖子、Reels 和快拍，获取洞察数据和受众报告，以及下载媒体文件，无论你使用的是个人、创作者还是商业账号。

所有操作都不会经过云端代理，也不会保存 Instagram 凭据：服务会通过本地回环将每次工具调用交给扩展，扩展再通过浏览器返回结果。

Claude Code / Codex / Cursor / Claude Desktop
  │  stdio (MCP)
  ▼
@inssist/mcp
  │  ws://127.0.0.1:48231
  ▼
INSSIST Browser Extension
  │
  ▼
Instagram, in your own session

要求

• 安装了 INSSIST 并已打开 Instagram、登录账号的 Chrome（或其他 Chromium 浏览器）。
• Node.js 22 或更高版本（自带 npx）。
• 一个 MCP 客户端。任何能启动 stdio 服务的运行环境都可以。

安装

将服务注册到你的 Agent。它会自行下载并启动服务；无需手动运行任何内容。

Claude Code

claude mcp add inssist -- npx -y @inssist/mcp

Codex

codex mcp add inssist -- npx -y @inssist/mcp

Claude Desktop（包括 Cowork）：下载 inssist-mcp.mcpb 并双击即可。只需一步，使用 Claude 内置的 Node.js 运行，无需终端。

Cursor、Windsurf、Gemini CLI 和其他客户端：将以下内容添加到 MCP 配置中（Cursor： .cursor/mcp.json）：

{ "mcpServers": { "inssist": { "command": "npx", "args": ["-y", "@inssist/mcp"] } } }

连接浏览器

1. 在 Chrome 中打开 instagram.com，然后点击 INSSIST 菜单。
2. 点击 Connect to AI Agents，并开启开关。
3. 几秒钟内，面板就会显示 Connected。

配对会自动完成：开关即表示同意。扩展会连接服务，双方会保存令牌以便静默重连；关闭开关即可断开连接并停止所有重试。多个 Chrome 配置文件可以连接到同一服务；每个配置文件都会在 account_info 中显示为一个 instance。

同时运行多个 Agent 也没问题。每个运行环境都会启动自己的 @inssist/mcp 进程；第一个绑定端口的进程会成为中心节点，后续进程会作为对等节点加入并通过它中继，因此两个终端中的 Claude Code、Claude Desktop 和 Cursor 都能共享同一批浏览器。中心节点的运行环境关闭后，其中一个对等节点会接管端口，扩展随后会重新连接。

试用

Who am I logged in as, and how many followers do I have?
Show me the last 5 posts from @nasa with their like counts.
List my unread DMs and draft a reply to the first one. Don't send it yet.
Schedule /Users/me/reel.mp4 as a reel for tomorrow 9am with a caption about spring, and add a trending track.
Run an unfollowers scan and tell me who left this week.
Download the last 20 posts from @natgeo to my machine.

工具

共有 60 个工具，按扩展程序 工具与功能 面板中的分组方式排列。标记为 PRO 的工具需要订阅 INSSIST PRO；其他工具均可免费使用，除 INSSIST 自身的调用间隔限制外没有速率限制。未订阅时调用 PRO 工具不会失败，而是返回一条简短消息和升级链接，供 Agent 转达。

分组	工具
账户	account_info, account_switch
个人资料	profile_update, note_set
读取数据	ig_fetch_profile, ig_fetch_posts, ig_fetch_post, ig_fetch_stories, ig_fetch_saved, ig_search
互动	story_viewers, notifications_list, events_check, follow_requests_list, follower_remove, ig_block
评论	comments_list, comment_add, comment_reply, comment_like, comment_delete
私信	dm_list, dm_requests, dm_read, dm_send, dm_mark_seen, dm_accept, dm_remove
发布	draft_create, draft_schedule, draft_publish, draft_get, draft_preview, draft_update, draft_delete, draft_list, draft_reorder
发帖	ig_post_edit, ig_post_delete, location_search, music_search
洞察	insights_collect, insights_report
受众	unfollowers_scan / _report / _export, antibot_scan / _report / _export, peers_scan / _report / _export
下载	downloads_start, downloads_status, downloads_cancel

以下是一些值得了解的用法：

• draft_* 与 ig_post_*。 草稿保存在 INSSIST 自己的发布队列中（草稿可以是帖子、Reel、快拍或轮播帖；由 type 指定类型）。ig_post_edit / ig_post_delete 用于操作已发布到 Instagram 的帖子。
• 先启动，再轮询。 长时间运行的任务会在后台执行，并显示在 INSSIST 的界面中： insights_collect → insights_report、unfollowers_scan → unfollowers_report、 antibot_scan → antibot_report、peers_scan → peers_report、 downloads_start → downloads_status。
• *_export 会通过 Chrome 下载功能将完整列表写入 CSV，并返回文件路径，适用于列表过大、无法直接传入 Agent 上下文的情况。
• draft_create 的 Assets 可以是本地文件路径（由服务读取），也可以是 http(s) URL（由扩展程序下载）。每个文件最大 100 MB，每次调用总计最大 200 MB。
• instance（除 account_info 外的所有工具）：要使用的已连接浏览器配置文件。默认为当前活动配置文件。
• instant（会访问 Instagram 的工具）：INSSIST 会将 Agent 的调用按间隔几秒排入每个账户的队列，以免短时间内大量调用触发速率限制。instant: true 会跳过队列；Agent 仅应在你要求立即执行操作时使用。如果调用需要等待超过约 50 秒，系统会立即拒绝，并返回 busy: true 和 retryAfterMs。

浏览器连接前，服务会公布随程序包附带的工具列表快照，因此即使没有任何程序在运行，宿主程序也能列出工具。对该快照发起调用时，系统会返回连接步骤。扩展程序连接后，其实时工具列表将替换快照，客户端会收到 tools/list_changed 通知。

隐私

所有内容都在你的计算机上运行。服务绑定到 127.0.0.1，只接受来自 chrome-extension:// 来源的连接，并存储一个文件 ~/.inssist/mcp-pairings.json（模式 0600），其中保存其自身 ID 和每个浏览器配置文件各一个配对令牌。该扩展会向 INSSIST 发送其常规匿名使用事件，包括 Agent 调用的每个工具的名称，但绝不发送参数或结果。Instagram 流量由浏览器自行处理。请参阅 隐私政策。

配置

变量	默认值	含义
INSSIST_MCP_PORT	48231	扩展连接的本地回环端口（也要在扩展中更改）
INSSIST_MCP_HOME	~/.inssist	存放 mcp-pairings.json 的目录

也可使用 npx @inssist/mcp --version 和 --help。

故障排除

• “无法在 127.0.0.1:48231 上启动桥接。” 该端口已被其他程序占用 （如果是另一个 @inssist/mcp，它会加入，而不是拒绝连接）。使用 lsof -nP -i :48231 查找占用程序（macOS/Linux），或在此处和扩展中将 INSSIST_MCP_PORT 设置为一个空闲端口。
• 面板一直显示“正在等待…”。 服务尚未运行。请确保 MCP 客户端已启动该服务（大多数客户端会在首次调用工具或打开会话时延迟启动服务） 且没有其他程序响应此端口。关闭再打开开关即可立即重新连接。
• 工具返回“未连接 INSSIST 浏览器”。 开关已关闭、Instagram 未在该 Chrome 配置文件中打开，或扩展仍在连接。检查面板是否显示“已连接”。
• 协议版本消息。 扩展与服务使用的网络格式不一致。请更新消息中提到的部分：在 chrome://extensions → 更新扩展，使用 npx @inssist/mcp@latest 更新服务（或清除 npx 缓存），然后重启运行环境。
• PRO 工具返回升级消息。 未订阅时这是预期行为；Agent 会转发链接。

开发

npm install
npm run build               # compile (in the INSSIST monorepo this also refreshes the tool snapshot)
npm test                    # build + unit tests (node --test)
node scripts/smoke.mjs 60   # spawn the built server, list tools, call account_info

mcp-bridge-manifest.json 是工具快照，由扩展源代码生成，并在每次发布时提交到此处。请勿手动编辑。

安全与支持

请将漏洞报告发送至 [email protected]（请参阅 SECURITY.md）。支持与问题咨询：发送邮件至同一地址，或访问 inssist.com/support。 MIT。