SuperAPI AI 工具集

supsub-search

写作与研究

查看项目

更新于 10-16 06:51

技能介绍

用途:在 SupSub 中做全文搜索,覆盖订阅源(公众号、网站)和文章正文,可按类型缩小范围。

主要能力:命令 supsub search <keyword> [--type <ALL|MP|WEBSITE|CONTENT>],--type 默认 ALL(源+文章),MP 只搜公众号源,WEBSITE 只搜网站源,CONTENT 只搜文章正文。加 -o json 返回结构化结果,形如 {"success":true,"data":{"results":[...],"recommendations":[...],"prompts":[...]}};results 为异质数组,先看 type(SOURCE 或 CONTENT)再访问 data 字段。文章结果含 contentId、title、summary、url、publishedAtText(YYYY-MM-DD HH:mm,可直接用于排序展示)等;SOURCE 结果无发布时间。

使用方式:先安装并登录。安装可用 curl -fsSL https://raw.githubusercontent.com/SupSub-AI/supsub-cli/master/scripts/install.sh | bash,或 npm i -g @supsub/cli / pnpm add -g @supsub/cli。用 supsub auth status 确认已登录,未登录先 supsub auth login;未授权(exit 2)时直接运行 supsub auth login 打开浏览器授权并重试,无浏览器环境回退为 SUPSUB_NO_BROWSER=1 supsub auth login。

范围判断:用户说「搜一下 X」「查 X 相关文章」「全文搜 X」走本技能全站搜索;说「看一下最近 X 的内容」「X 更新了吗」属浏览意图,应先比对订阅范围(supsub sub list -o json 与 supsub focus list -o json,按 name/title 忽略大小写包含匹配),命中则用 supsub sub contents --source-id <sid> --type <t> 或 supsub focus contents --id <fid>,未命中再执行 supsub search <X> 全站搜索并说明未订阅该源。

限制:CLI 一次最多返回 10 条结果(后端默认 pageSize=10),不支持翻页,需调整关键词;目前没有按 contentId 取文章详情的命令,需通过 supsub sub contents 在源内浏览。退出码:0 OK,1 业务错误,2 UNAUTHORIZED,64 INVALID_ARGS,10 网络错误,11 服务端错误。