给 Claude Code 等终端型 agent 用的联网搜索 Skill
只是拿到一个搜索工具的 agent,通常就是发一次默认查询,把摘要贴回来。Search1API 的 skill 教它自己决定用哪条命令、选哪个引擎、取多少条,以及到底要不要把页面正文读进来。
安装 — bashnpm install -g search1api-clinpx skills add superagents-lab/search1api-cli
skill 会挑命令、挑引擎、定取多少条,以及到底要不要把页面读进来。
对话里出现的链接会被抓取正文,而不是再搜一遍。
简单查询就浅查;调研类问题先铺开,再把最有用的几条整篇读完。
“最新”会转成请求上的时间范围,而不是往查询里多塞词。
可以这样说
搜一下最新的 AI 新闻 / 这个链接讲了什么? / GitHub 上现在什么最火?
Skill 在工具之上多给了什么
MCP 服务器告诉 agent「能调用什么」,skill 告诉它「什么时候调、怎么调」——而后者才决定答案好不好。Search1API 的 skill 是一组 agent 在用的时候才读的指令:对话里出现 URL 就去读那个页面而不是再搜一遍,简单事实查询和调研需求走不同路径,「最新」这样的词被转成时间过滤条件而不是留在查询串里。它驱动的是 s1 CLI,所以 agent 执行的都是你能在记录里读到的普通命令。
装上之后有什么不同
下面每一条都是 agent 自己做的判断,不需要你点名某条命令或某个参数。
看到 URL 就去读
对话里出现链接时,agent 会抓取那个页面拿正文,而不是再去搜索一个它手里已经有的页面。
深度跟着问题走
简单事实查询只取少量结果、不抓正文;调研类问题会把结果面铺开,再把最有用的三到五条整篇读完。
时效变成过滤条件
「最新」「今天」这类词会变成请求上的时间范围,而不是往查询里多塞几个词——真正收窄结果的是前者。
是工作流,不是单次调用
深度调研、URL 摘要、追踪某个趋势都被完整定义过,所以 agent 会连续调用多次,而不是拿到第一个响应就停。
给答案,不是倒结果
skill 会让 agent 把查到的内容综合成答案并标明来源,而不是把原始结果贴回对话里。
底下跑的 CLI
s1 把整个 API 放进终端,而且可以按需输出 JSON,所以在 shell 脚本里也能用。skill 调的就是这些命令,agent 做的任何一步你都可以自己手敲复现。
安装并登录 — bash# Standalone binary, no Node.js requiredcurl -fsSL https://cli.search1api.com/install.sh | bash# Or from npmnpm install -g search1api-cli# Authorize in the browser with OAuth 2.1s1 login
用 OAuth 登录,不是贴 API key
s1 login 是真正的 OAuth 2.1 流程。CLI 会发现授权服务器、把自己注册成公共原生客户端,然后走 Authorization Code + PKCE。你在浏览器里确认,之后它自己刷新 access token。在 CI 和不方便交互登录的脚本环境里,API key 仍然可用。
命令
s1 search "<query>"搜索网页
s1 news "<query>"搜索新闻
s1 crawl <url>读取页面正文
s1 sitemap <url>列出站点链接
s1 trending <github|hackernews>热门趋势
s1 balance剩余积分
s1 login在浏览器里完成 OAuth 2.1 授权
示例
日常用法 — bash# Five results from Googles1 search "rust async" -n 5 -s google# Search, then crawl the top 3 results for their full texts1 search "web framework" -c 3# Today's news, from Hacker Newss1 news "tech layoffs" -s hackernews -t day# Machine-readable output, straight into jqs1 search "test" --json | jq '.results[0].title'
什么场景下最值
Claude Code 在对一个没见过的 API 动手之前,先查最新的库文档。
终端型 agent 跨多个来源做调研,并带着出处汇报。
把 --json 接进 jq 的 shell 脚本,用来出定期报告。
同事贴来一个 URL,不离开终端就把它读完并总结。
开工时先看一眼 GitHub 或 Hacker News 上正在热的东西。
常见问题
什么是 agent skill?
skill 是 agent 在决定「这个能力该怎么用」时读的一组指令。工具定义告诉它有一个搜索函数、参数有哪些;skill 告诉它什么样的问题配什么参数、要把哪些工作流串起来、结果该怎么呈现。Search1API 的 skill 覆盖搜索、新闻、页面读取和热榜。
是不是还得装 CLI?
是。skill 驱动的是 s1 CLI,所以要先装好 CLI 并登录。如果还没装,第一次使用时 skill 会带着 agent 和你走一遍。
哪些 agent 能用?
任何支持 skill 且能执行 shell 命令的 agent 宿主都能用,Claude Code 和其他终端型 agent 都在其中。这个 skill 同时发布在 Smithery 上,从那里安装的宿主也可以用。
这跟 MCP 服务器是一回事吗?
不是,两者解决的是问题的不同一半。MCP 服务器负责把工具暴露出来,skill 负责给出怎么用的判断。如果你的客户端讲 MCP、又不想在本地装东西,用 MCP 服务器;如果你的 agent 在终端里干活,而你要的是「搜得好」而不只是「能搜」,那就装 skill。
怎么收费?
skill 和 CLI 本身免费。它们调用同一个 API、消耗同样的积分:search 和 news 各 1 积分,每成功抓取一个页面再加 1 积分。深度调研模式会抓页面,所以比单纯搜索贵一些。新账户免费赠送 100 积分且无需绑卡。
能在 CI 里用吗?
能。在环境变量里设置 SEARCH1API_KEY,CLI 就会用它而不是已保存的 OAuth 凭证——在没有浏览器的环境里这是可行的做法。加上 --json 可以拿到机器可读的输出。
了解更多
教会你的 agent 怎么搜
两条命令装好,一次 OAuth 登录,另有 100 个免费积分够你试出来。