
Smart Search
- 14.3k installs
- 27.6k repo stars
- Updated July 30, 2026
- jackwener/opencli
Smart Search is an OpenCLI skill enabling AI agents to perform search across websites through browser automation.
About
Smart Search is a skill within OpenCLI that enables agent-driven search across websites and platforms. It provides search command adapters that work through the OpenCLI browser bridge. Developers use it when they need to automate search workflows or delegate search tasks to AI agents.
- Part of OpenCLI's adapter ecosystem for site-specific commands
- Enables smart search capabilities across multiple platforms
- Browser-backed search automation through logged-in sessions
Smart Search by the numbers
- 14,324 all-time installs (skills.sh)
- +299 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #26 of 550 CLI & Terminal skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 3, 2026 (Skillselion catalog sync)
smart-search capabilities & compatibility
- Capabilities
- web search · browser automation
- Works with
- chrome
- Use cases
- web search
- Runs
- Runs locally
npx skills add https://github.com/jackwener/opencli --skill smart-searchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 14.3k |
|---|---|
| repo stars | ★ 27.6k |
| Security audit | 2 / 3 scanners passed |
| Last updated | July 30, 2026 |
| Repository | jackwener/opencli ↗ |
How do you route agent web research to one OpenCLI source?
Enable AI agents to perform smart search across websites using OpenCLI browser integration.
Who is it for?
Agents needing to search websites and extract results
Skip if: Developers who already specify an exact search site or need guaranteed multi-source consensus from every provider.
When should I use this skill?
Automating search workflows or delegating search to AI
What you get
A single routed OpenCLI search command, chosen registry source, and context-appropriate query phrasing.
- Routed OpenCLI search command
- Source-specific query phrasing guidance
By the numbers
- Covers 3 primary AI search sources: grok, doubao, and gemini
- Uses a 4-step OpenCLI workflow: list registry, check site help, check command help, then search
Files
智能搜索路由器
根据话题和场景,将查询路由到最佳的 opencli 搜索源。此 skill 的核心目标不是记忆命令,而是先定位数据源,再让 Agent 通过 opencli 自己读取实时帮助,避免文档漂移。
强制预检
每次使用前,必须先做下面两步:
- 运行
opencli list -f yaml - 用 live registry 确认候选站点是否存在,并检查
strategy、browser、domain
选定站点后,必须再做下面两步:
- 运行
opencli <site> -h查看该站点有哪些子命令 - 若已锁定某个子命令,再运行
opencli <site> <command> -h查看参数、输出列、策略
不要在 skill 文档里硬编码参数或假设命令签名;以 opencli ... -h 的实时输出为准。
主路由规则
只使用这一条规则,不再维护多套优先级:
1. 当用户明确指定网站、平台或数据源时,直接使用对应网站。 2. 当用户没有指定网站时,优先只选择一个 AI 源:grok、doubao、gemini 三选一。 3. 当 AI 返回内容不足、缺少原始数据、需要权威佐证或需要垂直结果时,再补充 1-2 个专用源。
单题预算与频率限制
把“单个用户问题”理解为同一意图链路下的一次问题求解;同一轮追问、澄清、补充条件,若核心问题未变,仍算同一题。
先建立一份站点调用台账。每次真正执行搜索命令后,立刻更新:
sitequerycountstatus
计数规则:
opencli list -f yaml、opencli <site> -h、opencli <site> <command> -h属于预检与帮助,不计入搜索次数- 一次真正的
opencli <site> ...搜索/查询执行,计为该站点 1 次调用 - 同站点因为报错、超时、验证码、反爬、登录态异常而失败,也算 1 次调用,不要无限重试
频率上限:
- AI 站点硬限制:同一题内,每个 AI 站点最多调用 1 次
- 默认策略仍然是只选 1 个 AI 站点,不要把多个 AI 站点串成常规流程
- 只有当用户明确要求比较多个 AI 站点时,才可以额外调用其他 AI 站点;但每个被点名的 AI 站点仍然最多 1 次
- 非 AI 站点默认最多调用 2 次
- 非 AI 站点第 2 次调用必须有明确理由,例如第一次结果过宽,需要加时间、地区、类别、排序或关键词限定
- 非 AI 站点不要进行第 3 次调用;若信息仍不足,停止扩搜并明确说明缺口
触发限频后的处理:
- 记录:「已跳过:<site> 达到频率上限」
- 优先改用其他同类站点
- 若没有合适替代源,则直接基于已收集信息回答,并说明覆盖范围与缺口
查询结束汇报
每次查询结束后,回答末尾必须追加一段简短的“搜索摘要”,至少包含下面三项:
- 使用了什么网站搜索
- 每个网站搜了什么词
- 每个网站搜了几次
如果有被限频跳过的站点,也要明确写出。
建议使用下面的固定格式:
搜索摘要
- 网站:<site1> | 查询词:<term1> | 次数:<n>
- 网站:<site2> | 查询词:<term2>;<term3> | 次数:<n>
- 已跳过:<site3>,原因:达到频率上限AI 源选择
grok
适合实时讨论、英文互联网舆论、Twitter/X 语境、热点追踪。
doubao
适合中文语境、字节抖音生态、生活方式内容、中文热点与泛中文问答。
gemini
适合全球网页、英文资料、通用信息检索、背景综述。
如果用户没有指定网站,默认先判断语言和语境,再从这三个里只选一个。
一旦某个 AI 站点已经执行过一次真实查询,就不要在同一题里改写关键词后再次调用该 AI 站点。若答案不足,优先补专用源,不要反复追打同一个 AI 站点。
AI 查询词建议
当使用 AI 源时,不要只丢一个过短关键词。优先构造成“主题 + 目标 + 限定条件”的查询。
- 主题
用户真正要查的对象、事件、产品、人物、公司、技术名词。
- 目标
想要什么结果,例如总结、对比、原因、趋势、推荐、原始线索。
- 限定条件
语言、地区、时间范围、平台范围、受众、价格带、岗位地点、是否要引用原始来源。
优先使用下面这种表达方式:
<主题> + <你要回答的问题><主题> + <时间范围/地区/语言><主题> + <平台或来源范围><主题> + <输出要求>
避免只输入:
- 单个名词
- 没有时间范围的热点问题
- 没有地区限制的购物、求职、旅游问题
- 没有平台限制的社交媒体问题
专用源补充时机
当出现以下任一情况时,再补充专用源:
- AI 给出的是摘要,但你需要原始帖子、原始视频、原始商品或原始职位结果
- AI 覆盖面不足,漏掉垂直站点信息
- 需要更高权威性或更强领域相关性
- 用户明确要求“从某个平台找”
单次查询通常控制在 1 个 AI 源 + 1 到 2 个专用源,避免结果过载。
处理不可用的源
当站点不可用时:
- 不要因为单个源失败而中止整个搜索
- 记录:「已跳过:<site> 不可用」
- 回退到同类其他站点,或回退到一个 AI 源
- 始终以
opencli list -f yaml与opencli <site> -h的实际结果为准
不要假设任何站点“绝对可用”。即使是公开站点,也以当前环境中的 live help 和执行结果为准。
参考文件
根据需要读取对应文件:
- `references/sources-ai.md` — AI 默认源
- `references/sources-tech.md` — 技术 / 学术
- `references/sources-social.md` — 社交媒体
- `references/sources-media.md` — 媒体 / 娱乐
- `references/sources-info.md` — 资讯 / 知识
- `references/sources-shopping.md` — 购物
- `references/sources-travel.md` — 旅游
- `references/sources-other.md` — 其他垂直源
只读与当前查询相关的文件,无需全部加载。
AI 默认源
当用户没有明确指定网站时,先在 grok、doubao、gemini 中选择一个,不要一开始并行跑多个 AI 源。
使用规则
1. 先运行 opencli list -f yaml 2. 确认 grok、doubao、gemini 哪些在当前 registry 中可用 3. 运行 opencli <site> -h 4. 锁定具体子命令后,再运行 opencli <site> <command> -h
路由建议
grok
- 适用:实时热点、Twitter/X 语境、英文互联网讨论、舆论与趋势
- 补充源常见去向:
twitter、reddit、reuters、google - 搜索词建议:
- 加上时间范围,例如“today / this week”
- 加上平台范围,例如“on X”, “from social posts”
- 加上目标,例如“latest reactions”, “main viewpoints”, “key claims”
- 示例:
OpenAI latest reactions on X this weekTSLA earnings main viewpoints on social media April 2026Nintendo Switch 2 rumors latest discussion on X
doubao
- 适用:中文语境、国内热点、生活方式、字节生态、中文泛问答
- 补充源常见去向:
xiaohongshu、weibo、zhihu、bilibili、36kr - 搜索词建议:
- 加上中文场景限定,例如“中文讨论”“国内用户”“小红书/微博语境”
- 加上需求目标,例如“帮我总结”“给我对比”“提取推荐理由”
- 加上人群或用途,例如“适合新手”“预算 500 元内”“上海求职”
- 示例:
2026年MacBook Air值得买吗 中文讨论里主要观点是什么上海 AI 产品经理招聘趋势 近一个月中文信息总结敏感肌防晒推荐 中文用户常提到的优缺点
gemini
- 适用:全球网页、英文资料、背景综述、通用检索
- 补充源常见去向:
google、wikipedia、arxiv、stackoverflow - 搜索词建议:
- 加上主题类型,例如“overview”, “comparison”, “background”, “best sources”
- 加上范围限定,例如地区、时间、语言、行业
- 加上结果形式,例如“with sources”, “compare pros and cons”, “official guidance”
- 示例:
MCP overview and official guidance with sourcesbest budget travel destinations in Japan April 2026 compare pros and consTypeScript decorators current status official sources
补充原则
- 先用一个 AI 源拿到初步答案
- 若答案缺少原始数据、垂直结果或权威来源,再补 1-2 个专用源
- 不要把 AI 默认源当成命令签名的事实来源;命令细节始终以
opencli ... -h为准
通用写法模板
可直接按下面模板构造 AI 查询:
- 热点/新闻:
<事件> + 最新进展 + <时间范围> + <地区/平台>
- 对比/推荐:
<对象A> vs <对象B> + <关注维度> + <人群/预算/用途>
- 中文社区:
<主题> + 中文讨论里主要观点 + <时间范围>
- 全球资料:
<主题> + overview/background + with sources
- 求职:
<岗位> + <城市/国家> + market trends/hiring + <时间范围>
- 购物:
<商品> + reviews/price/value + <地区/预算>
资讯 / 知识
用于新闻、百科、通用知识、中文科技资讯。
站点
- 适用:通用网页搜索、跨站点兜底
- 使用前先运行:
opencli google -h
wikipedia
- 适用:名词解释、背景知识、历史事实
- 使用前先运行:
opencli wikipedia -h
reuters
- 适用:国际新闻、事实性报道
- 使用前先运行:
opencli reuters -h
- 适用:微博热点、话题、中文舆论
- 使用前先运行:
opencli weibo -h
36kr
- 适用:中文科技、创业、融资资讯
- 使用前先运行:
opencli 36kr -h
substack
- 适用:newsletter、作者订阅内容、长文
- 使用前先运行:
opencli substack -h
路由提示
- 背景知识与定义,优先
wikipedia - 通用网页与跨站信息,优先
google - 国际新闻优先
reuters - 中文科技资讯优先
36kr - 当 AI 回答过于泛化时,用这些源补充事实和链接
媒体 / 娱乐
用于视频、电影、剧集、音乐、播客、内容平台搜索。
站点
bilibili
- 适用:中文视频、教程、评测、UP 主内容
- 使用前先运行:
opencli bilibili -h
youtube
- 适用:英文视频、教程、评测、访谈
- 使用前先运行:
opencli youtube -h
tiktok
- 适用:短视频、热点、娱乐内容
- 使用前先运行:
opencli tiktok -h
imdb
- 适用:电影、剧集、演员、评分
- 使用前先运行:
opencli imdb -h
douban
- 适用:中文电影、书籍、音乐口碑与评分
- 使用前先运行:
opencli douban -h
spotify
- 适用:歌曲、歌手、专辑
- 使用前先运行:
opencli spotify -h
apple-podcasts
- 适用:播客节目、播客搜索
- 使用前先运行:
opencli apple-podcasts -h
medium
- 适用:长文、技术博客、设计与产品文章
- 使用前先运行:
opencli medium -h
路由提示
- 用户只说“找视频/影评/播客/文章”,先按内容形态选站点
- 用户没有指定站点时,可先用
doubao、grok或gemini做一轮粗检索,再补媒体站点拿原始结果
其他垂直源
用于求职、金融、书籍、词典等不适合归入前述分类的场景。
站点
- 适用:全球职位、英文岗位、跨国公司招聘
- 使用前先运行:
opencli linkedin -h
boss
- 适用:国内职位搜索、招聘与岗位信息
- 使用前先运行:
opencli boss -h
xueqiu
- 适用:股票、金融讨论、行情相关线索
- 使用前先运行:
opencli xueqiu -h
weread
- 适用:中文书籍搜索与书单线索
- 使用前先运行:
opencli weread -h
dictionary
- 适用:英文词义、基础词典查询
- 使用前先运行:
opencli dictionary -h
sinablog
- 适用:较旧的中文博客内容
- 使用前先运行:
opencli sinablog -h
路由提示
- 求职:全球优先
linkedin,国内优先boss - 金融:优先
xueqiu - 书籍:中文优先
weread - 英文单词定义:优先
dictionary
购物
用于商品搜索、价格、好价、口碑与区域电商结果。
站点
amazon
- 适用:全球商品搜索、价格参考、英文电商
- 使用前先运行:
opencli amazon -h
smzdm
- 适用:国内好价、优惠、导购、商品讨论
- 使用前先运行:
opencli smzdm -h
coupang
- 适用:韩国电商商品搜索
- 使用前先运行:
opencli coupang -h
douban
- 适用:图书、影视、音乐类口碑补充,不是标准电商,但可用于消费决策补充
- 使用前先运行:
opencli douban -h
路由提示
- 用户指定平台时直接使用该平台
- 未指定平台时,全球商品优先
amazon,国内好价优先smzdm - 若先用 AI 做产品调研,后续可补电商站点拿实际商品结果
社交媒体
用于需要原始帖子、原始用户结果、中文或英文社区讨论时。
站点
- 适用:Twitter/X 原始帖子、作者、实时讨论
- 使用前先运行:
opencli twitter -h
- 适用:微博热点、话题、中文舆论
- 使用前先运行:
opencli weibo -h
xiaohongshu
- 适用:生活方式、穿搭、美妆、旅行、真实体验
- 使用前先运行:
opencli xiaohongshu -h
zhihu
- 适用:中文深度问答、专业解释、行业经验
- 使用前先运行:
opencli zhihu -h
tieba
- 适用:兴趣圈子、历史帖子、粉丝社区
- 使用前先运行:
opencli tieba -h
- 适用:账号搜索、图片社交线索
- 使用前先运行:
opencli instagram -h
- 适用:主页、人物、帖子线索
- 使用前先运行:
opencli facebook -h
bluesky
- 适用:Bluesky 用户与账号搜索
- 使用前先运行:
opencli bluesky -h
路由提示
- 用户明确指定某个平台时,直接用该平台
- 用户只说“社交媒体上怎么看”时,可先选
grok或doubao - AI 只给摘要而没有原始帖子时,再切到对应社交站点
技术 / 学术
用于技术问题、研究论文、开发者讨论、开源社区信息。
站点
arxiv
- 适用:论文、研究、模型、算法、学术背景
- 使用前先运行:
opencli arxiv -h
stackoverflow
- 适用:具体报错、API 用法、代码模式、实现细节
- 使用前先运行:
opencli stackoverflow -h
hackernews
- 适用:技术社区讨论、开发者观点、创业和产品话题
- 使用前先运行:
opencli hackernews -h
- 适用:英文社区问答、经验贴、推荐、对比讨论
- 使用前先运行:
opencli reddit -h
linux-do
- 适用:人工智能、开源工具、中文技术社区
- 使用前先运行:
opencli linux-do -h
v2ex
- 适用:中文技术社区
- 使用前先运行:`opencli linux-do
路由提示
- 用户明确说“论文”“研究”时,优先
arxiv - 用户明确说“报错”“API 怎么用”时,优先
stackoverflow - 用户要“社区讨论”“开发者观点”时,优先
hackernews或reddit - 若用户没有明确指定站点,可先选
gemini或grok,内容不足时再补这些专用源
旅游
用于目的地、景区、酒店联想和旅行线索。
站点
ctrip
- 适用:目的地、景区、酒店、旅行联想搜索
- 使用前先运行:
opencli ctrip -h
xiaohongshu
- 适用:生活方式、穿搭、美妆、旅行、真实体验
- 使用前先运行:
opencli xiaohongshu -h
路由提示
- 用户明确说“携程”时直接使用
ctrip - 用户只说“旅行/目的地/景区”时,可先选
doubao做中文语境粗检索,再补ctrip
Related skills
Forks & variants (1)
Smart Search has 1 known copy in the catalog totaling 2 installs. They canonicalize to this original listing.
- mxyhi - 2 installs
How it compares
Pick smart-search when agents need a single best OpenCLI source; use explicit multi-source runs only when cross-checking answers is required.
FAQ
Which OpenCLI command lists available AI search sources?
smart-search starts with `opencli list -f yaml` to read the registry and confirm whether grok, doubao, and gemini are installed before routing a query to one backend.
When should agents choose grok over doubao?
smart-search routes to grok for real-time English internet discussion, X/Twitter context, trends, and reaction-style queries with time bounds like “this week” or “on X.”
Why avoid parallel OpenCLI AI searches?
smart-search picks one registered source to cut latency and token use; parallel grok, doubao, and gemini runs are reserved for cases that explicitly need multi-source coverage.
Is Smart Search safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.