supsub-mp

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。

# 同步搜索（实测约 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_SEARCH_TIMEOUT 错误退出，错误体里带 data.searchId，提示信息形如 30 秒内未完成，可重试 supsub mp search 或取消任务: supsub mp search-cancel <searchId>。

⚠️ 超时处理：CLI 不提供恢复型查询命令。遇到超时时，用户只有两条路径 —— 重新跑 supsub mp search <name>，或调用 supsub mp search-cancel <searchId> 取消那个孤儿任务后再试。

---

Cancel a running search task

supsub mp search-cancel <searchId>

<searchId> 来自上一次 supsub mp search 在超时分支返回的错误数据（JSON 模式：{"success":false,"error":{"code":"MP_SEARCH_TIMEOUT","data":{"searchId":"..."}}} 这一类的形态由 dieWith 和 output() 处理；表格模式下错误字符串里会直接带 searchId）。