SocialDataX X / Twitter MCP

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

X/Twitter search, posts, comments, user profiles, user posts/replies and video transcripts.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingMedia & Design

Overview

AI-generated overview

Remote MCP server for reading public X/Twitter data: post search, post details and comments, user profiles, user posts and replies, and video transcripts.

What you can do
  • Search public X posts by keyword, with hot/latest sorting and page tokens, and get keyword suggestions for the search box
  • Search users by keyword and fetch profiles by user ID, username or profile URL
  • Read post details and first-level comments, plus replies to comments, by post ID or post URL
  • List a user's posts or the replies they wrote, with pagination
  • Submit a video post for speech-to-text transcription and poll the job until it finishes
  • Check the remaining points balance of the API key account
When to use it
Useful when an assistant needs to research public X/Twitter conversations, track what an account posts or replies, pull comments under a post, or transcribe speech from a video post, without building your own X API integration.
Requirements
A remote streamable HTTP endpoint; no local package or runtime. Requires a SocialDataX API key sent as a bearer token in the Authorization header. Usage is metered against a points balance, and network access to the endpoint is needed.
Before you install
The API key is a secret sent in the Authorization header; keep it out of logs and shared transcripts. Calls consume account points, and topping up happens on the provider's billing page. Video transcription jobs can take up to 240 seconds per wait and should not be resubmitted. All data comes from a third-party service that relays public X content.

Installation

In SourceWeft

  1. Open SocialDataX X / Twitter 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%2Fx-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-x-twitter": {
      "type": "http",
      "url": "https://mcp.socialdatax.com/x/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Tools

21

x_search_posts

按搜索词搜索 X / Twitter 公开帖子,只返回帖子结果。用户需要按搜索词查找帖子时使用;已有 post_id 或 post_url 时使用帖子详情或评论工具;已有 user_id、username 或 profile_url 时使用用户信息或用户帖子工具;支持 page_token 翻页和热门/最新排序。

Parameterskeywordrequiredsort_typepage_token

x_search_suggestions

获取 X / Twitter 搜索框的关键词联想,不返回帖子或推荐用户,不支持分页。可将返回的 text 用于帖子搜索;已有明确搜索词时可直接搜索帖子。

Parameterskeywordrequired

x_search_users

按关键词搜索 X / Twitter 用户,返回用户资料和分页令牌,支持 page_token 翻页。用于按名称发现账号;已知 user_id、username 或主页链接时,使用对应用户详情工具。

Parameterskeywordrequiredpage_token

x_get_post_detail_by_post_id

根据 X 帖子 ID 获取公开帖子详情;已知 post_id 时优先使用,不要传帖子链接。

Parameterspost_idrequired

x_get_post_detail_by_post_url

根据 X 帖子链接获取公开帖子详情;仅在没有 post_id、只有帖子链接或结果里的非空 post_url 时使用。

Parameterspost_urlrequired

x_get_post_comments_by_post_id

根据 X 帖子 ID 获取公开帖子的一级评论列表,不内嵌评论回复;已知 post_id 时优先使用,不要传帖子链接或评论 ID。

Parameterspost_idrequiredpage_token

x_get_post_comments_by_post_url

根据 X 帖子链接获取公开帖子的一级评论列表,不内嵌评论回复;仅在没有 post_id、只有帖子链接或结果里的非空 post_url 时使用。

Parameterspost_urlrequiredpage_token

x_get_post_comment_replies_by_comment_id

根据 X 帖子 ID 和一级评论 ID 获取公开评论回复列表;用户已提供完整合法的 ID 组合时直接使用;已有 post_id 或帖子链接但缺少必需 ID 时,调用对应一级评论工具补全;缺少帖子定位信息时向用户索取;不要传评论回复结果里的 comment_id 或评论链接。

Parameterspost_idrequiredcomment_idrequiredpage_token

x_get_user_info_by_user_id

根据 X 用户 ID 获取公开用户信息;已有完整 user_id 时直接使用。

Parametersuser_idrequired

x_get_user_info_by_username

根据 X 用户名获取公开用户信息;可使用用户搜索结果的非空 items[*].username,或帖子及评论结果的非空 author.username。

Parametersusernamerequired

x_get_user_info_by_profile_url

根据 X 用户主页链接获取公开用户信息;可使用用户搜索结果的非空 items[*].profile_url,或帖子及评论结果的非空 author.profile_url。不要传帖子链接。

Parametersprofile_urlrequired

x_get_user_replies_by_user_id

根据 X 用户 ID获取该博主发布的回复帖子,包括自回复,支持分页;查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时,使用对应评论工具。

Parametersuser_idrequiredpage_token

x_get_user_replies_by_username

根据 X 用户名获取该博主发布的回复帖子,包括自回复,支持分页;查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时,使用对应评论工具。

Parametersusernamerequiredpage_token

x_get_user_replies_by_profile_url

根据 X 用户主页链接获取该博主发布的回复帖子,包括自回复,支持分页;查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时,使用对应评论工具。

Parameterspage_tokenprofile_urlrequired

x_get_user_posts_by_user_id

根据 X 用户 ID 获取公开用户帖子列表;已有完整 user_id 时直接使用,支持 page_token 翻页。

Parametersuser_idrequiredpage_token

x_get_user_posts_by_username

根据 X 用户名获取公开用户帖子列表;可使用用户搜索结果的非空 items[*].username,或帖子及评论结果的非空 author.username。支持 page_token 翻页。

Parametersusernamerequiredpage_token

x_get_user_posts_by_profile_url

根据 X 用户主页链接获取公开用户帖子列表;可使用用户搜索结果的非空 items[*].profile_url,或帖子及评论结果的非空 author.profile_url。不要传帖子链接。支持 page_token 翻页。

Parameterspage_tokenprofile_urlrequired

x_submit_video_speech_text_by_post_url

根据 X / Twitter 视频帖子链接提交口播转文字任务;只处理当前帖子自身首个可用 MP4 视频,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。

Parameterspost_urlrequired

x_submit_video_speech_text_by_post_id

根据 X / Twitter 视频帖子的 post_id 提交口播转文字任务;只处理当前帖子自身首个可用 MP4 视频,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。

Parameterspost_idrequired

x_get_video_speech_text_job

根据用户提供的有效 job_id,或 submit 工具返回的 job_id 查询 X / Twitter 口播转文字任务;每次最多等待 240 秒,不触发重处理,也不要重复提交任务。

Parametersjob_idrequired

socialdatax_get_points_balance

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

Takes no parameters.

Version history

4
  1. v0.1.4LatestOct 16, 2026
  2. v0.1.3Oct 8, 2026
  3. v0.1.1Sep 20, 2026
  4. v0.1.0Sep 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.