Skip to content

SocialDataX Instagram MCP

by 52choujiang.com · remote · no sign-in to list tools · v0.1.7 · published by com.52choujiang

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

Changes · 2

15 tools: 2 change things and 13 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http instagram-insights https://mcp.socialdatax.com/instagram/mcp --header 'Authorization: <your-authorization>'

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

15 tools

Changes things 2Claude Code: ask
  • instagram_submit_video_speech_text_by_post_id根据 Instagram 普通视频帖子或 Reels 的 post_id 提交口播转文字任务;图片帖和轮播帖不支持,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。No findings

    Why it is in this group

    • The name "instagram_submit_video_speech_text_by_post_id" says "submit": a word for a change.
    Description, as the server wrote it
    根据 Instagram 普通视频帖子或 Reels 的 post_id 提交口播转文字任务;图片帖和轮播帖不支持,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
  • instagram_submit_video_speech_text_by_post_url根据 Instagram 普通视频帖子或 Reels 链接提交口播转文字任务;图片帖和轮播帖不支持,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。No findings

    Why it is in this group

    • The name "instagram_submit_video_speech_text_by_post_url" says "submit": a word for a change.
    Description, as the server wrote it
    根据 Instagram 普通视频帖子或 Reels 链接提交口播转文字任务;图片帖和轮播帖不支持,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
Only reads 13Claude Code: allow
  • 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[*].p…No findings

    Why it is in this group

    • The name "instagram_get_post_comment_replies_by_comment_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 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 继续翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_get_post_comments_by_post_url根据 Instagram 帖子链接分页获取公开帖子的一级评论;用户已提供帖子链接时直接使用。只有 post_id 时,先调用 instagram_get_post_detail_by_post_id,并复用详情结果中的 share_url;支持使用 page_token 继续翻页。No findings

    Why it is in this group

    • The name "instagram_get_post_comments_by_post_url" says "get": a word for reading.
    Description, as the server wrote it
    根据 Instagram 帖子链接分页获取公开帖子的一级评论;用户已提供帖子链接时直接使用。只有 post_id 时,先调用 instagram_get_post_detail_by_post_id,并复用详情结果中的 share_url;支持使用 page_token 继续翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_get_post_detail_by_post_id根据 Instagram 帖子 ID 获取公开帖子详情;已有完整 post_id 时直接使用。No findings

    Why it is in this group

    • The name "instagram_get_post_detail_by_post_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 Instagram 帖子 ID 获取公开帖子详情;已有完整 post_id 时直接使用。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_get_post_detail_by_post_url根据 Instagram 帖子链接获取公开帖子详情。No findings

    Why it is in this group

    • The name "instagram_get_post_detail_by_post_url" says "get": a word for reading.
    Description, as the server wrote it
    根据 Instagram 帖子链接获取公开帖子详情。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_get_user_info_by_profile_url根据 Instagram 用户主页链接获取公开用户信息。No findings

    Why it is in this group

    • The name "instagram_get_user_info_by_profile_url" says "get": a word for reading.
    Description, as the server wrote it
    根据 Instagram 用户主页链接获取公开用户信息。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_get_user_info_by_username根据 Instagram 用户名获取公开用户信息;用户已提供 username 时直接使用。No findings

    Why it is in this group

    • The name "instagram_get_user_info_by_username" says "get": a word for reading.
    Description, as the server wrote it
    根据 Instagram 用户名获取公开用户信息;用户已提供 username 时直接使用。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_get_user_posts_by_profile_url根据 Instagram 用户主页链接分页获取该用户发布的公开帖子列表。No findings

    Why it is in this group

    • The name "instagram_get_user_posts_by_profile_url" says "get": a word for reading.
    Description, as the server wrote it
    根据 Instagram 用户主页链接分页获取该用户发布的公开帖子列表。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_get_user_posts_by_username根据 Instagram 用户名分页获取该用户发布的公开帖子列表;用户已提供 username 时直接使用。No findings

    Why it is in this group

    • The name "instagram_get_user_posts_by_username" says "get": a word for reading.
    Description, as the server wrote it
    根据 Instagram 用户名分页获取该用户发布的公开帖子列表;用户已提供 username 时直接使用。

    Annotations the server declares

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

    Why it is in this group

    • The name "instagram_get_video_speech_text_job" says "get": a word for reading.
    Description, as the server wrote it
    根据有效 job_id 查询 Instagram 口播转文字任务;用户已提供时直接使用,否则使用 submit 工具返回的 job_id;每次最多等待 240 秒,不触发重处理,也不要重复提交任务。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_search_posts按搜索词搜索 Instagram 公开帖子。用户需要按搜索词查找帖子时使用;已有帖子链接时使用帖子详情或评论工具;已有 post_id 时使用按 ID 详情工具,需要评论时复用详情结果中的 share_url;已有用户主页链接或 username 时使用用户信息或用户帖子工具;支持 page_token 翻页。No findings

    Why it is in this group

    • The name "instagram_search_posts" says "search": a word for reading.
    Description, as the server wrote it
    按搜索词搜索 Instagram 公开帖子。用户需要按搜索词查找帖子时使用;已有帖子链接时使用帖子详情或评论工具;已有 post_id 时使用按 ID 详情工具,需要评论时复用详情结果中的 share_url;已有用户主页链接或 username 时使用用户信息或用户帖子工具;支持 page_token 翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • instagram_search_tags按关键词搜索 Instagram 标签,返回标签 ID、名称及帖子数。用于发现标签,不返回标签下的帖子;当前仅支持首屏,不支持翻页。No findings

    Why it is in this group

    • The name "instagram_search_tags" says "search": a word for reading.
    Description, as the server wrote it
    按关键词搜索 Instagram 标签,返回标签 ID、名称及帖子数。用于发现标签,不返回标签下的帖子;当前仅支持首屏,不支持翻页。

    Annotations the server declares

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

    Why it is in this group

    • The name "instagram_search_users" says "search": a word for reading.
    Description, as the server wrote it
    按关键词搜索 Instagram 用户,返回公开账号资料及分页令牌。用于按名称发现账号;已知 username 或主页链接时,使用用户详情工具。未知昵称返回空字符串,未知头像或认证、私密状态返回 null。

    Annotations the server declares

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

    Why it is in this group

    • The name "socialdatax_get_points_balance" says "get": a word for reading.
    Description, as the server wrote it
    查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.7. Values in angle brackets are yours to fill in.

claude mcp add --transport http instagram-insights https://mcp.socialdatax.com/instagram/mcp --header 'Authorization: <your-authorization>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__instagram-insights__instagram_search_posts",
      "mcp__instagram-insights__instagram_search_users",
      "mcp__instagram-insights__instagram_search_tags",
      "mcp__instagram-insights__instagram_get_post_detail_by_post_id",
      "mcp__instagram-insights__instagram_get_post_detail_by_post_url",
      "mcp__instagram-insights__instagram_get_post_comments_by_post_url",
      "mcp__instagram-insights__instagram_get_post_comment_replies_by_comment_id",
      "mcp__instagram-insights__instagram_get_user_info_by_username",
      "mcp__instagram-insights__instagram_get_user_info_by_profile_url",
      "mcp__instagram-insights__instagram_get_user_posts_by_username",
      "mcp__instagram-insights__instagram_get_user_posts_by_profile_url",
      "mcp__instagram-insights__instagram_get_video_speech_text_job",
      "mcp__instagram-insights__socialdatax_get_points_balance"
    ],
    "ask": [
      "mcp__instagram-insights__instagram_submit_video_speech_text_by_post_url",
      "mcp__instagram-insights__instagram_submit_video_speech_text_by_post_id"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as instagram-insights. Review it before you use it.