很多 Agent Demo 停在“给建议”：它能写选题、分析语气，却无法读取实时上下文，也不能把动作安全地落到业务系统。要从聊天升级为工作流，关键不是再换一个模型，而是给模型一组边界明确、结果可验证的工具。

weibo-cli 提供了这样一层连接：微博开放平台能力通过命令行暴露，覆盖内容、评论、关系、搜索、用户和趋势等命令组，输出支持 JSON、YAML、表格和原始格式。

一、Agent 工作流的四层

比较稳妥的设计可以拆成四层：

• 检索层：读取关键词、账号、时间线或趋势数据。
• 推理层：让模型聚类、摘要、提出选题或回复建议。
• 审批层：涉及对外动作时，由人确认目标和最终文案。
• 执行层：调用发布、评论或其他写命令，并记录结果。

weibo-cli 主要承担第一层和第四层，中间的模型、提示词与审批流程由你的 Agent 决定。这种分工的好处是：模型可以替换，执行接口保持稳定；提示词出错时，也有权限和人工确认兜底。

二、让 Agent 学会“发现工具”

不要把所有命令和参数硬编码进提示词。CLI 自带命令目录：

weibo-cli commands list --available --output json

weibo-cli commands show search statuses/limited --output json

第一条返回当前套餐可用的能力，第二条查看某个命令的参数和要求。Agent 可以先发现能力，再生成调用参数，这比依赖一份可能过期的静态列表更可靠。

三、结构化输出才是连接点

下面的调用把当前登录用户发布的微博列表交给后续程序：

weibo-cli statuses user_timeline/biz --count 20 --output json > timeline.json

后续步骤可以筛字段、去重、做主题聚类或生成摘要。关键是保留原始数据和中间产物，让“模型为什么得出这个结论”可以回查。

如果你维护的是支持 MCP 的 Agent Host，也可以在控制台创建 API Token，通过 MCP 接入同一套开放能力。CLI 适合终端、脚本和快速验证；MCP 更适合让 Agent 原生发现和调用工具。两种入口受相同的认证、套餐、额度和计费规则约束。

四、写操作要多一道闸门

让 Agent 直接发文看起来很酷，但生产环境更需要可控。建议至少保留以下检查：

• 明确区分只读命令与写命令；
• 写操作展示目标账号、命令、完整文案和媒体文件；
• 人工确认后才执行，避免把“给我一个建议”误解为“立即发布”；
• 记录命令、时间、操作者和返回结果；
• AI 生成内容按规则声明并打标。

五、最小接入路径

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

weibo-cli auth login

weibo-cli doctor

weibo-cli commands list --available

使用前需要完成开发者认证，并开通套餐或领取试用。建议先做一个只读 Agent：选择一个真实关键词或账号，完成“获取—分析—生成报告”的闭环。确认数据和流程确实有价值后，再增加人工审批下的写操作。

六、一个最小 Agent 的设计示例

可以把第一个版本限制为“只读研究助手”。用户输入关键词和报告目的，Agent 依次完成：检查可用搜索命令、获取结果、去除重复内容、按主题分组、输出带来源的摘要。它不能评论、转发或发布，也不能自行扩大检索范围。

每一步都产生可检查的中间结果：

request.json          # 用户目标与关键词

raw-results.json      # CLI 原始响应

normalized.json       # 清洗和去重结果

report.md             # Agent 生成的报告

run.md                # 时间、命令、是否成功与版本

这种设计看起来比“全能微博 Agent”保守，却更容易测试。你可以为同一组输入重复运行，比较结果是否稳定；也可以在报告出错时追溯到究竟是采集、清洗还是模型推理出了问题。

七、工具描述比提示词更重要

Agent 调用失败，很多时候不是模型能力不足，而是工具描述含糊。一个好的工具定义应告诉模型：命令解决什么问题、哪些参数必填、结果代表什么、有哪些权限和计费约束、什么时候不应该调用。

weibo-cli 的 commands show 提供命令详情。接入层还应增加自己的业务约束，例如“同一任务最多检索 5 个关键词”“单次结果只用于内部研究”“任何写操作必须产生审批单”。平台参数解决技术正确性，业务规则解决使用正确性。

八、如何评测 Agent，而不是凭感觉试玩

准备 20—30 个来自真实工作的测试任务，其中应包含正常请求、参数缺失、无相关结果、超出权限和带有写入暗示的请求。至少评估：

• 工具选择准确率：是否选对命令；
• 参数完整率：是否提供必填字段；
• 证据一致性：结论能否在输入中找到；
• 拒绝与升级：权限不足或信息不够时是否停下；
• 成本：每个任务消耗的调用次数和人工复核时间。

写操作测试应在隔离环境或模拟层完成，不能为了评测而在真实账号重复发布。

九、MCP 和 CLI 可以同时存在

团队不必在二者中永久二选一。研发可以用 CLI 调试具体命令、复现错误和编写批处理；Agent Host 使用 MCP 做工具发现和多轮调用；关键生产服务再根据吞吐和治理需要决定是否直接接 API。共同的能力目录让不同入口更容易保持一致。

十、结语

Agent 的差异化，越来越不只来自它“会说什么”，还来自它“被允许做什么、能把什么做稳”。如果微博是你的业务场景之一，weibo-cli 可以成为这条工具链的起点。

产品入口：

https://open.weibo.com/cli/

附录：常用命令与参数说明

以下为本文涉及命令在实际验证中的真实行为：

命令	--count 参数	说明
search hot_word/biz	支持，最大 20	获取热搜主榜，count 范围 1-20
statuses user_timeline/biz	支持，最大 20	获取当前用户微博列表
comments to_me/biz	支持，最大 20	获取收到的评论列表
comments show/biz	支持，最大 20	获取单条微博的评论

注：不同命令对 --count 的上限可能不同，建议通过 commands show 查看具体参数约束。