登录（浏览器 OAuth / 设备码）

不消耗 credit。TTY 下默认打开浏览器完成 OAuth；非 TTY（脚本、SSH、容器）自动改用设备码流程。凭据优先存入系统 keychain，keychain 不可用时回退为 ~/.weibo-cli/ 下的加密文件（随机密钥单独存放，不防同账号攻击者）。也可用环境变量 WEIBO_CLI_TOKEN / WEIBO_CLI_REFRESH_TOKEN 注入，优先级最高且不落盘。已有登录态时需先 auth logout 才能重新授权。

退出登录并清除本地凭据

撤销服务端会话并删除本地凭据；远程撤销失败时会报错并以非零码退出。

无参数

auth logout 的兼容别名

等价于 auth logout。

无参数

显示或导出访问令牌

本地命令，不消耗 credit。默认只输出后 4 位与存储元数据，不输出完整 token；需要明文时必须显式 --export（用于管道传给其他工具）。

显示当前登录用户

本地命令，不消耗 credit。输出当前登录账号信息。

无参数

检查是否有新版本

本地命令，不消耗 credit。只检查并提示，不自动安装。兼容名：update / check-update。

无参数

列出平台命令

本地命令，不消耗 credit。命令清单由服务端下发（与 CLI 版本无关），当前 75 条。--available 只看当前套餐可用的命令；--all 列出全部并标注 allowed / locked；--group 按分组过滤。

查看单条命令的完整定义

本地命令，不消耗 credit。输出该命令的参数、必填字段、可用套餐等定义信息。

检查使用前提（登录 / 认证 / 套餐）

本地命令，不消耗 credit。逐项检查登录状态、开发者认证、服务开通情况，未就绪时给出下一步命令。声明调用方 Agent 后，输出会显示「Agent 来源」。

查看账号、服务与用量

本地命令，不消耗 credit。返回登录账号与开发者认证状态、服务类型（体验服务 / 正式服务）、credit 余额、写接口限流剩余（60 次/小时，整点重置），以及 token 状态（含随调用滚动续期的到期时间）。

查看技能详情与所需接口权限

不消耗 credit。返回技能详情，含 permissions（该技能会调用的平台接口）与 install_command。

生成 SKILL.md 模板

不消耗 credit。生成中文 SKILL.md 模板（含 permissions 示例）。名称须为小写连字符分隔（2–64 字符）；已存在 SKILL.md 时不会覆盖。

安装技能到本地

不消耗 credit。名字支持 slug、@scope/slug、slug@version、@scope/slug@version。0.9.4 起下载包强制校验 SHA-256（无绕过开关，校验失败保留原安装），并限制来源域名与文件类型。安装会整体替换技能目录，旧版本文件被删除。

列出 Skill Hub 上的 Agent 技能

不消耗 credit。Agent Skill Hub 客户端（0.9.3 起内置）。返回技能的标题、作者、版本、描述、安装量与所需接口权限。

发布技能到 Hub

不消耗 credit。元数据取自 SKILL.md frontmatter 的 name / title / description / category / version / permissions / author；ZIP 必须根目录直接包含 SKILL.md（只放在嵌套目录里会报错）。发布成功返回 package_url 与 package_sha256。

搜索技能（关键词 / 作者）

不消耗 credit。按关键词或作者搜索 Hub 上的技能。

检查更新并打印安装命令

本地命令，不消耗 credit。该命令不会自动升级，只打印需要执行的 npm 安装命令（npm install -g @weibo-ai/weibo-cli@<版本>），需自行执行。

无参数

显示当前 CLI 版本

本地命令，不消耗 credit。输出当前安装的 CLI 版本号。

无参数

创建付费专栏

创建付费专栏。需先开通V+付费专栏权限，如未开通请访问 https://videoalbum.e.weibo.com/signup/standard 申请。定价档位（单位分）：990/1900/2900/4900/6900/9900/12800，对应9.9/19/29/49/69/99/128元。60秒内同一用户最多5次请求。video_nums需3-100范围。创建成功返回collections_id。

删除专栏

删除指定专栏。已被购买过的专栏无法删除。需先开通V+付费专栏权限，如未开通请访问 https://videoalbum.e.weibo.com/signup/standard 申请。

查询专栏详情

查询指定专栏的详细信息，包括标题、价格、状态、封面图、分类等。需先开通V+付费专栏权限，如未开通请访问 https://videoalbum.e.weibo.com/signup/standard 申请。

查询专栏列表

查询当前用户的专栏列表，包含已发布和审核中的专栏。支持分页。需先开通V+付费专栏权限，如未开通请访问 https://videoalbum.e.weibo.com/signup/standard 申请。

更新专栏

更新专栏信息。注意：title/money/images/content/video_nums必须每次完整传，不支持部分更新。60秒内同一用户最多5次请求。money必须是约定价位之一。video_nums不能比当前已有章节数小。id参数传列表接口中的collections_id。需先开通V+付费专栏权限，如未开通请访问 https://videoalbum.e.weibo.com/signup/standard 申请。

查询发文配置

查询当前用户可用的付费类型（V+会员专栏、单篇付费、V+单篇付费等）和价格区间。发文前调用此接口确认用户能发什么类型的文章及价格范围。无需传入任何参数。

无参数

生成文章预览链接

提交文章内容生成预览链接，用户可在浏览器中打开预览链接查看发布后的效果。预览链接30分钟内有效，需用户登录微博后访问。同一用户重复提交会覆盖之前的预览数据。注意：预览接口标题长度限制为32字，与发文接口的64字不同。正文内容使用标准Markdown格式，支持标题/粗体/斜体/删除线/引用/有序无序列表/分割线/行内代码/代码块/链接/图片/表格/表情/转义字符/数学公式，不支持HTML标签/任务列表/脚注/TOC目录等。

发布文章

发布头条文章并同步发布短微博。一次调用同时发布文章和短微博，两者都发。支持免费文章、V+会员专栏、V+单篇付费、单篇付费四种类型。发布后不可撤销。5秒内同uid同内容重复提交会被去重。注意：follow_to_read、collection_id、非free付费三者最多出现1种。关联专栏发文时pay_type传free。正文内容使用标准Markdown格式，支持标题/粗体/斜体/删除线/引用/有序无序列表/分割线/行内代码/代码块/链接/图片/表格/表情/转义字符/数学公式，不支持HTML标签/任务列表/脚注/TOC目录等。

发布一条表态

删除一条表态

根据微博ID返回某条微博的赞列表

获取当前登录用户发出的评论列表

获取某个用户发出的评论列表

评论一条微博

删除一条评论

获取@当前登录用户的评论

获取@某人的评论

回复一条评论

返回一条微博的全部评论列表

获取当前登录用户发布的微博下的评论列表

批量获取评论内容

获取当前登录用户发出及收到的评论列表

获取某个用户发出和收到的评论列表

获取当前登录用户收到的评论列表

获取某个用户收到的评论列表

获取授权用户活跃或互动粉丝TOP20列表

获取某用户粉丝的年龄段、性别细分数据

获取当前登录用户的粉丝列表

获取用户粉丝的星座、兴趣标签和粉丝量级的细分数据

获取近7天转发或互动最多的粉丝TOP20（仅蓝V）

获取用户粉丝的地区细分数据

获取当前登录用户粉丝最近一周在线时段比例分布

获取某用户粉丝的关注来源

获取当前登录用户的粉丝每天增加和减少数量

获取最长近90天内每天取消关注该账户的用户数

获取当前登录用户的关注列表

微博热搜主榜

获取微博热搜主榜，返回热搜词、排名、搜索热度及跳转链接。可通过 count 指定返回条数，默认 50，最大 50。返回 cat 榜单标识、app_link 榜单 App 唤起地址、h5_link 榜单 H5 地址及 data 榜单列表。data 条目包含：id 排名（0 表示置顶词，置顶不是固定位）、word 搜索词、num 搜索热度、flag 搜索词标记（1 新、2 热、4 爆、16 沸、0 无标记）、app_query_link 搜索词 App 唤起地址、h5_query_link 搜索词 H5 地址、flag_link 标记图片地址。文档：https://open.weibo.com/wiki/C/2/search/hot_word/biz

搜索分类榜单

获取微博搜索分类榜单，按 category 单选榜单：1 文娱榜、2 社会榜、3 科技榜、4 acg榜、5 生活榜、6 体育榜。category 为必填字符串；count 为可选返回条数，默认 50，最大 50。返回 cat 榜单标识、app_link 榜单 App 唤起地址、h5_link 榜单 H5 地址及 data 榜单列表。data 条目包含：id 排名、word 搜索词、num 搜索热度、flag 搜索词标记（1 新、2 热、4 爆、16 沸、0 无标记）、app_query_link 搜索词 App 唤起地址、h5_query_link 搜索词 H5 地址、flag_link 标记图片地址。

搜索含某关键词的微博

搜用户搜索建议

将一个或多个短链接还原成原始的长链接

将一个或多个长链接转换成短链接

批量获取指定微博的转发数评论数喜欢数

批量获取指定授权微博的转发数、评论数、赞数、阅读数

删除微博信息

获取@当前登录用户的微博列表

获取@某人的微博

通过微博（评论、私信）MID获取其ID

通过微博（评论、私信）ID获取其MID

转发一条微博信息

返回一条微博的全部转发微博列表

获取当前登录用户发布的一条原创微博的最新转发微博

根据微博ID批量获取微博信息

返回近90天内发布的授权微博每天的被转发数、被评论数、被喜欢数、被点击数（区分短链、图片、视频点击）

发布一条微博信息

上传图片并发布一条微博

上传图片，返回图片id

发布一条带单/多图的微博（需要组合上传图片接口）

获取当前登录用户发布的微博

获取其他用户发布的微博

批量获取用户个人微博列表

获取当前登录用户的标签

批量获取用户标签

获取授权用户行为数据每日变化趋势

获取他人用户行为数据每日变化趋势

批量获取用户的粉丝数、关注数、微博数

获取某用户近90天每天的被喜欢数

获取当前登录用户信息

无参数

批量获取其他用户的基本信息

获取当前登录用户近90天每天的被点击数（区分短链、图片点击）、被阅读数、用户去重的被阅读数

综艺-待播榜

查询微博指数综艺待播榜，返回待播综艺的排名及指数。支持 program_type 筛选，取值来自配置接口 coming_program_type。支持实时榜、小时榜、日榜、周榜和月榜，默认查询当前小时榜；支持画像筛选和分页。所有业务请求参数均可选，通过 Query 传参。返回 data.result 榜单列表、data.total 总条数、data.pageIndex 当前页码、data.pageSize 每页大小、data.pageTotal 总页数，以及 data.ext.ranking_time_type 时间类型和 data.ext.ranking_time 榜单时间。榜单条目为节目维度，包含 sort 排名、trend 趋势（1 上升、0 持平、-1 下降）、index_value 指数值、id 节目 ID、name 节目名称、pic 封面图、official_uid 官方微博 UID、premiere_time 首播时间、end_time 完播时间、program_type 节目类型标签数组、platform 播放平台数组、actor_info 演员信息（uid、name、role_name）、dp_score 微博评分、subscribe_num 预约量、chart 指数趋势数据（dt 时间点、value 指数值）和 mapp_scheme 跳转 scheme。

综艺-热播榜

查询微博指数综艺热播榜，返回热播综艺的排名及指数。支持 program_type 筛选，取值来自配置接口 hot_program_type。支持实时榜、小时榜、日榜、周榜和月榜，默认查询当前小时榜；支持画像筛选和分页。所有业务请求参数均可选，通过 Query 传参。返回 data.result 榜单列表、data.total 总条数、data.pageIndex 当前页码、data.pageSize 每页大小、data.pageTotal 总页数，以及 data.ext.ranking_time_type 时间类型和 data.ext.ranking_time 榜单时间。榜单条目为节目维度，包含 sort 排名、trend 趋势（1 上升、0 持平、-1 下降）、index_value 指数值、id 节目 ID、name 节目名称、pic 封面图、official_uid 官方微博 UID、premiere_time 首播时间、end_time 完播时间、program_type 节目类型标签数组、platform 播放平台数组、actor_info 演员信息（uid、name、role_name）、dp_score 微博评分、subscribe_num 预约量、chart 指数趋势数据（dt 时间点、value 指数值）和 mapp_scheme 跳转 scheme。

剧集-待播榜

查询微博指数剧集待播榜，返回待播剧集的排名及指数。支持 program_type 筛选，取值来自配置接口 coming_program_type。支持实时榜、小时榜、日榜、周榜和月榜，默认查询当前小时榜；支持画像筛选和分页。所有业务请求参数均可选，通过 Query 传参。返回 data.result 榜单列表、data.total 总条数、data.pageIndex 当前页码、data.pageSize 每页大小、data.pageTotal 总页数，以及 data.ext.ranking_time_type 时间类型和 data.ext.ranking_time 榜单时间。榜单条目为节目维度，包含 sort 排名、trend 趋势（1 上升、0 持平、-1 下降）、index_value 指数值、id 节目 ID、name 节目名称、pic 封面图、official_uid 官方微博 UID、premiere_time 首播时间、end_time 完播时间、program_type 节目类型标签数组、platform 播放平台数组、actor_info 演员信息（uid、name、role_name）、dp_score 微博评分、subscribe_num 预约量、chart 指数趋势数据（dt 时间点、value 指数值）和 mapp_scheme 跳转 scheme。

剧集-热播榜

查询微博指数剧集热播榜，返回热播剧集的排名及指数。支持 program_type 筛选，取值来自配置接口 hot_program_type。支持实时榜、小时榜、日榜、周榜和月榜，默认查询当前小时榜；支持画像筛选和分页。所有业务请求参数均可选，通过 Query 传参。返回 data.result 榜单列表、data.total 总条数、data.pageIndex 当前页码、data.pageSize 每页大小、data.pageTotal 总页数，以及 data.ext.ranking_time_type 时间类型和 data.ext.ranking_time 榜单时间。榜单条目为节目维度，包含 sort 排名、trend 趋势（1 上升、0 持平、-1 下降）、index_value 指数值、id 节目 ID、name 节目名称、pic 封面图、official_uid 官方微博 UID、premiere_time 首播时间、end_time 完播时间、program_type 节目类型标签数组、platform 播放平台数组、actor_info 演员信息（uid、name、role_name）、dp_score 微博评分、subscribe_num 预约量、chart 指数趋势数据（dt 时间点、value 指数值）和 mapp_scheme 跳转 scheme。

剧集-热议角色榜

查询微博指数剧集热议角色榜，返回角色的排名及指数。支持实时榜、小时榜、日榜、周榜和月榜，默认查询当前小时榜；支持画像筛选和分页。所有业务请求参数均可选，通过 Query 传参。返回 data.result 榜单列表、data.total 总条数、data.pageIndex 当前页码、data.pageSize 每页大小、data.pageTotal 总页数，以及 data.ext.ranking_time_type 时间类型和 data.ext.ranking_time 榜单时间。本接口不支持 program_type 参数。榜单条目为角色维度，包含 sort 排名、trend 趋势（1 上升、0 持平、-1 下降）、index_value 指数值、role_id 角色 ID、role_name 角色名称、role_img 角色图片、role_avatar 角色头像、role_uid 角色微博 UID、role_status 角色状态（1 在线、2 完播）、actor_uid 演员微博 UID、actor_name 演员名称、program_name 所属节目名称、chart 指数趋势数据（dt 时间点、value 指数值）和 mapp_scheme 跳转 scheme。