Instagram MCP

此公共仓库提供由 SocialDataX 托管的 Instagram MCP 服务的公共连接文档和 MCP 元数据。

如果您正在寻找用于社交媒体研究流程的 Instagram MCP，本仓库包含：

• 公共 MCP 元数据和客户端配置示例

• 面向支持远程 MCP 的客户端的托管 streamable-http 端点

• 面向仅支持命令/stdio 的 MCP 客户端的 mcp-remote 回退示例

业务实现为私有托管。本仓库仅公开社交媒体内容情报工作流的公共连接面。

搜索别名

此 MCP 服务的常见搜索词：

• Instagram MCP

• Instagram 数据 MCP

• Instagram data MCP

• Instagram 帖子 MCP

• Instagram 评论 MCP

• Instagram 回复 MCP

• Instagram 用户信息 MCP

• Instagram 用户帖子 MCP

• Instagram Reels transcript MCP

• Instagram 口播转文字 MCP

• Instagram post MCP

• Instagram post research MCP

• Instagram comments MCP

• Instagram comment replies MCP

• Instagram user info MCP

• Instagram user posts MCP

Related MCP server: instagram-mcp

服务

• 托管 MCP 端点：https://mcp.socialdatax.com/instagram/mcp

• 托管传输协议：streamable-http

• 身份验证：Authorization: Bearer <SOCIALDATAX_API_KEY>

• 产品：SocialDataX / 社媒数据助手

• 网站和 API Key 获取：https://socialdatax.com/ai?from=github

• 注册表名称：com.52choujiang/instagram-insights

• 未来注册表名称：com.socialdatax/instagram-insights

• 当前公共能力版本：0.1.5

平台 MCP

直接从支持带身份验证的远程 MCP 的客户端使用托管的 streamable-http 端点。对于仅支持命令/stdio MCP 服务器的客户端，请使用 mcp-remote 作为本地兼容代理。

工作流范围

此 MCP 服务专为社交媒体内容情报工作流设计。它不提供账户登录、发帖、编辑、点赞、评论、关注、直播或其他账户操作。

支持的工作流包括：

• 查询当前 API Key 账户的 SocialDataX 积分余额。

• 按关键词搜索公开的 Instagram 帖子；使用返回的 next_page_token 作为 page_token 继续翻页。

• 当调用方已拥有 post_id 时读取帖子详情。

• 将 Instagram 帖子分享 URL 解析为结构化帖子详情。

• 从 Instagram 帖子分享 URL 获取分页的一级评论；当仅有 post_id 时，先调用 instagram_get_post_detail_by_post_id 并复用返回的 share_url。

• 通过 post_id 和一级 comment_id 获取一级评论下的分页回复；直接使用用户提供有效的 post_id 和一级 comment_id。如果缺少某个 ID 但有帖子 URL，则调用 instagram_get_post_comments_by_post_url，然后复用同一条评论中的 items[*].post_id 和 items[*].comment_id。如果仅有 post_id，先调用 instagram_get_post_detail_by_post_id 获取 share_url，再调用 instagram_get_post_comments_by_post_url 并复用目标一级评论的 ID。如果既没有帖子 URL 也没有 post_id，请向用户询问帖子 URL 或 ID。

• 通过 username 或个人主页 URL 获取公开的 Instagram 用户信息。

• 通过 username 或个人主页 URL 获取 Instagram 用户发布的公开帖子的分页列表。

• 提交并检查普通视频帖子和 Reels 的语音转文字转录任务；不支持照片和轮播帖子。

工具

快速开始

对于支持认证 streamable-http 的客户端，可直接使用托管端点：

{
  "mcpServers": {
    "socialdatax-instagram": {
      "type": "streamable_http",
      "url": "https://mcp.socialdatax.com/instagram/mcp",
      "headers": {
        "Authorization": "Bearer <SOCIALDATAX_API_KEY>"
      }
    }
  }
}

配置模板见 examples/streamable_http_config.json。使用前请将 <SOCIALDATAX_API_KEY> 替换为你的 API Key。

对于仅支持命令/stdio 的 MCP 客户端，请使用 mcp-remote：

{
  "mcpServers": {
    "socialdatax-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.socialdatax.com/instagram/mcp",
        "--header",
        "Authorization: Bearer <SOCIALDATAX_API_KEY>"
      ]
    }
  }
}

Claude Code 可以直接使用远程 HTTP：

claude mcp add --transport http socialdatax-instagram https://mcp.socialdatax.com/instagram/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}'

在重启 Claude Code 之前，请将 SOCIALDATAX_API_KEY 持久化到运行时环境或客户端 Secret 中。

Claude Desktop 在可用时应使用其远程 MCP / Connectors 界面。如果你的版本中的本地配置文件仅支持命令/stdio 服务器，请使用 mcp-remote 作为后备方案。

客户端示例

配置示例见 examples：

• Command/stdio 回退配置

• Claude Desktop 回退配置

• Cursor 远程 HTTP 配置

• Codex 远程 HTTP 配置

• 直接流式 HTTP 配置

API 密钥

请从产品官网申请或管理 API 访问权限：

https://socialdatax.com/ai?from=github

在 Authorization 请求头中使用该密钥作为 Bearer 令牌。切勿将真实的 API 密钥值提交到代码、文档、问题或截图中。

目录元数据

本仓库中的公共元数据文件：

• server-card.json：托管服务的目录导向元数据。官方 MCP Registry 发布使用私有源仓库中的 registry/instagram/server.json 作为当前 com.52choujiang/instagram-insights 条目。

• mcp.json：使用 mcp-remote 的通用 command/stdio 回退配置。

• glama.json：Glama 仓库所有权元数据。

• SUBMISSION_CHECKLIST.md：MCP 目录提交检查清单。

许可证

本公共仓库中的文件根据 MIT 许可证发布。该许可证仅涵盖本仓库中的公共文档和配置示例。它不涵盖托管服务实现、托管基础设施或本仓库之外的任何私有后端代码。