前言¶
给 Agent 做调研、事实核对或 RAG 取数时,常见做法是各自接一套搜索 API、再写抽取与清洗脚本,提示词里还要说明何时该搜、何时该抓正文。维护成本高,也容易和工具调用权限打架。
下面介绍 SkillHub 社区技能 web34(坐标 @user_6ed39544/web34)。它在技能说明里把 Tavily、Exa 的搜索与正文抽取,统一收敛到 inference.sh CLI 一条路径,并写明适用场景与触发词,方便在 Cursor 等支持 Skills 的环境里直接启用。
这是什么¶
web34 是 SkillHub 上的社区来源(community)技能,分类为 data-analysis,当前版本 1.0.0,由发布者 user_6ed39544 维护。
官方简介将其定位为:通过 inference.sh CLI 完成 Web search and content extraction with Tavily and Exa。也就是说,Agent 按技能文档编排时,应使用 inference.sh 提供的 CLI(生态中常称为 belt)去调用 Tavily 与 Exa 侧的应用,而不是在技能内嵌另一套 HTTP 客户端实现。
SkillHub 页面:https://www.skillhub.cn/skills/user_6ed39544/web34
API 元数据:https://api.skillhub.cn/user_6ed39544/web34
核心功能¶
以下能力均来自 SkillHub 公布的技能简介,未作扩展。
应用(Apps)¶
技能说明列出五类应用,名称与职责如下:
| 名称 | 用途(按官方英文简介) |
|---|---|
| Tavily Search | 联网检索 |
| Tavily Extract | 从 URL 抽取正文等内容 |
| Exa Search | 检索 |
| Exa Answer | 直接回答型检索 |
| Exa Extract | 抽取与分析网页内容 |
能力(Capabilities)¶
- AI-powered search
- content extraction
- direct answers
- research
触发词(Triggers)¶
当用户或任务中出现下列意图时,适合加载本技能:web search、tavily、exa、search api、content extraction、research、internet search、ai search、search assistant、web scraping、rag、perplexity alternative 等(完整列表见 SkillHub 简介)。
依赖与标签¶
SkillHub 元数据标签 requires_api_key=true,表示运行链路上需要可用的 API 密钥或账号鉴权(具体字段以 inference.sh / 各搜索服务的要求为准,技能包内 SKILL.md 会约束 Agent 如何调用)。
安装与启用¶
1. 安装 SkillHub CLI¶
若本机尚未安装 SkillHub CLI,可先检查版本:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 官方安装文档执行完整安装(文档地址:https://skillhub.cn/install/skillhub.md):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 将 web34 装进当前 Agent 的 skills 目录¶
SkillHub 要求安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。
以 Cursor 为例,常见路径为 ~/.cursor/skills/:
skillhub install @user_6ed39544/web34 --dir ~/.cursor/skills/
其他客户端路径(摘自 SkillHub 安装文档,按你实际使用的工具选择):
- Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/ - Gemini CLI:
~/.gemini/skills/
安装完成后,按所用客户端说明重启或刷新 Agent,使新技能生效。
也可将下面提示词交给 AI,让其按官方流程安装(SkillHub 页面提供的模板):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_6ed39544/web34`。
3. 准备 inference.sh CLI¶
技能简介明确要求 via inference.sh CLI。inference.sh 官方 CLI 安装说明(https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md)示例:
curl -fsSL cli.inference.sh | sh
belt login
Linux / macOS 亦可通过 Homebrew 等方式安装同一 CLI;Windows 可使用官方文档中的 PowerShell 或 Scoop 命令。完成 belt login 后,Agent 才能在受 allowed-tools 约束的前提下执行 belt 相关命令(具体以安装包内 SKILL.md 为准)。
典型用法¶
SkillHub 公开展示页主要给出技能定位与安装指引,未在页面上列出逐条 shell 示例。结合官方简介,可复现的使用方式如下。
1. 用自然语言触发技能¶
在已启用 web34 的会话中,用调研类需求对话即可,例如:
- 「用 Tavily 查一下某主题的最新进展,并给出出处。」
- 「从这个 URL 抽取正文,准备做 RAG。」
- 「用 Exa 直接回答一个事实性问题。」
Agent 应读取技能包中的 SKILL.md,在匹配 Triggers 时选择 Tavily Search / Extract 或 Exa Search / Answer / Extract 对应能力,并通过 inference.sh CLI 发起调用。
2. 按任务类型选应用¶
| 目标 | 优先对应的应用(官方 Apps 列表) |
|---|---|
| 广谱检索并整理材料 | Tavily Search 或 Exa Search |
| 只要简短事实答复 | Exa Answer |
| 已知 URL,需要干净正文 | Tavily Extract 或 Exa Extract |
| 多步调研、再交给模型总结 | 先 Search / Extract,再结合你自己的 LLM 工作流(技能简介中的 research、RAG pipelines 场景) |
3. 与 Agent 工具权限配合¶
本类技能通常会在 SKILL.md 的 front matter 中限制可执行的终端范围(例如仅允许 belt 子命令)。安装后若出现「无权执行 bash」类问题,应检查客户端是否允许技能声明的 allowed-tools,而不是绕过技能直接爬站。
适用场景与注意¶
适合谁¶
官方 Use for 列表包括:
- research
- RAG pipelines
- fact-checking
- content aggregation
- agents
需要把联网检索、URL 抽取和「带出处 / 可核对」的回答纳入 Agent 工作流时,web34 与上述场景对齐。
使用注意¶
- API 与账号:
requires_api_key=true表示不能指望零配置开箱即用;需提前完成 inference.sh 登录及各搜索能力所需的密钥配置。 - 合规与版权:抽取与聚合内容时,仍须遵守目标站点条款与本地法规;技能提供的是调用路径,不替代合规审查。
- 社区来源:来源为
community,版本 1.0.0;升级或排错以 SkillHub 坐标@user_6ed39544/web34为准。 - 商店数据:截至资料抓取时,SkillHub 显示评分 100000、下载 678、安装 0(数值会随时间变化,以商店页面为准)。
结尾¶
web34 把 Tavily 与 Exa 的搜索、回答与抽取能力,收敛到「SkillHub 技能 + inference.sh CLI」的组合里,并写清触发词与 RAG / 调研类场景,适合不想自建多套搜索集成的开发者。
- SkillHub:https://www.skillhub.cn/skills/user_6ed39544/web34
- 元数据 API:https://api.skillhub.cn/user_6ed39544/web34
- SkillHub 安装说明:https://skillhub.cn/install/skillhub.md