Weibo MCP Server 🚀

基于 Model Context Protocol 的微博数据 API 服务器 - 实时获取微博用户资料、帖子、热搜话题、粉丝/关注数据。支持用户搜索、内容分析和话题发现，适用于 AI 应用。

安装

自动 Cookie 获取： 无需手动配置 Cookie，程序会自动通过微博访客通行证生成有效的访问凭证。

方式一：从包管理器安装（推荐）

# 安装
uvx install mcp-server-weibo

# 以 stdio 模式运行
mcp-server-weibo stdio

# 以 http 模式运行
mcp-server-weibo http

MCP 客户端配置（stdio 模式）：

{
  "mcpServers": {
    "weibo": {
      "command": "uvx",
      "args": ["mcp-server-weibo"]
    }
  }
}

方式二：从 Docker 运行

# 构建镜像
docker build -t mcp-server-weibo .

# 运行容器
docker run -p 4200:4200 mcp-server-weibo http

MCP 客户端配置（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 10

CLI 命令列表

命令	说明
weibo-cli profile <uid>	根据 UID 获取用户资料
weibo-cli feeds <uid> [-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 <feed_id> [-p P]	获取帖子评论
weibo-cli followers <uid> [-n N] [-p P]	获取用户粉丝
weibo-cli fans <uid> [-n N] [-p P]	获取用户关注

组件

工具

search_users(keyword, limit)

描述：搜索微博用户

返回示例：

[
  {
    "id": 1749127163,
    "screen_name": "雷军",
    "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg?KID=imgbed,tva&Expires=1749109677&ssig=QzOuVFBlRp",
    "profile_url": "https://m.weibo.cn/u/1749127163?",
    "description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
    "follow_count": 1562,
    "followers_count": "2671.2万",
    "avatar_hd": "https://wx1.sinaimg.cn/orj480/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg",
    "verified": true,
    "verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
    "gender": "m"
  }
]

get_profile(uid)

描述：获取用户详细信息

返回示例：

{
  "id": 1749127163,
  "screen_name": "雷军",
  "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg?KID=imgbed,tva&Expires=1749109733&ssig=5OrMoqbwcY",
  "profile_url": "https://m.weibo.cn/u/1749127163?",
  "description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
  "follow_count": 1562,
  "followers_count": "2671.2万",
  "avatar_hd": "https://wx1.sinaimg.cn/orj480/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg",
  "verified": true,
  "verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
  "gender": "m"
}

get_feeds(uid, limit)

描述：获取用户帖子

返回示例：

[
  {
    "id": 5167970394572058,
    "text": "今年是小米创业15周年。<br />早在11年前，2014年，我们就开始芯片研发之旅。<br /><br />2014年9月，澎湃项目立项。2017年，小米首款手机芯片"澎湃S1"正式亮相，定位中高端。后来，因为种种原因，遭遇挫折，我们暂停了SoC大芯片的研发。但我们还是保留了芯片研发的火种，转向了"小芯片"路线。再后来，小米澎湃各 ...<a href=\"/status/5167970394572058\">全文</a>",
    "source": "Xiaomi 15S Pro",
    "created_at": "Mon May 19 11:00:21 +0800 2025",
    "user": {
      "id": 1749127163,
      "screen_name": "雷军",
      "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg?KID=imgbed,tva&Expires=1749109794&ssig=29j5mGcswB",
      "profile_url": "https://m.weibo.cn/u/1749127163?",
      "description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
      "follow_count": 1562,
      "followers_count": "2671.2万",
      "avatar_hd": "https://wx1.sinaimg.cn/orj480/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg",
      "verified": true,
      "verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
      "gender": "m"
    },
    "comments_count": 10183,
    "attitudes_count": 141025,
    "reposts_count": 5884,
    "raw_text": "",
    "region_name": "发布于 北京",
    "pics": [
      {
        "thumbnail": "https://wx2.sinaimg.cn/orj360/001Un9Srly1i1k4dr5djgj60u04gp7wh02.jpg",
        "large": "https://wx2.sinaimg.cn/large/001Un9Srly1i1k4dr5djgj60u04gp7wh02.jpg"
      }
    ],
    "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": "<a  href=\"https://m.weibo.cn/search?containerid=231522type%3D1%26t%3D10%26q%3D%23%E5%90%89%E5%88%A9%E9%93%B6%E6%B2%B3%23&extparam=%23%E5%90%89%E5%88%A9%E9%93%B6%E6%B2%B3%23\" data-hide=\"\"><span class=\"surl-text\">#吉利银河#</span></a><br />省流：<br />1.推荐度系列分为四个等级，一般/可买/推荐/非常推荐。「一般/可买」车型减少展开，想看的人比较多的话，我们会给大家再出详细的视频<br />2.本期非常推荐的有吉利星愿、星耀8 ，推荐有熊猫mini、星舰7、银河E5<br />3.大家还有什么想看的品牌的年中横评也可以在评论下留言  ...<a href=\"/status/5173507416919189\">全文</a>",
    "source": "微博视频号",
    "created_at": "Tue Jun 03 17:42:30 +0800 2025",
    "user": {
      "id": 2098256142,
      "screen_name": "农民新八",
      "profile_image_url": "https://tvax2.sinaimg.cn/crop.0.0.1080.1080.180/7d10d90ely8hcufl69gx9j20u00u0mxu.jpg?KID=imgbed,tva&Expires=1749110036&ssig=cgiHgZmsMD",
      "profile_url": "https://m.weibo.cn/u/2098256142?",
      "description": "新八，26岁。喜机械，喜机车，喜汽车，喜摄影。",
      "follow_count": 429,
      "followers_count": "19.9万",
      "avatar_hd": "https://wx2.sinaimg.cn/orj480/7d10d90ely8hcufl69gx9j20u00u0mxu.jpg",
      "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": "回复<a href='https://m.weibo.cn/n/需要爱谁'>@需要爱谁</a>:这是openRouter的使用数据。ds除了那波发布的新鲜劲头，主要服务国内市场。国内用户没理由用国内ai还特意找openRouter这个海外中间商",
   "created_at": "55分钟前",
   "source": "来自广东",
   "user": {
      "id": 1784072130,
      "screen_name": "呗塔熊",
      "profile_image_url": "https://tva2.sinaimg.cn/crop.0.0.749.749.180/6a56c7c2jw8f2l1ermz4hj20ku0kt3z8.jpg?KID=imgbed,tva&Expires=1749708042&ssig=eLSiu6Jz5j",
      "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%<span class=\"url-icon\"><img alt=[思考] src=\"https://h5.sinaimg.cn/m/emoticon/icon/default/d_sikao-ff9602dd08.png\" style=\"width:1em; height:1em;\" /></span>"
}]

get_hot_feeds(uid, limit)

描述：获取微博热门帖子

返回示例：

[{
  "id": 5188923573404794,
  "text": "《深度学习数学导论(Mathematical Introduction to Deep Learning: Methods, Implementations, and Theory)》｜全面掌握人工神经网络与优化理论！📚✨<br />📌【多样化ANN架构】全连接、卷积、残差、循环网络详尽解析，涵盖ReLU、GELU、Swish等丰富激活函数。🤖<br />📌【理论与实现并重】深入ANN的向量 ...<a href=\"/status/5188923573404794\">全文</a>",
  "source": "Mac客户端",
  "created_at": "Wed Jul 16 06:40:48 +0800 2025",
  "user": {
    "id": 1402400261,
    "screen_name": "爱可可-爱生活",
    "profile_image_url": "https://tva2.sinaimg.cn/crop.10.34.646.646.180/5396ee05jw1ena6co8qiwj20sg0izjxd.jpg?KID=imgbed,tva&Expires=1752744231&ssig=mKmwQ4f8aA",
    "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": "https://ww2.sinaimg.cn/orj480/5396ee05jw1ena6co8qiwj20sg0izjxd.jpg",
    "verified": true,
    "verified_reason": "AI博主",
    "gender": "m"
  },
  "comments_count": 4,
  "attitudes_count": 58,
  "reposts_count": 80,
  "raw_text": "",
  "region_name": "发布于 北京",
  "pics": [{
    "thumbnail": "https://wx2.sinaimg.cn/orj360/5396ee05ly8i3fgq9fm9fj20p610aq51.jpg",
    "large": "https://wx2.sinaimg.cn/large/5396ee05ly8i3fgq9fm9fj20p610aq51.jpg"
  }],
  "videos": {}
}]

get_followers(uid, limit, page)

描述：获取用户关注列表

返回示例：

[{
  "id": 6486678714,
  "screen_name": "张小珺-Benita",
  "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/0074Zrsely8hz0hg65fq8j30u00u0n1e.jpg?KID=imgbed,tva&Expires=1752744494&ssig=SZY8jaooks",
  "profile_url": "https://m.weibo.cn/u/6486678714?",
  "description": "喜欢无聊的小东西",
  "follow_count": 54,
  "followers_count": "10万",
  "avatar_hd": "https://wx1.sinaimg.cn/orj480/0074Zrsely8hz0hg65fq8j30u00u0n1e.jpg",
  "verified": true,
  "verified_reason": "财经作者、播客《张小珺Jùn｜商业访谈录》主理人",
  "gender": "f"
}]

get_fans(uid, limit, page)

描述：获取用户粉丝列表

返回示例：

[{
  "id": 6486678714,
  "screen_name": "张小珺-Benita",
  "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/0074Zrsely8hz0hg65fq8j30u00u0n1e.jpg?KID=imgbed,tva&Expires=1752744494&ssig=SZY8jaooks",
  "profile_url": "https://m.weibo.cn/u/6486678714?",
  "description": "喜欢无聊的小东西",
  "follow_count": 54,
  "followers_count": "10万",
  "avatar_hd": "https://wx1.sinaimg.cn/orj480/0074Zrsely8hz0hg65fq8j30u00u0n1e.jpg",
  "verified": true,
  "verified_reason": "财经作者、播客《张小珺Jùn｜商业访谈录》主理人",
  "gender": "f"
}]

资源

无

提示

无

依赖要求

• Python >= 3.10
• httpx >= 0.24.0

许可证

MIT 许可证 - 详见 LICENSE 文件

免责声明

本项目与微博官方无关，仅用于学习和研究目的。