supsub-mplisted
Install: claude install-skill SupSub-AI/supsub-cli
# supsub-mp Skill
搜索微信公众号(异步任务,CLI 默认同步等待最长 30 秒),以及取消正在执行的搜索任务。拿到 `mpId` 后下一步是 `supsub sub add --mp-id <mpId>`(见 `supsub-sub` skill)—— `mp search` 返回的 `mpId` 是微信原生 base64 字符串,**不能**塞给 `--source-id`(那是 supsub 内部正整数 ID,不同 ID 空间)。
## Prerequisites
- 安装:`curl -fsSL https://raw.githubusercontent.com/SupSub-AI/supsub-cli/master/scripts/install.sh | bash`(native 安装,装到 `~/.local`、支持后台自动更新);或包管理器 `npm i -g @supsub/cli` / `pnpm add -g @supsub/cli`
- 已登录:`supsub auth status` 显示 Authenticated(首次使用先 `supsub auth login`)
- **未授权(exit 2 / UNAUTHORIZED)时不要止步于「你未登录」**:直接运行 `supsub auth login` 为用户打开浏览器授权(命令会自动打开浏览器并阻塞等待授权,请用足够长的超时,如 10 分钟;用户只需在浏览器点确认,无需在终端输入任何内容),授权成功后重试原命令。无浏览器 / 无头环境再回退为提示用户 `SUPSUB_NO_BROWSER=1 supsub auth login`。
## Commands
### Search 公众号 (async, auto-poll)
```
supsub mp search <name>
```
`<name>` 是公众号名称关键词(建议加引号)。命令内部流程:
1. `POST /api/mps/search-tasks` 创建异步任务,得到 `searchId`。
2. CLI 每 2s 轮询一次任务状态,**最多 30 秒**。
3. 后端会在多次轮询里 **逐条** 返回候选公众号,CLI 自动累计去重。
4. 收到 `finished=true` 后,把所有候选作为结果一次性输出。
5. 30 秒未完成 → 退出并返回 `searchId`,附带提示信息。
每个候选字段:`mpId`, `name`, `img`, `description`, `isSubscribed`。
```bash
# 同步搜索(实测约 15-30 秒,工具超时请设到 60s 以上)
supsub mp search "机器之心"
# JSON
supsub mp search "机器之心" -o json
```
JSON shape (成功):`{"success":true,"data":[{"mpId":"...","name":"...","img":"...","description":"...","isSubscribed":false}, ...]}`
> 返回的是**一批候选**(实测「机器之心」10 条、「阮一峰」5 条),不是精确匹配的单条。见下方 Agent Usage Notes 的选号约束。
**未找到**:以 `MP_NOT_FOUND` 错误退出(非 0 exit code)。
**超时**:以 `MP_SEA