# Social CLI

> 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.

- Skill: `npc-live/social-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add npc-live/social-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/npc-live/social-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: npc-live (https://skillmd.com/u/npc-live)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/npc-live/social-cli

---


# 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` | 发布长文章 |