Weibo MCP server
Commit Oct 20, 2026Enables AI clients to perform social media research on Weibo by searching posts, users, hot searches, comments, and retrieving video transcripts.
Also known as DevinChen2014/weibo-mcp
- Stars
- 1
- Tools
- 22
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 20, 2026
- License
- MIT
What is Weibo MCP?
Weibo enables AI clients to perform social media research on Weibo by searching posts, users, hot searches, comments, and retrieving video transcripts. It exposes 22 tools, such as socialdatax_get_points_balance, weibo_get_hot_search_list, weibo_search_suggestions.
Summary generated from the project's README
About Weibo MCP server
This service provides social media content intelligence for researchers and developers focusing on Weibo. It allows AI clients to perform deep analysis of social media data without requiring account actions like posting, liking, or commenting. Users can access structured information through a hosted streamable-http endpoint or use mcp-remote as a local proxy for clients that only support command/stdio connections.
To use the service, you must provide a SocialDataX API key as a Bearer token in your authorization header. The toolset includes 22 specialized functions for retrieving data, such as searching for users, reading hot search lists, and fetching post details. It also supports advanced tasks like submitting video speech-to-text transcript jobs, which can be monitored via a job ID. This is a read-only intelligence tool designed for data retrieval and analysis rather than social interaction.
What you can do with it
- 1Analyze trending topicsA developer can request the current list of trending topics on Weibo to monitor real-time discussions.
- 2Perform user researchYou can search for specific accounts and retrieve their profile details, follower counts, and verification status.
- 3Extract video contentAn AI client can convert the speech from a Weibo video into a text transcript for easier processing.
- 4Monitor post engagementYou can fetch lists of users who liked or reposted a specific post to understand audience interaction.
Written from the project's README. Every use case is checked against a quote from it.
Weibo MCP tools 22
Detected from the READMEsocialdatax_get_points_balanceweibo_get_hot_search_listweibo_search_suggestionsweibo_search_user_suggestionsweibo_search_usersweibo_search_postsweibo_get_post_detail_by_post_idweibo_get_post_detail_by_post_urlweibo_get_post_comments_by_post_idweibo_get_post_comments_by_post_urlweibo_get_post_comment_replies_by_comment_idweibo_get_post_liker_list_by_post_id
Show all 22 toolsShow fewer tools
weibo_get_post_liker_list_by_post_urlweibo_get_post_repost_list_by_post_idweibo_get_post_repost_list_by_post_urlweibo_get_user_info_by_user_idweibo_get_user_info_by_profile_urlweibo_get_user_posts_by_user_idweibo_get_user_posts_by_profile_urlweibo_submit_video_speech_text_by_post_urlweibo_submit_video_speech_text_by_post_idweibo_get_video_speech_text_job
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabledevinchen2014/weibo-mcp is public and reachablegithub.com/devinchen2014/weibo-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-20github.com/devinchen2014/weibo-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model22 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub微博 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-httpendpoint for clients that support remote MCP - an
mcp-remotefallback 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.5with 22 tracked tools. Local metadata alone does not establish publication. - Hosted production:
0.1.5with 22 tools; recorded verification on2026-10-16 18:07(Asia/Shanghai). - Official MCP Registry:
0.1.5(active); recorded verification on2026-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微博 用户 MCPWeibo MCPWeibo data MCPWeibo hot search MCPWeibo post research MCPWeibo comments MCPWeibo 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); reuseuser_idorprofile_urlfor profile details and posts. Follower counts may be approximate;verification_labelcontains certification text. - Get keyword search suggestions with
weibo_search_suggestions(keyword); use eachtextin 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 booleanis_live; no pagination or guarantee of finding a particular account.is_liveis 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_tokencontinuation; pass only a search term tokeyword, 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_iduntil terminal.
Tools
| Tool | Public purpose |
|---|---|
socialdatax_get_points_balance |
Query the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数. |
weibo_get_hot_search_list |
Get the current Weibo / 微博 hot search list. |
weibo_search_suggestions |
Get keyword search suggestions. Returns suggested text, not posts or user details; no pagination. |
weibo_search_user_suggestions |
Get a few search-box user suggestions with profile details and a boolean is_live. No pagination; use user search for paginated results or user details for a known ID or profile URL. |
weibo_search_users |
Search users by keyword with page_token continuation. When a user ID or profile URL is already available, use the corresponding user profile tool. |
weibo_search_posts |
Search Weibo posts by keyword or phrase. Use this tool when the user needs posts found by a search term; when a post URL or post_id is already available, use the corresponding post tool; when a user profile URL or user_id is available, use the corresponding user tool. Supports page_token continuation. |
weibo_get_post_detail_by_post_id |
Fetch structured post details when the caller already has a post_id. |
weibo_get_post_detail_by_post_url |
Resolve a Weibo post page link, short link, or share text into structured post details. |
weibo_get_post_comments_by_post_id |
Fetch paginated first-level comments when the caller already has a post_id. |
weibo_get_post_comments_by_post_url |
Fetch paginated first-level comments directly from a Weibo post page link, short link, or share text. |
weibo_get_post_comment_replies_by_comment_id |
Fetch paginated replies under a first-level comment by post_id and comment_id. |
weibo_get_post_liker_list_by_post_id |
Fetch paginated users who liked a Weibo post by post_id. |
weibo_get_post_liker_list_by_post_url |
Fetch paginated users who liked a Weibo post from a post page link, short link, or share text. |
weibo_get_post_repost_list_by_post_id |
Fetch paginated reposts for a Weibo post by post_id. |
weibo_get_post_repost_list_by_post_url |
Fetch paginated reposts for a Weibo post from a post page link, short link, or share text. |
weibo_get_user_info_by_user_id |
Fetch user profile data when the caller already has a user_id. |
weibo_get_user_info_by_profile_url |
Resolve a Weibo user profile link into user profile data. |
weibo_get_user_posts_by_user_id |
Fetch a paginated list of posts published by a user when the caller already has a user_id. |
weibo_get_user_posts_by_profile_url |
Fetch a paginated list of posts published by a user from a Weibo user profile link. |
weibo_submit_video_speech_text_by_post_url |
Submit a post video speech-to-text transcript task from a post page link, short link, or share text. The submit call may wait up to 240 seconds; if unfinished, continue polling the same job_id until terminal. |
weibo_submit_video_speech_text_by_post_id |
Submit a post video speech-to-text transcript task from a post_id. The submit call may wait up to 240 seconds; if unfinished, continue polling the same job_id until terminal. |
weibo_get_video_speech_text_job |
Continue checking a post video speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned by a submit tool, without creating a new task; each call waits up to 240 seconds. If unfinished, continue querying the same job_id until terminal. This v1 surface returns transcript plus content context, not summary. |
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.jsonfor the currentcom.52choujiang/weibo-insightsentry. - 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
Weibo MCP questions
What tools does Weibo MCP provide?
It exposes 22 tools, including socialdatax_get_points_balance, weibo_get_hot_search_list, weibo_search_suggestions, weibo_search_user_suggestions, weibo_search_users.
Can I use this MCP to post or like content on Weibo?
No, this service is strictly for content intelligence and research. It does not provide account actions like posting, editing, liking, or commenting.
How do I authenticate with the Weibo MCP service?
You must use a SocialDataX API key provided as a Bearer token in the Authorization request header.
Does the service support video content?
Yes, you can submit tasks to generate speech-to-text transcripts for Weibo post videos.