前言¶
在 Cursor、Claude Code 等环境里做问答或写代码时，模型上下文往往止于训练数据与本地仓库，遇到「最新政策」「实时股价」「某产品本周更新」这类问题，要么拒答，要么靠内置浏览能力但结果不稳定。自己接搜索 API 又要写鉴权、拼请求、把网页洗成 Agent 可读的 Markdown。
下面介绍 SkillHub 上的 元宝搜索 Skill（坐标 @user_f26e0ccb/tencent-yuanbao-standard-search，包名对应标准版联网搜索）。它把腾讯云元宝搜索服务（Tencent Yuanbao Search，WSA）封装成通用 SKILL.md 工作流：配置 API Key 后，由 Agent 在需要外网信息时优先调用 scripts/websearch.py，直接拿到结构化检索结果。
这是什么¶
元宝搜索 Skill 是社区来源（source: community）的 knowledge-management 类 Skill，SkillHub 子分类为「信息检索」。页面展示名为「元宝搜索Skill」，英文摘要为：Search the web using Tencent Yuanbao Search (WSA). Prioritize using it when you need to retrieve network information.
维护方在 SkillHub 上标注为 TencentCloud Web Search API (WSA)，发布坐标为 user_f26e0ccb。产品定位（中文摘要）：以互联网公开资源为基础，叠加腾讯内容生态与元宝 APP 联网搜索实践，从收录到召回构建面向 AI 的搜索引擎；针对对话中的 query 返回标题、摘要、URL、发布时间、站点等，供大模型决策使用。
当前 SkillHub 展示版本为 v1.0.4（版本说明：增加 mode 参数）；标签 requires_api_key=true，运行依赖 python3 与环境变量 TENCENTCLOUD_WSA_APIKEY。
核心功能¶
依据官方 Skill 包内的 SKILL.md，已核实能力包括：
- 关键词联网检索：通过 WSA 按 query 拉取网页结果，脚本输出 Markdown（标题链接、摘要、发布时间、站点、相关性得分，可选图片）。
- 检索约束：可选
site（域名）、freshness（d[N]/m[N]/y[N]或year等时效）、cnt（10–50 条）、industry（gov / news / acad / finance）。 - 结果类型
mode（v1.0.4 起）：0公开网页信源（默认）；1优质权威垂直信源（天气、金价、股价等）；2混合结果。 - Agent 触发指引：文档列出「帮我搜索…」「最新的…」「联网搜索」等意图，并约定先检查
TENCENTCLOUD_WSA_APIKEY，再在 Skill 目录下执行脚本。 - 错误提示：欠费、未开通、未授权等场景对应腾讯云控制台与费用中心链接。
SkillHub 页面统计（截至页面数据）：下载约 5788 次，安装 9 次；产品主页见 腾讯云 WSA。
安装与启用¶
1. 安装 SkillHub CLI（可选）¶
若本机尚无 skillhub，按 SkillHub 安装文档 执行：
command -v skillhub && skillhub --version
未安装时可用官方脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装元宝搜索 Skill¶
方式 A：skillhub install（推荐）
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别：
skillhub install @user_f26e0ccb/tencent-yuanbao-standard-search --dir <你的 skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
方式 B：下载 Zip
SkillHub 提供 v1.0.4 包下载：
https://api.skillhub.cn/api/v1/download?slug=@user_f26e0ccb/tencent-yuanbao-standard-search
解压到上述 skills 目录之一即可。
方式 C：让 Agent 按提示词安装
官方页面说明：根据 https://skillhub.cn/install/skillhub.md ，安装 @user_f26e0ccb/tencent-yuanbao-standard-search。
3. 开通 WSA 并配置 API Key¶
在 元宝搜索控制台 开通服务并创建 服务 API KEY。免费额度规则以 活动专区 页面为准。
将 Key 写入环境变量（Skill 元数据要求）：
export TENCENTCLOUD_WSA_APIKEY="your-api-key-here"
更完整的 Open Claw / 多环境配置见 Skill 包内 references/setup.md。安装后需重启或刷新 Agent，使其加载新 Skill。
典型用法¶
以下命令均需在 Skill 根目录（与 scripts/websearch.py 同级）执行。
关键词搜索：
python3 scripts/websearch.py --query="搜索关键词"
限定站点：
python3 scripts/websearch.py --query="搜索关键词" --site="sogou.com"
最近三天内的结果：
python3 scripts/websearch.py --query="搜索关键词" --freshness='d3'
天气、股价等垂直信源（混合模式）：
python3 scripts/websearch.py --query="搜索关键词" --mode=2
限制返回条数：
python3 scripts/websearch.py --query="搜索关键词" --cnt=10
在对话侧，用户说「帮我搜索一下腾讯股价」时，Agent 应按 SKILL.md：识别检索意图 → 检查 TENCENTCLOUD_WSA_APIKEY → 调用上述脚本 → 将 Markdown 结果回给用户。
适用场景与注意¶
适合：
- 需要稳定、可审计的联网检索，且希望统一走腾讯云 WSA 计费与控制台管理的团队。
- 已在 Cursor / Claude Code / Codex 等支持 Skills 的客户端中工作，希望用一条安装命令补齐「外网查证」能力。
注意：
- 付费与配额：调用走 WSA 标准版/API KEY 鉴权，需关注账号欠费与额度；未配置 Key 时 Skill 会提示开通与创建 Key。
- 运行环境：依赖本机
python3；脚本路径相对 Skill 目录，不要在其他工作目录裸调。 - 命名差异：SkillHub 展示名「元宝搜索Skill」，包内
SKILL.md的name为tencent-yuanbao-search，坐标 slug 为tencent-yuanbao-standard-search，检索时以坐标为准。 - 社区包：
source为 community，使用前可在 SkillHub 查看安全扫描结果；企业场景请结合内网合规要求评估外网检索。
结尾¶
元宝搜索标准版 Skill 把 WSA 检索参数（站点、时效、条数、mode、垂直领域）和 Agent 触发逻辑写进 SKILL.md，减少自建联网层的重复劳动。安装、Key 配置与脚本示例均来自官方 Skill 包与 SkillHub 页面。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_f26e0ccb/tencent-yuanbao-standard-search
- API 入口（SkillHub）：https://api.skillhub.cn/user_f26e0ccb/tencent-yuanbao-standard-search
- 产品文档与开通：https://cloud.tencent.com/product/wsa
