SocialDataX 微博 Weibo MCP MCP Server

微博 MCP | Weibo MCP

LobeHub 用户请使用 LobeHub setup / 接入说明，包含专属官网入口、认证和来源配置。

This public repository provides public connection docs and MCP metadata for a hosted 微博 MCP / Weibo MCP service by SocialDataX.

If you are looking for a Weibo MCP or 微博 MCP for social media research workflows, this repository includes:

• public MCP metadata and client configuration examples
• the hosted streamable-http endpoint for clients that support remote MCP
• an mcp-remote fallback example for command/stdio-only MCP clients

The business implementation is privately hosted. This repository exposes only the public connection surface for social media content intelligence workflows.

Recorded release status

• Local metadata: 0.1.5 with 22 tracked tools. Local metadata alone does not establish publication.
• Hosted production: 0.1.5 with 22 tools; recorded verification on 2026-10-16 18:07 (Asia/Shanghai).
• Official MCP Registry: 0.1.5 (active); recorded verification on 2026-10-16 18:07 (Asia/Shanghai).
• Registry evidence: version-specific Registry record.
• These are recorded observations, not a fresh live check. Public GitHub, npm, and other distribution channels require their own verification.

Search Aliases

Common search phrases for this MCP service:

• 微博 MCP
• 微博 数据 MCP
• 微博 热搜 MCP
• 微博 帖子 MCP
• 微博 评论 MCP
• 微博 用户 MCP
• Weibo MCP
• Weibo data MCP
• Weibo hot search MCP
• Weibo post research MCP
• Weibo comments MCP
• Weibo user MCP

Service

• Hosted MCP endpoint: https://mcp.socialdatax.com/weibo/mcp
• Hosted transport: streamable-http
• Authentication: Authorization: Bearer <SOCIALDATAX_API_KEY>
• Product: SocialDataX / 社媒数据助手
• Website and API Key access: https://socialdatax.com/ai?from=github
• Registry name: com.52choujiang/weibo-insights
• Future registry name: com.socialdatax/weibo-insights

Platform MCP

Use the hosted streamable-http endpoint directly from clients that support authenticated remote MCP. For clients that only support command/stdio MCP servers, use mcp-remote as a local compatibility proxy.

Workflow Scope

This MCP service is designed for social media content intelligence workflows. It does not provide account login, posting, editing, liking, commenting, reposting, or other account actions.

Supported workflows include:

• Query the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数.
• Search users with weibo_search_users(keyword, page_token); reuse user_id or profile_url for profile details and posts. Follower counts may be approximate; verification_label contains certification text.
• Get keyword search suggestions with weibo_search_suggestions(keyword); use each text in post search. No pagination.
• Get search-box user suggestions with weibo_search_user_suggestions(keyword). Returns a few candidate accounts with IDs, names, avatars, profile links, bios, follower counts, verification details, locations and a required boolean is_live; no pagination or guarantee of finding a particular account. is_live is true while the account is broadcasting and false when it is not, including a scheduled broadcast that has not started. Missing or unrecognized upstream status produces an error.
• Read the Weibo / 微博 hot search list.
• Search Weibo posts by keyword or phrase with optional page_token continuation; pass only a search term to keyword, not a URL or ID.
• Resolve a Weibo post page link, short link, or share text into structured post details.
• Read post details when the caller already has a post_id.
• Fetch paginated first-level comments for comment analysis.
• Fetch paginated replies under a first-level comment.
• Fetch paginated liker and repost lists for a post.
• Read user profile data from a user profile link or user_id.
• Fetch user post lists from a user profile link or user_id.
• Submit a post video speech-to-text transcript task; the submit call may wait up to 240 seconds, and unfinished jobs should continue polling the same job_id until terminal.

Tools

Quick Start

For clients that support authenticated streamable-http, use the hosted endpoint directly:

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

A ready-to-copy example is available in examples/streamable_http_config.json.

For command/stdio-only MCP clients, use mcp-remote:

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

Claude Code can use remote HTTP directly:

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

Persist SOCIALDATAX_API_KEY in the runtime environment or client Secret before restarting Claude Code.

Claude Desktop should use its remote MCP / Connectors UI when available. If a local configuration file in your version only supports command/stdio servers, use the mcp-remote fallback.

Client Examples

Configuration examples are available in examples:

• Command/stdio fallback config
• Claude Desktop fallback config
• Cursor remote HTTP config
• Codex remote HTTP config
• Direct streamable HTTP config

API Key

Request or manage API access from the product website:

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

Use the key as a Bearer token in the Authorization request header. Do not commit real API Key values to code, docs, issues, or screenshots.

Directory Metadata

Public metadata files in this repository:

• server-card.json: directory-oriented metadata for the hosted service. Official MCP Registry publishing uses the private source repo's registry/weibo/server.json for the current com.52choujiang/weibo-insights entry.
• mcp.json: generic command/stdio fallback config using mcp-remote.
• glama.json: Glama repository ownership metadata.
• SUBMISSION_CHECKLIST.md: checklist for MCP directory submissions.

License

The files in this public repository are released under the MIT License. The license covers the public documentation and configuration examples in this repository only. It does not cover the managed service implementation, hosted infrastructure, or any private backend code outside this repository.

Gemini CLI extension

Install this service from its public GitHub repository:

gemini extensions install https://github.com/DevinChen2014/weibo-mcp

When prompted, enter your own SOCIALDATAX_API_KEY. Get a key from SocialDataX; business tool calls consume SocialDataX credits. The extension connects directly to the existing hosted MCP endpoint and does not include the private service implementation.

Verify the connection with gemini mcp list. To change the saved key, run:

gemini extensions config socialdatax-weibo