微博数据服务

通过微博访客接口提供用户、微博、热搜、评论、话题及社交关系数据,支持MCP和CLI调用。

  • by qinyuanpei
  • Python
  • 混合部署
  • 63 星标
  • 更新于
在 GitHub 查看 qinyuanpei/mcp-server-weibo

使用说明

Weibo MCP Server

通过微博访客接口提供用户、微博、热搜、评论、话题及社交关系数据。默认自动申请访客 Cookie,不读取用户手工提供的 Cookie;CLI 可通过扫码登录保存本机登录会话。

选择适合你的方式

你的目标 选择
让支持 Skill 的编码代理按项目约定调用 CLI Weibo CLI Skill
让 Agent 抓取微博数据并生成人格画像报告 Weibo Personality Skill
让 Claude、Cursor 或其他 AI 客户端自主调用微博工具 MCP 接入指南
在终端、脚本或管道中直接取得 JSON 数据 CLI 使用指南

快速开始

MCP

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

HTTP 模式使用 Streamable HTTP 端点 http://localhost:4200/mcp。完整配置、工具清单与测试方法见 MCP 接入指南。

CLI

uvx --from mcp-server-weibo weibo-cli trending -n 3
uvx --from mcp-server-weibo weibo-cli users "雷军" -n 5
uvx --from mcp-server-weibo weibo-cli feeds 1749127163 -n 10 --no-include-pics

# 可选:扫码创建本机 CLI 登录会话
uvx --from mcp-server-weibo weibo-cli login

# 校验当前本机 CLI 登录会话
uvx --from mcp-server-weibo weibo-cli session

集合查询命令输出一个完整 JSON 数组;profile 输出对象,session 输出登录会话对象或 null。完整命令、分页和精简输出选项见 CLI 使用指南。

从源码运行

git clone https://github.com/qinyuanpei/mcp-server-weibo.git
cd mcp-server-weibo
uv sync --extra dev

# MCP:stdio 或 HTTP
uv run mcp-server-weibo
uv run mcp-server-weibo http

# CLI
uv run weibo-cli --help

致谢

CLI 二维码登录功能的协议实现参考并改编自 RicterZ/mcp-server-weibo。感谢其对微博二维码登录流程的实现与公开分享。

要求与声明

  • Python >= 3.10
  • MIT License,详见 LICENSE
  • 本项目与微博官方无关,仅用于学习和研究。