前言¶
做选题、写简报或做舆情跟踪时，常见做法是自己在浏览器里搜关键词、再手工整理链接。把「按关键词查全网或指定站点、结果落盘成结构化文件」交给 Agent，前提是有一套可核对的数据源和固定调用方式。下面介绍 SkillHub 上的 tencenthotsearch-skill（坐标 @user_5b28ea14/tencenthotsearch-skill，当前版本 1.0.1）：它封装腾讯云在线搜索 API（SearchPro），在对话里触发热点、趋势或关键词资讯检索，并支持多种导出格式。
这是什么¶
tencenthotsearch-skill 是社区来源（community）的 data-analysis 类 Skill，由 SkillHub 用户 user_5b28ea14 发布；页面展示作者为 hanli。官方简介说明：通过腾讯云 SearchPro 获取热门新闻与文章，支持全网或指定站点检索，输出可为 JSON、CSV、TXT、MD；当用户需要热点、趋势话题，或基于腾讯云做关键词文章搜索时，可调用本 Skill。
SkillHub 侧标签为 requires_api_key=true，与包内 SKILL.md 一致：需要配置腾讯云 SecretId 与 SecretKey。包内元数据还指向上游仓库路径 https://github.com/neuhanli/skills/tree/main/TencentHotSearch-skill，便于自行审阅脚本与配置说明。
核心功能¶
以下能力来自 SkillHub 简介及已安装包内 SKILL.md（v1.0.1）：
- 多关键词组合检索：一次支持 1～5 个关键词。
- 全网或站内搜索：可不指定站点做全网检索，也可用
-s限定站点（文档示例含qq.com、news.qq.com）。 - 多种搜索模式：Mode
0自然搜索结果（默认）、1多模态 VR、2混合结果；部分过滤参数在 Mode 1 下无效，以文档为准。 - 时间与行业过滤：支持
--from-time/--to-time（Unix 秒级时间戳）；--industry可选gov/news/acad/finance（文档标注为 Premium 能力）。 - 结构化结果字段：标题、摘要、动态摘要、来源、发布时间、原文链接、相关度、图片列表等。
- 多格式输出：
json/csv/txt/md，默认md；可在config.json中设置默认output_dir。 - 对接的官方 API：域名
wsa.tencentcloudapi.com，版本2025-05-08，接口名 SearchPro。
运行时依赖方面，文档要求 Python 3.7+；核心逻辑使用标准库，CSV 导出可选 pandas>=2.0.0（见 requirements.txt）。
安装与启用¶
通过 SkillHub CLI 安装到 Agent¶
先确认本机已安装 skillhub（未安装时可按 SkillHub 安装说明 执行官方安装脚本）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。
在 Cursor 中，skills 目录一般为：
~/.cursor/skills/
安装命令（与 SkillHub 页面提示一致，坐标带 @ 前缀）：
skillhub install @user_5b28ea14/tencenthotsearch-skill --dir ~/.cursor/skills/
Claude Code 常用路径为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。将上述 --dir 换成对应目录即可，安装步骤相同。
也可把下面提示发给 Agent，让其按官方文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5b28ea14/tencenthotsearch-skill`。
配置腾讯云凭证¶
进入 Skill 目录后，编辑 config.json（包内提供模板字段）：
{
"secret_id": "YOUR_TENCENT_CLOUD_SECRET_ID",
"secret_key": "YOUR_TENCENT_CLOUD_SECRET_KEY",
"output_dir": "./output"
}
SKILL.md 说明需在腾讯云控制台开通「在线搜索」并获取 API 密钥；更细的字段说明见包内 CONFIG.md。请勿将 config.json 提交到版本库。
Python 依赖（命令行脚本）¶
若需直接运行包内 scripts/tencent_hotsearch.py，在 Skill 根目录执行：
pip install -r requirements.txt
典型用法¶
在 Agent 对话中¶
按官方 description，在用户提出下列需求时启用本 Skill 即可，由 Agent 按 SKILL.md 调用脚本或等价流程：
- 获取某领域热点新闻或趋势话题；
- 按关键词检索最新文章；
- 在指定站点内搜索（如腾讯系站点）；
- 需要按时间或行业过滤，并将结果保存为 MD/JSON/CSV 等。
命令行可复现示例¶
下列命令摘自包内 SKILL.md，在 Skill 根目录、且已配置 config.json 的前提下执行。
全网检索，返回 10 条，默认 MD：
python scripts/tencent_hotsearch.py "AI" "machine learning" -l 10
限定站点：
python scripts/tencent_hotsearch.py "AI" "machine learning" -s qq.com -l 10
指定输出为 JSON 文件：
python scripts/tencent_hotsearch.py "AI" "machine learning" -o results.json -f json
时间范围过滤（示例时间戳来自文档）：
python scripts/tencent_hotsearch.py "AI" --from-time 1704067200 --to-time 1706745600
常用参数包括 -l（条数，可选 10/20/30/40/50）、-m（模式 0/1/2）、-o / -f（输出路径与格式）、--print（打印到终端）。
适用场景与注意¶
适合谁
- 已在用或计划用腾讯云 SearchPro，希望 Agent 统一完成「搜热点 → 落盘 → 再分析」的开发者；
- 需要把检索结果固定为 JSON/CSV 等格式、接入后续 data-analysis 流水线的场景。
限制与注意
- 必须自备 API 密钥：无有效
secret_id/secret_key无法调用；密钥应最小权限、定期轮换，建议在隔离环境运行。 - 网络与写文件权限：
SKILL.md声明需要访问wsa.tencentcloudapi.com，并向配置的输出目录写入结果。 - 元数据与文档：包内
SKILL.md提到，部分注册元数据曾写「无需凭证」，与实际config.json要求不一致；以包内文档与requires_api_key=true为准。 - Premium 能力：行业过滤、部分条数上限、动态摘要等以腾讯云套餐与
SKILL.md说明为准。 - SkillHub 统计（抓取时点）：评分 100000，下载约 990 次，安装 24 次；数据随 SkillHub 页面更新而变化。
结尾¶
tencenthotsearch-skill 把腾讯云 SearchPro 的检索能力装进通用 SKILL.md 工作流：Agent 侧用 SkillHub 安装与触发，执行侧用 config.json 与 scripts/tencent_hotsearch.py 完成可复现的搜索与导出。官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_5b28ea14/tencenthotsearch-skill
- API 坐标页：https://api.skillhub.cn/user_5b28ea14/tencenthotsearch-skill
