Agent Skills
返回列表
CyberSearch 网页搜索客户端

CyberSearch 网页搜索客户端

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_2e78d813/cybersearch。

技能介绍

要解决什么问题

在 Agent 或脚本里做网页检索时，你往往不想自己拼 HTTP、解析 JSON，还要处理授权码刷新和错误码映射。CyberSearch 把清风 AI 搜索的网页搜索 API 收成一个小型 Python 客户端：一次 search() 拿原始响应，再用 format_results() 转成可读文本，方便塞进提示词或日志。

核心能力怎么组织

  • WebSearchClient：初始化时会自动请求授权接口拿动态授权码；密钥从 .env 里的 QINGFENG_API_KEY 读取，也可在构造时传入。
  • search(query, count=10, freshness="noLimit")：count 最大 10；freshness 支持 day / week / month / year 等时间过滤。
  • format_results(results, query="")：把 API 返回结构整理成带查询上下文的文本，而不是裸 JSON。
  • 命令行：模块可直接当 CLI 跑，适合本地快速验证查询与输出格式。
  • 错误提示：未配置密钥、401、502（未开通或额度用尽）、授权失败、网络异常等场景在文档里有对应说明，便于对照排查。

适用边界与注意点

  • 依赖 Python 3.7+ 与 requests、python-dotenv；遵守平台速率限制与使用条款。
  • 搜索结果是第三方网页摘要，准确性需自行核验；勿用于敏感或个人隐私检索。
  • API 可能产生费用，额度与开通状态以清风 AI 搜索平台为准；502 时需联系平台侧处理额度。

使用场景

  • 在 Python Agent 的工具函数里，对用户问题调用 `search()`，并用 `freshness=week` 拉取近一周网页结果供推理引用。
  • 集成前用该模块命令行快速试跑查询词，核对 `format_results()` 的文本排版是否适合写入 LLM 上下文。
  • 自动化脚本里先 `search()` 拿原始 JSON，再 `format_results()` 转成统一格式，交给下游摘要或问答模块处理。
  • 在项目根目录用 `.env` 配置 `QINGFENG_API_KEY`，在定时任务中对固定关键词检索并将格式化输出写入日志或工单。

适合人员

  • 维护 Python Agent 工具集、需要可设 `count` 与时间过滤的网页检索接口的工程师
  • 对接清风 AI 搜索、希望授权码自动获取且少写 HTTP 解析胶水代码的后端开发者
  • 做检索增强问答原型、要把 API 响应转成可读上下文再注入模型的 AI 应用开发者
  • 用脚本跑固定关键词监控、需要结构化结果与明确错误码提示（401/502）的数据或运营分析人员