← ClaudeAtlas

supsub-mplisted

SupSub 微信公众号发现 —— 仅当用户想查找 / 发现一个微信公众号「本身」(通常为了拿到 mpId 后订阅它)时使用。匹配「搜公众号 X」「找 X 这个公众号」「查 X 公众号」「想订阅 X 公众号但不知道 ID」「discover / find a WeChat MP account」。⚠️ 不要用于搜索文章正文 / 内容 / 关键词相关的文章 —— 那种意图(如「搜一下 X 相关的内容」「找 X 相关的文章」)必须走 supsub-search。也包含取消正在跑的公众号搜索任务。
SupSub-AI/supsub-cli · ★ 5 · AI & Automation · score 75
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