weibo-cli

2026 年 6 月 22 日，微博开放平台正式发布了其官方开源命令行工具 weibo-cli。这款基于 Node.js 开发的工具不仅封装了微博平台的 70 余个核心 API，更在架构上原生适配了 MCP（Model Context Protocol） 协议，旨在为开发者和 AI Agent 提供一套高效、可编程的微博交互接口。

核心亮点：AI 原生与终端友好

1. MCP 协议支持，即插即用

weibo-cli 的最大特色在于其对 MCP 的支持。这意味着它可以无缝接入 Claude Desktop、Cursor 等支持 MCP 的 AI 客户端。AI Agent 可以直接通过自然语言指令调用微博能力，如“帮我查询今天的科技热搜”或“发布一条带图的微博”，无需开发者编写复杂的中间件代码。

2. 全功能 API 封装

工具覆盖了微博生态的核心业务场景：

• 内容发布：支持文字、图文、视频及长微博的自动化发布与工作流编排。
• 互动管理：自动分流评论与转发，支持脚本化回复。
• 数据检索：关键词搜索、用户信息查询、热搜趋势获取。
• 营销与分析：粉丝画像读取、行为特征分析、批量分发及抽奖活动支持。

3. 灵活的输出格式

为了便于与其他命令行工具或数据处理管道集成，weibo-cli 支持 JSON、YAML、表格（table） 和 原始（raw） 四种输出格式。开发者可以轻松地将微博数据导入到本地数据库、Excel 或其他分析工具中。

4. 无头环境友好

除了常规的浏览器 OAuth 授权外，weibo-cli 还支持 --device 参数进行设备码登录。这使得它可以在 SSH、Docker 容器或 CI/CD 流水线等无图形界面的服务器环境中稳定运行，极大地拓展了其应用场景。

快速开始

环境要求：Node.js 18 及以上版本。

安装：

npm install -g @weibo-ai/weibo-cli

认证：

# 浏览器授权
weibo-cli auth login

# 无头环境设备码授权
weibo-cli auth login --device

# 验证状态
weibo-cli auth whoami

使用示例：

# 获取好友时间线
weibo-cli statuses friends_timeline

# 按昵称查询用户信息
weibo-cli users show_batch --screen_name "weibo"

# 查看帮助
weibo-cli --help

计费模式：按 Credits 用量订阅

weibo-cli 采用订阅制计费，根据接口调用的复杂度消耗 Credits。目前共设五个套餐：