social-cli

name	social-cli
description	Social media browser automation reference — full command & parameter docs for all supported platforms (小红书, 抖音, B站, X/Twitter, 视频号, Boss直聘). Activate when the user asks about social media shortcuts, wants to automate social platforms, "怎么发小红书", "帮我点赞", "搜索抖音", "post to twitter", "bilibili comment", "发视频号", "Boss直聘候选人", etc.

Social CLI — Browser Shortcut Reference

Pre-built YAML browser automations for social media platforms. Executed via the Browser panel or by asking the agent directly.

Prerequisite: Chrome must be running with --remote-debugging-port=9222. Use the Browser panel's "Launch Chrome" button or run manually.

Login: Each platform requires you to be logged in. On first use, log in manually in the launched Chrome. Sessions (cookies) are cached in ~/.clawfirm/sessions/.

---

小红书 (Xiaohongshu) — xhs.yaml

Login URL: https://www.xiaohongshu.com Session cookie: web_session

search — 搜索笔记

Param	Type	Required	Description
keyword	string	yes	搜索关键词

Returns: title, author, link (笔记列表)

Example: 搜索小红书 AI法律

---

hot — 热门推荐

No parameters.

Returns: title, author, link (探索页热门笔记)

Example: 看看小红书热门

---

like — 点赞/取消点赞

Param	Type	Required	Description
url	string	yes	笔记 URL

Returns: 操作 (点赞成功/取消点赞), 状态, 点赞数

Example: 点赞这篇小红书 https://www.xiaohongshu.com/explore/xxx

---

comment — 发表评论

Param	Type	Required	Description
url	string	yes	笔记 URL
text	string	yes	评论内容

Returns: 状态, 评论内容, 输入确认

Example: 评论小红书 https://www.xiaohongshu.com/explore/xxx 写得好！

---

post_video — 发布视频笔记

Param	Type	Required	Description
video	string	yes	本地视频文件路径 (绝对路径)
title	string	yes	笔记标题
desc	string	yes	笔记描述/正文

Returns: 状态, 标题, 描述, 跳转URL

Note: 上传后需等待转码完成 (最长 5 分钟)。自动点击"发布"按钮。

Example: 发小红书视频 /tmp/demo.mp4 标题"AI演示" 描述"看看这个AI"

---

post — 发布图文笔记

Param	Type	Required	Description
title	string	yes	笔记标题
content	string	yes	笔记正文

Returns: 状态, 标题, 正文, 跳转URL

Note: 通过小红书创作者平台发布。自动切换到"上传图文" tab，填写标题和正文后点击发布。

Example: 发小红书图文 标题"周末探店" 内容"超好吃的..."

---

抖音 (Douyin) — douyin.yaml

Login URL: https://www.douyin.com Session cookie: passport_csrf_token

search — 搜索视频

Param	Type	Required	Description
keyword	string	yes	搜索关键词

Returns: link, text (视频列表)

Example: 搜索抖音 猫咪日常

---

like — 点赞/取消点赞

Param	Type	Required	Description
url	string	yes	视频 URL

Returns: 操作 (点赞成功/取消点赞), 状态

Note: 使用键盘快捷键 z 触发点赞。

Example: 点赞抖音 https://www.douyin.com/video/xxx

---

comment — 发表评论

Param	Type	Required	Description
url	string	yes	视频 URL
text	string	yes	评论内容

Returns: 状态, 评论内容, 输入确认

Note: 抖音评论区使用 Draft.js 编辑器，通过 CDP keyboard_insert 逐字符输入，按 Enter 发送。

Example: 评论抖音 https://www.douyin.com/video/xxx 太搞笑了哈哈

---

follow — 关注作者

Param	Type	Required	Description
url	string	yes	视频 URL (从视频页关注作者)

Returns: 操作 (关注成功/已在关注中), 关注按钮消失

Example: 关注这个抖音作者 https://www.douyin.com/video/xxx

---

download — 下载视频/图文

Param	Type	Required	Description
url	string	yes	视频或图文 URL (支持分享短链 v.douyin.com)

Returns: 类型 (video/gallery), 作者, 描述, 作品ID, 下载状态

Note: 自动识别视频或图文。视频通过 video.currentSrc 获取 CDN 地址并触发浏览器下载；图文逐张下载。文件保存到 Chrome 默认下载目录。

Example: 下载抖音视频 https://v.douyin.com/LhdEZKD2H0Q/

---

post — 发布视频

Param	Type	Required	Description
video	string	yes	本地视频文件路径 (绝对路径)
title	string	yes	作品标题
desc	string	yes	作品描述

Returns: 状态, 标题, 描述, 跳转URL

Note: 通过抖音创作者平台上传。自动等待上传完成 (最长 5 分钟)，自动选择封面，跳过竖封面提示。

Example: 发布抖音视频 /tmp/vlog.mp4 "日常vlog" "今天去了..."

---

B站 (Bilibili) — bilibili.yaml

Login URL: https://www.bilibili.com Session cookie: SESSDATA

search — 搜索视频

Param	Type	Required	Description
keyword	string	yes	搜索关键词

Returns: link, title, up (视频列表)

Example: 搜索B站 编程教程

---

like — 点赞视频

Param	Type	Required	Description
url	string	yes	视频 URL

Returns: 操作 (点赞成功/取消点赞), 当前状态

Example: 点赞B站 https://www.bilibili.com/video/BVxxx

---

follow — 关注 UP 主

Param	Type	Required	Description
url	string	yes	视频 URL (从视频页关注UP主)

Returns: 操作 (关注/取消关注), 状态

Example: 关注这个UP主 https://www.bilibili.com/video/BVxxx

---

comment — 发表评论

Param	Type	Required	Description
url	string	yes	视频 URL
text	string	yes	评论内容

Returns: 状态, 评论内容, 输入确认

Note: B站评论区使用多层 Shadow DOM (bili-comments → bili-comment-box → bili-comment-rich-textarea)。通过 CDP Input.insertText 穿透 Shadow DOM 输入文字。

Example: 评论B站 https://www.bilibili.com/video/BVxxx 三连了！

---

reply — 回复评论

Param	Type	Required	Description
url	string	yes	视频 URL
text	string	yes	回复内容

Returns: 状态, 回复内容

Note: 自动点击第一条评论的"回复"按钮，在展开的回复框中输入并发送。同样使用 CDP Input.insertText 穿透 Shadow DOM。

Example: 回复B站评论 https://www.bilibili.com/video/BVxxx 说得对！

---

post — 投稿视频

Param	Type	Required	Description
video	string	yes	本地视频文件路径 (绝对路径)
title	string	yes	稿件标题
desc	string	yes	稿件简介

Returns: 状态, 标题, 描述, 页面URL

Note: 通过 B站创作中心上传。自动关闭弹窗 (开启通知、二创计划等)，等待上传转码完成 (最长 5 分钟)，使用 Quill 富文本编辑器填写简介，点击"立即投稿"。

Example: 投稿B站 /tmp/tutorial.mp4 "Go教程第1集" "从零开始学Go"

---

TikTok — tiktok.yaml

Login URL: https://www.tiktok.com Session cookie: sessionid

search — 搜索视频（爆款采集）

Param	Type	Required	Description
keyword	string	yes	搜索关键词

Returns: JSON 数组，每条含 rank, link, desc, author, views

Note: 自动滚动加载更多结果。使用 video 专项搜索 (/search/video) 以获取视频类结果。返回结构化互动数据供爆款分析使用。

Example: 搜索TikTok cooking recipe

---

hot — 热门/趋势视频

No parameters.

Returns: JSON 数组，每条含 rank, link, desc, author, views (TikTok Explore 页热门视频)

Note: 采集 TikTok Explore 页面的推荐趋势视频，自动滚动加载更多内容。

Example: 看看TikTok热门

---

download — 下载视频

Param	Type	Required	Description
url	string	yes	视频 URL (tiktok.com/@user/video/xxx)

Returns: 作者, 描述, 视频ID, 互动数据 (likes/comments/shares/saves JSON), 下载状态

Note: 先尝试通过 video.currentSrc 直接下载；若为 blob URL 则从页面 __NEXT_DATA__ 提取 playAddr/downloadAddr。互动数据含点赞、评论、分享、收藏四项指标，可直接用于爆款分析。

Example: 下载TikTok视频 https://www.tiktok.com/@user/video/123456

---

like — 点赞/取消点赞

Param	Type	Required	Description
url	string	yes	视频 URL

Returns: 操作 (点赞成功/取消点赞), 当前状态

Example: 点赞TikTok https://www.tiktok.com/@user/video/xxx

---

comment — 发表评论

Param	Type	Required	Description
url	string	yes	视频 URL
text	string	yes	评论内容

Returns: 状态, 评论内容

Example: 评论TikTok https://www.tiktok.com/@user/video/xxx Love this!

---

follow — 关注用户

Param	Type	Required	Description
url	string	yes	视频 URL (从视频页关注作者)

Returns: 操作 (关注成功/取消关注)

Example: 关注TikTok作者 https://www.tiktok.com/@user/video/xxx

---

post — 发布视频

Param	Type	Required	Description
video	string	yes	本地视频文件路径 (绝对路径)
title	string	no	视频标题
desc	string	yes	视频描述/文案
tags	string	no	逗号分隔话题标签 (最多5个)
cover_h	string	no	横版封面图路径
cover_v	string	no	竖版封面图路径

Returns: 状态, 标题, 描述, 跳转URL

Note: 通过 TikTok Studio 上传。自动等待上传完成（最长 10 分钟），支持 hashtag 标签系统联想选择，支持横竖版封面上传。

Example: 发TikTok视频 /tmp/vlog.mp4 "Day in my life" "Morning routine vlog" "morning,routine,vlog"

---

X/Twitter — x.yaml

Login URL: https://x.com Session cookie: auth_token

search — 搜索推文

Param	Type	Required	Description
keyword	string	yes	搜索关键词

Returns: text, user, link, time (推文列表, 按热度排序)

Example: 搜索推特 Claude AI

---

like — 点赞/取消点赞

Param	Type	Required	Description
url	string	yes	推文 URL

Returns: 操作 (点赞成功/取消点赞), 状态

Example: 点赞这条推特 https://x.com/user/status/xxx

---

reply — 回复推文

Param	Type	Required	Description
url	string	yes	推文 URL
text	string	yes	回复内容

Returns: 状态, 回复内容, 输入确认

Example: 回复推特 https://x.com/user/status/xxx Great work!

---

post — 发推

Param	Type	Required	Description
text	string	yes	推文内容

Returns: 状态, 内容, 输入确认

Example: 发一条推特 Just shipped a new feature!

---

retweet — 转推

Param	Type	Required	Description
url	string	yes	推文 URL

Returns: 状态, URL

Example: 转推 https://x.com/user/status/xxx

---

post_video — 发推 + 视频

Param	Type	Required	Description
video	string	yes	本地视频文件路径 (绝对路径)
text	string	yes	推文内容

Returns: 状态, 推文内容, 视频附件, 操作

Note: 通过 x.com/compose/post 上传视频。自动等待上传处理完成 (进度条消失 + 附件预览出现，最长 5 分钟)。上传完成后需手动确认点击 Post 按钮发布。

Example: 发推带视频 /tmp/demo.mp4 Check out this demo!

---

post_media — 发推 + 媒体 (图片/视频)

Param	Type	Required	Description
text	string	yes	推文内容
media	string	yes	本地文件路径 (视频或图片，绝对路径)

Returns: 状态, 推文内容, 媒体已上传, 操作

Note: 通用媒体上传，支持图片和视频。通过 x.com/compose/post 上传。上传完成后需手动确认点击 Post 按钮发布。

Example: 发推带图片 /tmp/screenshot.png Look at this!

---

视频号 (WeChat Channels) — channels.yaml

Login URL: https://channels.weixin.qq.com Session cookie: myuin

Note: 视频号助手使用无界微前端 (wujie-app)，所有 DOM 在 shadow root 内。

post — 发布视频

Param	Type	Required	Description
video	string	yes	本地视频文件路径 (绝对路径)
title	string	yes	短标题 (6-16 字符)
desc	string	yes	视频描述

Returns: 状态, 标题, 描述, 跳转URL

Note: 通过视频号助手上传。自动关闭弹窗，等待上传完成 (最长 10 分钟)，在 shadow DOM 内填写描述和短标题，点击发表。

Example: 发布视频号 /tmp/vlog.mp4 "周末日常" "记录一下周末去公园"

---

list — 内容列表

No parameters.

Returns: 内容列表 (最近 10 条发布记录的标题)

Example: 看看视频号发布列表

---

Boss直聘 (Zhipin) — zhipin.yaml

Login URL: https://www.zhipin.com Session cookie: wt2

chat_stats — 聊天统计

No parameters.

Returns: 总会话数, 未读会话数, 未读明细 (姓名, 应聘职位, 未读条数, 最新消息)

Note: 自动滚动加载所有聊天记录后统计。

Example: Boss直聘聊天统计

---

candidates — 候选人列表

No parameters.

Returns: 姓名, 应聘职位, 最新消息 (所有候选人)

Note: 自动滚动加载所有聊天记录后提取。

Example: 看看Boss直聘有哪些候选人

---

币安广场 (Binance Square) — binance-square.yaml

Login URL: https://www.binance.com/en/square Session cookie: p20t

search — 搜索帖子

Param	Type	Required	Description
keyword	string	yes	搜索关键词

Returns: text, author, link

Example: 搜索币安广场 BTC ETF

---

like — 点赞帖子

Param	Type	Required	Description
url	string	yes	帖子 URL

Returns: 操作 (点赞成功/取消点赞), 状态

Example: 点赞币安广场 https://www.binance.com/en/square/post/xxx

---

comment — 发表评论

Param	Type	Required	Description
url	string	yes	帖子 URL
text	string	yes	评论内容

Returns: 状态, 评论内容, 输入确认

Example: 评论币安广场 https://www.binance.com/en/square/post/xxx 分析得很好，NFA

---

post — 发布短帖

Param	Type	Required	Description
text	string	yes	帖子内容（≤1000字符，支持 #标签 和 $代币）

Returns: 状态, 内容, 页面URL

Example: 发币安广场短帖 BTC突破新高，三个关键指标 #BTC $BTC NFA/DYOR

---

post_image — 发布图文帖

Param	Type	Required	Description
text	string	yes	帖子文字
image	string	yes	本地图片路径（绝对路径）

Returns: 状态, 内容, 页面URL

Example: 发币安广场图文 "K线技术分析" /tmp/btc-chart.png

---

post_video — 发布视频帖

Param	Type	Required	Description
video	string	yes	本地视频文件路径（绝对路径，MP4）
text	string	yes	视频描述（≤1000字符）

Returns: 状态, 描述, 页面URL

Note: 上传后等待转码完成（最长5分钟）。视频推荐 1080p MP4，≤60分钟。

Example: 发币安广场视频 /tmp/analysis.mp4 "BTC周度分析 #BTC $BTC"

---

post_long — 发布长文章

Param	Type	Required	Description
title	string	yes	文章标题（≤100字符）
content	string	yes	文章正文（≤20000字符，支持富文本）

Returns: 状态, 标题, 页面URL

Example: 发币安广场长文 "以太坊 Dencun 升级全解析" "正文内容..."

---

Command Summary

Platform	Command	Args	Description
小红书	search	keyword	搜索笔记
小红书	hot	—	热门推荐
小红书	like	url	点赞/取消
小红书	comment	url, text	发表评论
小红书	post_video	video, title, desc	发布视频
小红书	post	title, content	发布图文
抖音	search	keyword	搜索视频
抖音	like	url	点赞/取消
抖音	comment	url, text	发表评论
抖音	follow	url	关注作者
抖音	download	url	下载视频/图文
抖音	post	video, title, desc	发布视频
B站	search	keyword	搜索视频
B站	like	url	点赞视频
B站	follow	url	关注UP主
B站	comment	url, text	发表评论
B站	reply	url, text	回复评论
B站	post	video, title, desc	投稿视频
TikTok	search	keyword	搜索视频（爆款采集）
TikTok	hot	—	热门/趋势视频
TikTok	download	url	下载视频+互动数据
TikTok	like	url	点赞/取消
TikTok	comment	url, text	发表评论
TikTok	follow	url	关注用户
TikTok	post	video, title, desc, tags, cover_h, cover_v	发布视频
X	search	keyword	搜索推文
X	like	url	点赞/取消
X	reply	url, text	回复推文
X	post	text	发推
X	retweet	url	转推
X	post_video	video, text	发推+视频
X	post_media	text, media	发推+媒体
视频号	post	video, title, desc	发布视频
视频号	list	—	内容列表
Boss直聘	chat_stats	—	聊天统计
Boss直聘	candidates	—	候选人列表
币安广场	search	keyword	搜索帖子
币安广场	like	url	点赞帖子
币安广场	comment	url, text	发表评论
币安广场	post	text	发布短帖
币安广场	post_image	text, image	发布图文帖
币安广场	post_video	video, text	发布视频帖
币安广场	post_long	title, content	发布长文章