SocialDataX Instagram MCP

com.52choujiangPublished by 52choujiang.comv0.1.7Updated Oct 24, 2026

Instagram tag/user/post search, details, comments/replies, users/posts, video/Reels speech-to-text.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & AnalyticsMedia & Design

Overview

AI-generated overview

Lets an assistant search and read public Instagram posts, users, tags and comments, and transcribe speech from videos.

What you can do
Exposes 15 tools over public Instagram content: keyword search for posts, users and tags; post details by post ID or post URL; paginated top-level comments and comment replies; user info and a user's public posts by username or profile URL. It can also submit speech-to-text jobs for regular videos and Reels and poll them by job ID, and check the account's points balance.
When to use it
Use it when an assistant needs public Instagram data: finding posts, accounts or tags by keyword, pulling post and user details, reading comments and replies, or transcribing speech from videos and Reels.
Requirements
A remote endpoint plus a SocialDataX Bearer API Key sent in the Authorization header. No local package or environment variables are needed.
Before you install
Requires a SocialDataX API Key, and some calls consume account points, so check the balance first. Speech-to-text jobs wait up to 240 seconds; if unfinished, poll with the returned job ID instead of resubmitting. Queries are processed by a third-party service.

Installation

In SourceWeft

  1. Open SocialDataX Instagram MCP in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.52choujiang%2Finstagram-insights/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

15

instagram_search_posts

按搜索词搜索 Instagram 公开帖子。用户需要按搜索词查找帖子时使用；已有帖子链接时使用帖子详情或评论工具；已有 post_id 时使用按 ID 详情工具，需要评论时复用详情结果中的 share_url；已有用户主页链接或 username 时使用用户信息或用户帖子工具；支持 page_token 翻页。

Parameterskeywordrequiredpage_token

instagram_search_users

按关键词搜索 Instagram 用户，返回公开账号资料及分页令牌。用于按名称发现账号；已知 username 或主页链接时，使用用户详情工具。未知昵称返回空字符串，未知头像或认证、私密状态返回 null。

Parameterskeywordrequiredpage_token

instagram_search_tags

按关键词搜索 Instagram 标签，返回标签 ID、名称及帖子数。用于发现标签，不返回标签下的帖子；当前仅支持首屏，不支持翻页。

Parameterskeywordrequired

instagram_get_post_detail_by_post_id

根据 Instagram 帖子 ID 获取公开帖子详情；已有完整 post_id 时直接使用。

Parameterspost_idrequired

instagram_get_post_detail_by_post_url

根据 Instagram 帖子链接获取公开帖子详情。

Parameterspost_urlrequired

instagram_get_post_comments_by_post_url

根据 Instagram 帖子链接分页获取公开帖子的一级评论；用户已提供帖子链接时直接使用。只有 post_id 时，先调用 instagram_get_post_detail_by_post_id，并复用详情结果中的 share_url；支持使用 page_token 继续翻页。

Parameterspost_urlrequiredpage_token

instagram_get_post_comment_replies_by_comment_id

根据 Instagram 帖子的 post_id 和一级评论 comment_id 分页获取评论回复；用户已提供合法 post_id 和一级评论 comment_id 时直接使用。缺少任一必需 ID 且已有 post_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；缺少帖子定位信息时向用户索取；支持使用 page_token 继续翻页。

Parameterspost_idrequiredcomment_idrequiredpage_token

instagram_get_user_info_by_username

根据 Instagram 用户名获取公开用户信息；用户已提供 username 时直接使用。

Parametersusernamerequired

instagram_get_user_info_by_profile_url

根据 Instagram 用户主页链接获取公开用户信息。

Parametersprofile_urlrequired

instagram_get_user_posts_by_username

根据 Instagram 用户名分页获取该用户发布的公开帖子列表；用户已提供 username 时直接使用。

Parametersusernamerequiredpage_token

instagram_get_user_posts_by_profile_url

根据 Instagram 用户主页链接分页获取该用户发布的公开帖子列表。

Parameterspage_tokenprofile_urlrequired

instagram_submit_video_speech_text_by_post_url

根据 Instagram 普通视频帖子或 Reels 链接提交口播转文字任务；图片帖和轮播帖不支持，提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

Parameterspost_urlrequired

instagram_submit_video_speech_text_by_post_id

根据 Instagram 普通视频帖子或 Reels 的 post_id 提交口播转文字任务；图片帖和轮播帖不支持，提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

Parameterspost_idrequired

instagram_get_video_speech_text_job

根据有效 job_id 查询 Instagram 口播转文字任务；用户已提供时直接使用，否则使用 submit 工具返回的 job_id；每次最多等待 240 秒，不触发重处理，也不要重复提交任务。

Parametersjob_idrequired

socialdatax_get_points_balance

查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

Takes no parameters.

Version history

3
  1. v0.1.7LatestOct 11, 2026
  2. v0.1.6Oct 8, 2026
  3. v0.1.5Sep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.