Weibo MCP Server 🚀
基于 Model Context Protocol 的微博数据 API 服务器 - 实时获取微博用户资料、帖子、热搜话题、粉丝/关注数据。支持用户搜索、内容分析和话题发现，适用于 AI 应用。
安装
自动 Cookie 获取： 无需手动配置 Cookie，程序会自动通过微博访客通行证生成有效的访问凭证。
方式一：从包管理器安装（推荐）
# 安装
uvx install mcp-server-weibo
# 以 stdio 模式运行
mcp-server-weibo stdio
# 以 http 模式运行
mcp-server-weibo httpMCP 客户端配置（stdio 模式）：
{
"mcpServers": {
"weibo": {
"command": "uvx",
"args": ["mcp-server-weibo"]
}
}
}方式二：从 Docker 运行
# 构建镜像
docker build -t mcp-server-weibo .
# 运行容器
docker run -p 4200:4200 mcp-server-weibo httpMCP 客户端配置（HTTP 模式）：
{
"mcpServers": {
"weibo": {
"url": "http://localhost:4200/sse"
}
}
}方式三：从源代码安装
# 克隆并安装
git clone https://github.com/qinyuanpei/mcp-server-weibo.git
cd mcp-server-weibo
uv pip install -e .
# 运行
mcp-server-weibo stdio # 或 http命令行工具 (CLI)
除了 MCP 服务器，还提供了独立的命令行工具可直接访问：
# 使用 uvx 运行 (推荐)
uvx --from mcp-server-weibo weibo-cli --help
# 安装后运行
pip install mcp-server-weibo
weibo-cli --help
# 获取用户资料
uvx --from mcp-server-weibo weibo-cli profile 1749127163
# 获取用户动态
uvx --from mcp-server-weibo weibo-cli feeds 1749127163 -n 10
# 搜索内容
uvx --from mcp-server-weibo weibo-cli search "关键词"
# 搜索用户
uvx --from mcp-server-weibo weibo-cli users "关键词"
# 搜索话题
uvx --from mcp-server-weibo weibo-cli topics "关键词"
# 获取热搜榜单
uvx --from mcp-server-weibo weibo-cli trending -n 10
# 获取评论
uvx --from mcp-server-weibo weibo-cli comments 5173507416919189
# 获取粉丝
uvx --from mcp-server-weibo weibo-cli followers 1749127163 -n 10
# 获取关注
uvx --from mcp-server-weibo weibo-cli fans 1749127163 -n 10CLI 命令列表
| 命令 | 说明 |
|---|---|
weibo-cli profile | 根据 UID 获取用户资料 |
weibo-cli feeds [-n N] | 获取用户动态 |
weibo-cli search [-n N] [-p P] | 按关键词搜索帖子 |
weibo-cli users [-n N] [-p P] | 按关键词搜索用户 |
weibo-cli topics [-n N] [-p P] | 按关键词搜索话题 |
weibo-cli trending [-n N] | 获取热搜榜单 |
weibo-cli comments [-p P] | 获取帖子评论 |
weibo-cli followers [-n N] [-p P] | 获取用户粉丝 |
weibo-cli fans [-n N] [-p P] | 获取用户关注 |
组件
工具
search_users(keyword, limit)
描述：搜索微博用户
返回示例：
[
{
"id": 1749127163,
"screen_name": "雷军",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/1749127163?",
"description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
"follow_count": 1562,
"followers_count": "2671.2万",
"avatar_hd": "",
"verified": true,
"verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
"gender": "m"
}
]get_profile(uid)
描述：获取用户详细信息
返回示例：
{
"id": 1749127163,
"screen_name": "雷军",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/1749127163?",
"description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
"follow_count": 1562,
"followers_count": "2671.2万",
"avatar_hd": "",
"verified": true,
"verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
"gender": "m"
}get_feeds(uid, limit)
描述：获取用户帖子
返回示例：
[
{
"id": 5167970394572058,
"text": "今年是小米创业15周年。
早在11年前，2014年，我们就开始芯片研发之旅。
2014年9月，澎湃项目立项。2017年，小米首款手机芯片"澎湃S1"正式亮相，定位中高端。后来，因为种种原因，遭遇挫折，我们暂停了SoC大芯片的研发。但我们还是保留了芯片研发的火种，转向了"小芯片"路线。再后来，小米澎湃各 ...全文",
"source": "Xiaomi 15S Pro",
"created_at": "Mon May 19 11:00:21 +0800 2025",
"user": {
"id": 1749127163,
"screen_name": "雷军",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/1749127163?",
"description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
"follow_count": 1562,
"followers_count": "2671.2万",
"avatar_hd": "",
"verified": true,
"verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
"gender": "m"
},
"comments_count": 10183,
"attitudes_count": 141025,
"reposts_count": 5884,
"raw_text": "",
"region_name": "发布于 北京",
"pics": [
{
"thumbnail": "",
"large": ""
}
],
"videos": {}
}
]get_trendings(limit)
描述：获取微博热搜话题
返回示例：
[
{
"id": 0,
"trending": 0,
"description": "跟着总书记探寻中华文明",
"url": "https://m.weibo.cn/search?containerid=100103type%3D1%26t%3D10%26q%3D%23%E8%B7%9F%E7%9D%80%E6%80%BB%E4%B9%A6%E8%AE%B0%E6%8E%A2%E5%AF%BB%E4%B8%AD%E5%8D%8E%E6%96%87%E6%98%8E%23&stream_entry_id=51&isnewpage=1&extparam=seat%3D1%26stream_entry_id%3D51%26c_type%3D51%26filter_type%3Drealtimehot%26pos%3D0%26cate%3D10103%26dgr%3D0%26q%3D%2523%25E8%25B7%259F%25E7%259D%2580%25E6%2580%25BB%25E4%25B9%25A6%25E8%25AE%25B0%25E6%258E%25A2%25E5%25AF%25BB%25E4%25B8%25AD%25E5%258D%258E%25E6%2596%2587%25E6%2598%258E%2523%26display_time%3D1749098276%26pre_seqid%3D17490982767230055147"
},
{
"id": 3,
"trending": 591855,
"description": "建议大家要远离恋爱式友情",
"url": "https://m.weibo.cn/search?containerid=100103type%3D1%26t%3D10%26q%3D%E5%BB%BA%E8%AE%AE%E5%A4%A7%E5%AE%B6%E8%A6%81%E8%BF%9C%E7%A6%BB%E6%81%8B%E7%88%B1%E5%BC%8F%E5%8F%8B%E6%83%85&stream_entry_id=31&isnewpage=1&extparam=seat%3D1%26dgr%3D0%26c_type%3D31%26cate%3D5001%26realpos%3D12%26stream_entry_id%3D31%26lcate%3D5001%26q%3D%25E5%25BB%25BA%25E8%25AE%25AE%25E5%25A4%25A7%25E5%25AE%25B6%25E8%25A6%2581%25E8%25BF%259C%25E7%25A6%25BB%25E6%2581%258B%25E7%2588%B1%25E5%25BC%258F%25E5%258F%258B%25E6%2583%2585%26pos%3D11%26band_rank%3D12%26flag%3D1%26filter_type%3Drealtimehot%26display_time%3D1749098276%26pre_seqid%3D17490982767230055147"
},
{
"id": 13,
"trending": 584808,
"description": "李昀锐的清爽感是夏日刚需",
"url": "https://m.weibo.cn/search?containerid=100103type%3D1%26t%3D10%26q%3D%23%E6%9D%8E%E6%98%80%E9%94%90%E7%9A%84%E6%B8%85%E7%88%BD%E6%84%9F%E6%98%AF%E5%A4%8F%E6%97%A5%E5%88%9A%E9%9C%80%23&stream_entry_id=31&isnewpage=1&extparam=seat%3D1%26dgr%3D0%26c_type%3D31%26cate%3D5001%26realpos%3D13%26stream_entry_id%3D31%26lcate%3D5001%26q%3D%2523%25E6%259D%258E%25E6%2598%2580%25E9%2594%2590%25E7%259A%2584%25E6%25B8%2585%25E7%2588%25BD%25E6%2584%259F%25E6%2598%25AF%25E5%25A4%258F%25E6%2597%25A5%25E5%2588%259A%25E9%259C%2580%2523%26pos%3D12%26band_rank%3D13%26flag%3D1%26filter_type%3Drealtimehot%26display_time%3D1749098276%26pre_seqid%3D17490982767230055147"
},
{
"id": 14,
"trending": 573889,
"description": "陈思诚张小斐首度合作",
"url": "https://m.weibo.cn/search?containerid=100103type%3D1%26t%3D10%26q%3D%E9%99%88%E6%80%9D%E8%AF%9A%E5%BC%A0%E5%B0%8F%E6%96%90%E9%A6%96%E5%BA%A6%E5%90%88%E4%BD%9C&stream_entry_id=31&isnewpage=1&extparam=seat%3D1%26dgr%3D0%26c_type%3D31%26cate%3D5001%26realpos%3D14%26stream_entry_id%3D31%26lcate%3D5001%26q%3D%25E9%2599%2588%25E6%2580%259D%25E8%25AF%259A%25E5%25BC%25A0%25E5%25B0%258F%25E6%2596%2590%25E9%25A6%2596%25E5%25BA%25A6%25E5%2590%2588%25E4%25BD%259C%26pos%3D13%26band_rank%3D14%26flag%3D1%26filter_type%3Drealtimehot%26display_time%3D1749098276%26pre_seqid%3D17490982767230055147"
}
]search_content(keyword, limit, page)
描述：搜索微博帖子
返回示例：
[
{
"id": 5173507416919189,
"text": "#吉利银河#
省流：
1.推荐度系列分为四个等级，一般/可买/推荐/非常推荐。「一般/可买」车型减少展开，想看的人比较多的话，我们会给大家再出详细的视频
2.本期非常推荐的有吉利星愿、星耀8 ，推荐有熊猫mini、星舰7、银河E5
3.大家还有什么想看的品牌的年中横评也可以在评论下留言 ...全文",
"source": "微博视频号",
"created_at": "Tue Jun 03 17:42:30 +0800 2025",
"user": {
"id": 2098256142,
"screen_name": "农民新八",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/2098256142?",
"description": "新八，26岁。喜机械，喜机车，喜汽车，喜摄影。",
"follow_count": 429,
"followers_count": "19.9万",
"avatar_hd": "",
"verified": true,
"verified_reason": "微博原创视频博主",
"gender": "m"
},
"comments_count": 14,
"attitudes_count": 33,
"reposts_count": 2,
"raw_text": "",
"region_name": "浙江",
"pics": [],
"videos": {
"stream_url": "https://f.video.weibocdn.com/o0/Znlc5yrLlx08oKQqLjm8010412027DBU0E010.mp4?label=mp4_ld&template=640x360.25.0&ori=0&ps=1BVp4ysnknHVZu&Expires=1749102785&ssig=usxCRRQp1I&KID=unistore,video",
"stream_url_hd": "https://f.video.weibocdn.com/o0/WTxFgJ3rlx08oKQqpRpC01041203hVWU0E020.mp4?label=mp4_hd&template=852x480.25.0&ori=0&ps=1BVp4ysnknHVZu&Expires=1749102785&ssig=qTWtMQ8ugG&KID=unistore,video"
}
}
]search_topics(keyword, limit, page)
描述：搜索微博话题
返回示例：
[
{
"title": "#许嵩#",
"desc1": "",
"desc2": "1913.8万讨论 26.8亿阅读",
"url": "https://m.weibo.cn/search?containerid=231522type%3D1%26t%3D10%26q%3D%23%E8%AE%B8%E5%B5%A9%23&isnewpage=1"
},
{
"title": "#许嵩呼吸之野演唱会#",
"desc1": "",
"desc2": "1738.4万讨论 6.9亿阅读",
"url": "https://m.weibo.cn/search?containerid=231522type%3D1%26t%3D10%26q%3D%23%E8%AE%B8%E5%B5%A9%E5%91%BC%E5%90%B8%E4%B9%8B%E9%87%8E%E6%BC%94%E5%94%B1%E4%BC%9A%23&extparam=%23%E8%AE%B8%E5%B5%A9%E5%91%BC%E5%90%B8%E4%B9%8B%E9%87%8E%E6%BC%94%E5%94%B1%E4%BC%9A%23"
},
{
"title": "#冯禧许嵩疑分手#",
"desc1": "",
"desc2": "6157讨论 8040.5万阅读",
"url": "https://m.weibo.cn/search?containerid=231522type%3D1%26t%3D10%26q%3D%23%E5%86%AF%E7%A6%A7%E8%AE%B8%E5%B5%A9%E7%96%91%E5%88%86%E6%89%8B%23&extparam=%23%E5%86%AF%E7%A6%A7%E8%AE%B8%E5%B5%A9%E7%96%91%E5%88%86%E6%89%8B%23"
}
]get_comments(feed_id, page)
描述：获取微博帖子的评论
返回示例：
[{
"id": 5176653778784993,
"text": "回复@需要爱谁:这是openRouter的使用数据。ds除了那波发布的新鲜劲头，主要服务国内市场。国内用户没理由用国内ai还特意找openRouter这个海外中间商",
"created_at": "55分钟前",
"source": "来自广东",
"user": {
"id": 1784072130,
"screen_name": "呗塔熊",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/1784072130?",
"description": "",
"follow_count": 0,
"followers_count": "158",
"avatar_hd": "",
"verified": false,
"verified_reason": "",
"gender": ""
},
"reply_id": 5176636326281776,
"reply_text": "DS怎么是0%"
}]get_hot_feeds(uid, limit)
描述：获取微博热门帖子
返回示例：
[{
"id": 5188923573404794,
"text": "《深度学习数学导论(Mathematical Introduction to Deep Learning: Methods, Implementations, and Theory)》｜全面掌握人工神经网络与优化理论！📚✨
📌【多样化ANN架构】全连接、卷积、残差、循环网络详尽解析，涵盖ReLU、GELU、Swish等丰富激活函数。🤖
📌【理论与实现并重】深入ANN的向量 ...全文",
"source": "Mac客户端",
"created_at": "Wed Jul 16 06:40:48 +0800 2025",
"user": {
"id": 1402400261,
"screen_name": "爱可可-爱生活",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/1402400261?",
"description": "北邮PRIS模式识别实验室陈老师 商务合作 QQ:1289468869 Email:1289468869@qq.com",
"follow_count": 760,
"followers_count": "85.7万",
"avatar_hd": "",
"verified": true,
"verified_reason": "AI博主",
"gender": "m"
},
"comments_count": 4,
"attitudes_count": 58,
"reposts_count": 80,
"raw_text": "",
"region_name": "发布于 北京",
"pics": [{
"thumbnail": "",
"large": ""
}],
"videos": {}
}]get_followers(uid, limit, page)
描述：获取用户关注列表
返回示例：
[{
"id": 6486678714,
"screen_name": "张小珺-Benita",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/6486678714?",
"description": "喜欢无聊的小东西",
"follow_count": 54,
"followers_count": "10万",
"avatar_hd": "",
"verified": true,
"verified_reason": "财经作者、播客《张小珺Jùn｜商业访谈录》主理人",
"gender": "f"
}]get_fans(uid, limit, page)
描述：获取用户粉丝列表
返回示例：
[{
"id": 6486678714,
"screen_name": "张小珺-Benita",
"profile_image_url": "
"profile_url": "https://m.weibo.cn/u/6486678714?",
"description": "喜欢无聊的小东西",
"follow_count": 54,
"followers_count": "10万",
"avatar_hd": "",
"verified": true,
"verified_reason": "财经作者、播客《张小珺Jùn｜商业访谈录》主理人",
"gender": "f"
}]资源
无
提示
无
依赖要求
- Python >= 3.10
- httpx >= 0.24.0
许可证
MIT 许可证 - 详见 LICENSE 文件
免责声明
本项目与微博官方无关，仅用于学习和研究目的。
