微博开放70+API：weibo-cli让Agent直接操作社交平台

微博终于想通了。

6月22日，微博开放平台悄悄上线了一个叫 weibo-cli 的命令行工具。这东西说白了，就是把微博的70多个API接口打包成终端命令，开发者敲几行代码就能发微博、查热搜、管评论。更关键的是，它原生支持MCP协议——这意味着AI Agent可以直接把微博当成一个可调用的工具来用。

对于做社交媒体自动化、舆情监控、营销工具的开发者来说，这可能是今年最实用的国内平台开放动作之一。

为什么这件事值得关注

国内主流社交平台的API开放程度一直是个老大难问题。微信几乎不开放，抖音的开放平台限制重重，小红书更是连官方API都没有。相比之下，微博虽然早就有开放平台，但用起来体验一言难尽：文档散乱、认证流程繁琐、SDK年久失修。

很多开发者想做个简单的微博数据抓取，最后都被迫走上了逆向爬虫的路——费时费力还有封号风险。

weibo-cli 的出现，算是微博在开发者体验上迈出的一大步。它解决了三个核心痛点：

第一，把认证流程简化到一行命令。 以前调微博API，光OAuth授权流程就能劝退一半人。现在只需要 weibo-cli auth login，浏览器弹出来扫个码就完事。在服务器上跑？加个 --device 参数，设备码认证也支持。

第二，命令结构清晰，上手成本极低。 所有命令都是 <group> <action> 的模式。想看热搜？weibo-cli search trending。想发微博？weibo-cli statuses create。想批量查用户？weibo-cli users show_batch。不用翻文档猜参数，--help 一敲就知道怎么用。

第三，输出格式对机器友好。 支持JSON、YAML、表格、原始数据四种输出格式。这对于要做数据管道的场景太重要了——抓下来的数据可以直接喂给 jq 处理，或者丢进 Agent 的上下文里。

AI Agent原生支持：这才是重点

如果只是把API包装成CLI，那 weibo-cli 顶多算个趁手的工具。真正让它有想象空间的，是对MCP协议的原生支持。

MCP（Model Context Protocol）是Anthropic提出的一套协议，用来让AI Agent调用外部工具。简单说，就是Agent可以通过标准化的方式"使用"各种服务，而不需要为每个服务写专门的适配代码。

weibo-cli 内置了MCP兼容层，这意味着：

• Claude、GPT这类支持function calling的模型，可以直接把微博操作作为可用工具
• 基于LangChain、AutoGPT等框架搭建的Agent，能即插即用地接入微博能力
• 不需要自己封装API wrapper，工具描述、参数校验都已经处理好了

举个实际场景：你搭了一个舆情监控Agent，它需要每小时检查微博热搜里有没有跟你品牌相关的话题，如果有就自动生成一条回应微博发出去。以前这套流程你得自己写一堆胶水代码，现在Agent直接调 weibo-cli search trending 和 weibo-cli statuses create 就行。

官方文档里给了一个典型的Agent工作流示例：

# 1. 抓取实时热搜，筛选包含特定关键词的话题
weibo-cli search trending --output json \
  | jq '[.[] | select(.keyword | contains(\"护肤\"))]' > trending.json

# 2. 提取第一个话题的关键词
KEYWORD=$(jq -r '.[0].keyword' trending.json)

# 3. 搜索相关微博内容
weibo-cli search keyword --query \"$KEYWORD\" \
  --limit 30 --output json > posts.json

# 4. 把内容丢给LLM做摘要
cat posts.json | llm-cli summarize \
  --prompt \"总结这些微博的核心观点，200字以内\"

这种管道化的工作方式，才是CLI工具的正确打开姿势。

功能覆盖：比想象中全面

weibo-cli 封装了70多个API，覆盖了微博开放平台的主要能力模块。我按使用场景拆解一下：

内容发布

这是大多数人最关心的功能。支持发布：

• 纯文字微博
• 图文微博（支持多图）
• 视频微博
• 长微博/头条文章

命令示例：

# 发布纯文字微博
weibo-cli statuses create --text \"这是一条测试微博\"

# 发布带图片的微博（图片需要先上传获取media_id）
weibo-cli media upload --file ./photo.jpg --output json
# 返回 {\"media_id\": \"xxxxx\"}
weibo-cli statuses create --text \"配图微博\" --media_ids \"xxxxx\"

# 发布到指定话题
weibo-cli statuses create --text \"#科技新闻# 这是一条带话题的微博\"

需要注意的是，发布功能对账号权限有要求。普通开发者账号可能只能发自己的微博，想做代发服务需要申请更高级别的权限。

数据检索

这块是做数据分析、舆情监控的核心能力：

# 关键词搜索微博
weibo-cli search keyword --query \"iPhone\" --count 50 --output json

# 搜索用户
weibo-cli search users --query \"科技博主\" --count 20

# 获取实时热搜榜
weibo-cli search trending --output table

# 获取指定话题的热度趋势
weibo-cli topics show --topic \"人工智能\" --output json

输出格式的灵活性很实用。--output table 适合人眼看，--output json 适合程序处理，--output csv 可以直接导入Excel做分析。

互动管理

评论、转发、点赞这些互动操作也都支持：

# 获取某条微博的评论
weibo-cli comments show --id 微博ID --count 100

# 发表评论
weibo-cli comments create --id 微博ID --comment \"评论内容\"

# 转发微博
weibo-cli statuses repost --id 微博ID --status \"转发语\"

# 获取我的粉丝列表
weibo-cli friendships followers --count 200

对于做社群运营的团队，这些接口可以用来搭建自动化回复系统——比如检测评论里的特定关键词，自动回复标准答案。

用户数据

# 查看当前登录账号信息
weibo-cli me --output table

# 批量查询用户信息（按昵称）
weibo-cli users show_batch --screen_names \"用户A,用户B,用户C\"

# 获取用户的粉丝画像数据
weibo-cli users followers_profile --uid 用户ID

粉丝画像数据对做KOL分析、广告投放的团队很有价值，以前这些数据要么靠第三方工具，要么手动扒页面。

营销工具

微博的商业化能力也有封装：

# 创建抽奖活动
weibo-cli lottery create --text \"转发抽奖\" --prize \"奖品描述\" --winner_count 3

# 查看抽奖结果
weibo-cli lottery result --id 活动ID

这对做品牌营销的团队来说，可以把抽奖活动的创建、开奖、通知中奖者整个流程自动化。

计费模式：Credits订阅制

weibo-cli 不是完全免费的，采用Credits（积分）订阅制计费。官方提供了五档套餐：

| 套餐 | Credits额度 | 价格 | 适用场景 | |------|-------------|------|----------| | Free | 试用额度 | 免费7天 | 体验评估 | | Basic | 3,000 | ¥29/月 | 个人开发者 | | Pro | 15,000 | ¥99/月 | 小团队 | | Business | 50,000 | ¥299/月 | 中型企业 | | Ultra | 200,000 | ¥999/月 | 大规模应用 |

Free套餐有几个限制：只能查询自己的微博数据，基础接口每小时限5次调用。想做正经开发还是得上Basic起步。

不同接口消耗的Credits不同。查询类接口便宜，发布类接口贵一些，这符合API定价的一般逻辑。具体每个接口的消耗，可以用 weibo-cli commands show <命令名> 查看。

说实话，这个定价在国内API服务里算中规中矩。对比一下：七牛云的图片处理API、阿里云的NLP服务，按量计费换算下来也差不多这个水平。

安装和认证：5分钟上手

技术栈是Node.js，要求18及以上版本。安装就一行：

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

或者用官方提供的安装脚本（适合没装npm的环境）：

curl -fsSL https://open.weibo.com/cli/install.sh | bash

安装完第一步是登录认证：

# 桌面环境：会弹出浏览器让你扫码
weibo-cli auth login

# 服务器/SSH环境：用设备码认证
weibo-cli auth login --device

认证成功后，凭证会存储在 ~/.config/weibo-cli/credential.json。可以用 weibo-cli auth whoami 确认登录状态：

$ weibo-cli auth whoami
✓ 已登录：@你的微博昵称
  UID: 1234567890
  套餐: Basic
  Credits余额: 2,847

有个细节值得注意：认证支持从浏览器提取Cookie。如果你已经在浏览器里登录了微博，CLI可以直接复用那个登录态，不需要再扫一次码。这对调试很方便，但生产环境建议还是用OAuth正规流程。

和同类工具对比：官方身份是最大优势

市面上做微博数据抓取的工具不少，GitHub上搜"weibo"能找到一堆。weibo-cli 的核心优势在于"官方出品"：

合规性：用官方API不用担心被封号，数据来源合法合规。这对企业用户很重要，很多公司内部合规审查根本不允许用爬虫。

稳定性：第三方工具依赖逆向接口，微博改版就得跟着改。官方API有稳定性承诺，不会说改就改。

功能完整性：发布、互动这些写操作，爬虫基本做不了。官方API能力全面得多。

当然也有劣势。官方工具必须遵守平台规则，有些数据（比如非公开微博、私信内容）你就是拿不到。而且要付费，不像开源爬虫随便用。

对于个人开发者做小项目，免费的开源工具可能够用。但对于企业级应用，或者要长期稳定运行的服务，weibo-cli 是更靠谱的选择。

实际应用场景

说几个我觉得 weibo-cli 特别适合的场景：

1. 舆情监控系统

品牌方最头疼的就是负面舆情发酵。用 weibo-cli 可以搭建一个简单的监控流程：

#!/bin/bash
# 每30分钟运行一次

# 搜索品牌相关的最新微博
weibo-cli search keyword --query \"品牌名\" --count 100 --output json > /tmp/mentions.json

# 用情感分析API判断正负面
cat /tmp/mentions.json | sentiment-analyzer > /tmp/analysis.json

# 如果发现负面内容，发送告警
jq '.[] | select(.sentiment == \"negative\")' /tmp/analysis.json | alert-sender

配合cron定时任务，一个基础的舆情监控就跑起来了。

2. 内容分发自动化

很多自媒体运营者要同时管理多个账号，内容分发是个体力活。可以写个脚本：

# 读取待发布内容
CONTENT=$(cat today_post.txt)

# 循环发布到多个账号（需要分别认证）
for account in account1 account2 account3; do
    weibo-cli auth switch --profile $account
    weibo-cli statuses create --text \"$CONTENT\"
    sleep 60  # 间隔一分钟，避免触发风控
done

3. KOL数据分析

做MCN或者品牌投放的，需要评估KOL的真实影响力：

# 获取KOL的基本数据
weibo-cli users show --screen_name \"KOL昵称\" --output json > kol_profile.json

# 获取最近100条微博的互动数据
weibo-cli statuses user_timeline --screen_name \"KOL昵称\" --count 100 --output json > kol_posts.json

# 计算平均互动率
jq '[.[].reposts_count + .[].comments_count + .[].attitudes_count] | add / length' kol_posts.json

4. AI Agent集成

这是最有想象空间的方向。一个智能客服Agent，可以：

• 监控品牌账号的评论和私信
• 识别用户问题的类型
• 自动生成回复内容
• 调用 weibo-cli 发送回复

整个流程可以做到全自动，人工只需要处理Agent搞不定的复杂case。

一些使用建议

用了几天，有几个经验分享：

1. 善用 --output json 配合 jq

jq 是处理JSON的神器，和 weibo-cli 配合起来效率极高。比如只提取微博的文字内容：

weibo-cli search keyword --query \"AI\" --output json | jq '.[].text'

2. 注意频率限制

即使是付费套餐，也有调用频率限制。批量操作时记得加延时，别一口气发几百个请求把自己封了。

3. 凭证安全

credential.json 里存的是你的登录凭证，别提交到Git仓库里。建议把 ~/.config/weibo-cli/ 加到全局 .gitignore。

4. 生产环境用专门的微博账号

别用自己的主账号跑自动化脚本。万一触发风控被限制，影响日常使用就麻烦了。

总结

weibo-cli 的发布，标志着微博在开发者生态建设上终于开始认真了。70多个API、原生MCP支持、合理的定价，这套组合拳打下来，确实降低了接入微博能力的门槛。

对于AI应用开发者来说，这可能是目前国内最容易接入的社交媒体平台能力。当你的Agent需要"发个微博"或者"看看热搜"的时候，终于有了一个正规渠道。

当然，工具只是工具，能玩出什么花样还得看开发者的创意。如果你正在做社交媒体相关的项目，建议抽空试试这个工具。Free套餐7天免费试用，足够评估它适不适合你的场景了。

---

参考来源

• IT之家：微博CLI工具正式上线，专为开发者和AI Agent打造 - 新闻报道，包含套餐价格等详细信息
• 掘金：微博开放平台官方CLI开源了 - 技术解析，包含详细的命令示例和Agent集成方案
• GitHub: weibo-cli - 开源代码仓库，包含完整文档和使用示例