微博开放 CLI 与 MCP,支持 AI 调用发布和检索接口

微博开放平台提供官方命令行工具 weibo-cli 和远程 MCP 服务,可将发布、互动、检索等接口接入脚本与 AI 工作流。使用前需完成开发者认证并开通服务;新用户可领取限次的 7 天体验服务,正式服务按积分调用,充值包从 69 元起。
微博 CLI 与 MCP 接入 AI 工作流及积分计费示意

把微博操作接入终端和 AI 工具

微博 CLI 把发博、评论互动、内容检索和账号数据查询等操作封装成终端命令。CLI 就是命令行工具:人可以逐条输入指令,程序也可以按流程连续调用。

返回结果支持 JSON、YAML、表格和原始格式。JSON 和 YAML 是便于程序读取的数据格式,因此脚本可以把查询结果交给 AI 整理,再将结果写入自己的报告或运营系统。

微博同时提供远程 MCP 服务。MCP 是让 AI 应用连接外部工具的通用协议;支持相应连接和授权方式的客户端,可以通过它调用微博能力。需要自己编排脚本的开发者可从 CLI 入手,已有 MCP 客户端的用户则可直接配置远程服务。

这种接入方式也出现在 WorkBuddy 开放平台的 CLI 与连接器方案 中:先将业务能力做成工具,再由 AI 应用组织调用步骤。

安装后,还要完成认证和服务开通

截至 2026 年 11 月 17 日,npm 上的最新版本为 0.9.8,要求 Node.js 18 或更高版本。软件包提供 weibo、weibo-cli 和 wb 三个命令名,下面统一使用 weibo。

1
2
npm install -g @weibo-ai/weibo-cli
weibo version

调用平台接口前,先在微博 CLI 控制台使用微博客户端扫码、完成开发者扫脸认证,再到“我的服务”领取体验服务或购买正式积分包。完成这些步骤后,可创建 CLI 授权并在终端登录:

1
2
3
weibo auth login
weibo auth whoami
weibo doctor

登录采用 OAuth 授权,也就是在微博登录页确认这台工具的访问权限。auth whoami 用于确认当前会话,doctor 则检查登录、开发者认证和服务状态。

在 SSH、远程服务器或容器里,可以改用设备码登录:

1
weibo auth login --device

终端会给出授权网址和验证码,用户仍需在浏览器里确认。设备码让远程环境能够登录,不会省略账号授权步骤。

用命令清单确认账号能调用什么

平台命令由服务端清单提供。先查看账号可用范围,再查询具体命令的参数,比直接复制旧教程更合适:

1
2
3
weibo commands list --available
weibo commands show users show_batch/other
weibo me --output table

commands show 会展示命令说明和必填参数,me 用于查看账号、余额和服务信息。常见查询入口包括:

任务 命令示例
读取首页时间线 weibo statuses friends_timeline/biz --count 5 --output json
按昵称查询用户 weibo users show_batch/other --screen_name 来去之间
按关键词检索微博 weibo search statuses/limited --q keyword
查看收到的评论 weibo comments to_me/biz

命令是否可用取决于账号的服务状态和接口范围。为 AI 编排工作流时,可以先从读取时间线、检索内容或整理评论开始,再加入发布与回复步骤。

7 天体验限次,正式服务按积分调用

7 天体验服务每个账号只能领取一次,领取前需通过开发者认证。已经领取过体验服务、开通过正式服务或曾付费充值的账号,不能再次领取。

体验期只开放白名单内的部分接口,不扣积分,但按接口分别限次:读取类通常为每个接口 5 次,写入类通常为每个接口 3 次。多图发博、统计和趋势等能力不在体验服务范围内。

正式服务通过购买积分包开通,拥有可用积分余额后可调用全部开放接口。当前充值档位如下:

积分包 价格 到账积分 每 1,000 积分价格
入门包 69 元 23,000 3 元
标准包 198 元 79,200 2.5 元
专业包 398 元 199,000 2 元
旗舰包 998 元 998,000 1 元

这些是积分充值价格。实际调用成本还取决于接口按次或按条扣分的规则,不能直接把积分数当作可调用次数。所购积分自到账起有效期为 365 天,过期未用完的积分会失效;写入类 HTTP POST 接口另有每小时合计 60 次的频率限制。

客户端软件包采用 MIT 许可,平台接口使用则受认证、服务资格、余额和频率限制约束。

MCP 客户端可直接连接远程服务

支持 OAuth 授权与 Streamable HTTP 传输的 MCP 客户端,可以按自身配置格式添加以下连接。Streamable HTTP 是通过 HTTP 连接远程 MCP 服务的方式。

1
2
3
4
5
6
7
8
{
"mcpServers": {
"weibo": {
"type": "streamableHttp",
"url": "https://cli.weibo.com/mcp"
}
}
}

连接时,客户端会打开浏览器完成微博授权,无需在这段配置里手填静态 Token。账号仍需通过开发者认证,并处于有效体验期或拥有可用正式积分余额。

发布 AI 生成的博文时,使用者须声明其 AI 生成属性,由系统添加相应标识。将发文、评论或关注等操作接入 AI 工作流时,适合保留执行前的人工确认,核对目标账号、内容和操作范围。

原始来源

以下资料用于核对本文信息;价格、开放范围与产品状态请以来源的最新说明为准。

  1. 微博开放平台 CLI — 产品定位、发布与互动及检索能力
  2. 微博 CLI 使用前提与安装登录手册 — 开发者认证、服务开通和设备授权流程
  3. 微博 CLI 常用命令手册 — 命令发现、参数查询与账号状态检查
  4. 微博 CLI 服务与积分手册 — 7 天体验资格、接口限次、正式积分有效期和写入频率
  5. 微博 CLI 正式充值包公开接口 — 69、198、398、998 元四档充值价格及对应积分
  6. 微博开放平台 MCP 接入手册 — 远程服务地址、客户端配置与浏览器授权流程
  7. 微博 CLI 微博发布规则说明 — AI 生成博文的声明与标识要求
  8. 微博 CLI npm 软件包 — 0.9.8 版本、Node.js 要求、命令别名、输出格式与 MIT 许可