kimi-websearch
Kimi WebSearch 搜索工具。基于红狐 API 调用 Kimi 联网搜索能力,提交查询后自动轮询等待结果返回。当用户需要使用 Kimi 搜索、联网搜索、AI 搜索获取实时信息时使用。触发词:kimi搜索、kimi websearch、联网搜索、AI搜索、kimi搜索。
Install
npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/kimi-websearch
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart
git clone https://github.com/redfox-data/redfox-community.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole redfox-data/redfox-community collection as a plugin from our marketplace. Git is the plain clone.
README
Kimi WebSearch / kimi-websearch
简介
Kimi WebSearch 是一款联网智能搜索工具,只需用自然语言描述你想了解的话题,就能调用 Kimi 的联网能力为你找到最新、最全的答案。
核心价值
- 输入任意问题,自动联网搜索并返回结构化答案
- 无需等待,后台自动轮询结果,搜完即时呈现
- 结果包含完整回答和引用来源,方便核实
适用对象
- 🔍 信息搜集者 — 需要快速获取某个话题的实时信息
- ✍️ 内容创作者 — 为写作寻找参考素材和最新数据
- 🎯 日常用户 — 想问什么直接问,省去自己翻网页的麻烦
功能特性
核心功能
- 自然语言提问,智能联网搜索最新信息
- 自动等待搜索结果,中途实时提示进度
- 返回结构化答案,附带引用来源链接
- 覆盖 API Key 缺失、超时等异常情况的友好提示
密钥获取与安全说明
- 本技能需要使用环境变量:
REDFOX_API_KEY。 REDFOX_API_KEY由 红狐 hub(https://redfox.hk)提供。- 请前往 红狐 hub 注册账号,获取
REDFOX_API_KEY。 - 配置设备环境变量
REDFOX_API_KEY后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
使用指南
直接用自然语言描述需求,无需记忆命令。
常用说法速查
| 意图 | 示例话术 | 效果 |
|---|---|---|
| 搜索资讯 | 「最近有什么热门电影推荐」 | 返回最新电影信息和评价 |
| 知识问答 | 「AI Agent 的最新发展趋势是什么」 | 返回结构化的行业分析 |
| 实时查询 | 「今天有什么热点新闻」 | 返回最新资讯汇总 |
使用场景
| 场景 | 角色 | 示例问法 | 收益 |
|---|---|---|---|
| 日常搜索 | 普通用户 | 「2026年最值得买的手机」 | 快速获得最新对比推荐 |
| 内容创作 | 自媒体博主 | 「最近的热点话题有哪些」 | 获取实时选题灵感 |
| 学习研究 | 学生/研究者 | 「Transformer 架构的原理」 | 得到结构化知识总结 |
| 旅游规划 | 旅行爱好者 | 「成都周边有什么好玩的」 | 获得带详细信息的攻略 |
Skill manifest
Kimi WebSearch
📝 简介
调用 Kimi 联网搜索能力,和kimi直接对话。适用于需要联网实时搜索、AI 辅助信息检索的场景。
✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---|---|---|
| 异步提交 | 提交搜索关键词到 Kimi WebSearch,返回 taskId | 无需等待,立即获取任务标识 |
| 自动轮询 | 每 5 秒查询任务状态,最多等待 5 分钟 | 自动等待结果,无需手动查询 |
| 进度反馈 | 轮询期间通过 stderr 实时输出等待状态 | 用户可知搜索进度 |
| 结果输出 | 状态变为 completed 后输出完整 JSON | 结构化数据便于 Agent 解析展示 |
| 异常处理 | 覆盖 API Key 缺失、提交失败、超时、任务失败四种场景 | 每种异常有明确提示和处理 |
🔑 鉴权
前往 红狐hub 获取 API Key,通过以下方式配置:
# 方式一:配置文件(如 OpenClaw 的 ~/.openclaw/openclaw.json)
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
# 方式二:终端环境变量
export REDFOX_API_KEY="ak_xxxx..."
🔄 工作流程
Step 1:提取搜索关键词
从用户自然语言描述中提取搜索意图和关键词,作为 inquiry_text 传入。
Step 2:调用搜索脚本
python3 ~/.agents/skills/kimi-websearch/scripts/kimi_search.py "<搜索关键词>"
脚本自动完成:
- 提交搜索:
POST /story/api/kimi/submit,传入{"inquiry_text": "...", "source": "kimi websearch-GitHub"} - 轮询结果:每 5 秒
POST /story/api/kimi/result查询一次,直到状态为completed - 实时反馈:轮询期间通过 stderr 输出等待提示
- 最终输出:状态
completed后输出完整 JSON 结果到 stdout
Step 3:展示结果
脚本返回 JSON 后,提取 data.content 中的 Kimi 回答文本和 data.result 中的引用来源,结构化整理后向用户展示。
📦 依赖
pip3 install requests
⚠️ 错误处理
| 情况 | 处理方式 |
|---|---|
未配置 REDFOX_API_KEY |
提示用户前往 红狐hub 获取 API Key |
| 提交失败 | 输出错误信息,建议用户重试 |
| 轮询超时(5 分钟) | 提示超时,建议稍后重试 |
| 任务失败(status=failed) | 输出失败详情 |
Files (redfox-community)
-
scripts
-
kimi_search.py 3.9 KB
Loading…
-
-
README.en.md 2.6 KB
Loading… -
README.md 2.4 KB
# Kimi WebSearch / kimi-websearch --- ## 简介 Kimi WebSearch 是一款联网智能搜索工具,只需用自然语言描述你想了解的话题,就能调用 Kimi 的联网能力为你找到最新、最全的答案。 **核心价值** - 输入任意问题,自动联网搜索并返回结构化答案 - 无需等待,后台自动轮询结果,搜完即时呈现 - 结果包含完整回答和引用来源,方便核实 **适用对象** - 🔍 **信息搜集者** — 需要快速获取某个话题的实时信息 - ✍️ **内容创作者** — 为写作寻找参考素材和最新数据 - 🎯 **日常用户** — 想问什么直接问,省去自己翻网页的麻烦 --- ## 功能特性 ### 核心功能 - 自然语言提问,智能联网搜索最新信息 - 自动等待搜索结果,中途实时提示进度 - 返回结构化答案,附带引用来源链接 - 覆盖 API Key 缺失、超时等异常情况的友好提示 --- ## 密钥获取与安全说明 - 本技能需要使用环境变量:`REDFOX_API_KEY`。 - `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=github)(`https://redfox.hk`)提供。 - 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号,获取 `REDFOX_API_KEY`。 - 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。 - 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。 --- ## 使用指南 直接用自然语言描述需求,无需记忆命令。 ### 常用说法速查 | 意图 | 示例话术 | 效果 | |------|---------|------| | 搜索资讯 | 「最近有什么热门电影推荐」 | 返回最新电影信息和评价 | | 知识问答 | 「AI Agent 的最新发展趋势是什么」 | 返回结构化的行业分析 | | 实时查询 | 「今天有什么热点新闻」 | 返回最新资讯汇总 | --- ## 使用场景 | 场景 | 角色 | 示例问法 | 收益 | |------|------|---------|------| | 日常搜索 | 普通用户 | 「2026年最值得买的手机」 | 快速获得最新对比推荐 | | 内容创作 | 自媒体博主 | 「最近的热点话题有哪些」 | 获取实时选题灵感 | | 学习研究 | 学生/研究者 | 「Transformer 架构的原理」 | 得到结构化知识总结 | | 旅游规划 | 旅行爱好者 | 「成都周边有什么好玩的」 | 获得带详细信息的攻略 | -
SKILL.md 2.8 KB
--- name: kimi-websearch description: Kimi WebSearch 搜索工具。基于红狐 API 调用 Kimi 联网搜索能力,提交查询后自动轮询等待结果返回。当用户需要使用 Kimi 搜索、联网搜索、AI 搜索获取实时信息时使用。触发词:kimi搜索、kimi websearch、联网搜索、AI搜索、kimi搜索。 --- # Kimi WebSearch ## 📝 简介 调用 Kimi 联网搜索能力,和kimi直接对话。适用于需要联网实时搜索、AI 辅助信息检索的场景。 ## ✨ 功能特性 | 功能模块 | 能力描述 | 核心价值 | |---------|---------|---------| | 异步提交 | 提交搜索关键词到 Kimi WebSearch,返回 taskId | 无需等待,立即获取任务标识 | | 自动轮询 | 每 5 秒查询任务状态,最多等待 5 分钟 | 自动等待结果,无需手动查询 | | 进度反馈 | 轮询期间通过 stderr 实时输出等待状态 | 用户可知搜索进度 | | 结果输出 | 状态变为 completed 后输出完整 JSON | 结构化数据便于 Agent 解析展示 | | 异常处理 | 覆盖 API Key 缺失、提交失败、超时、任务失败四种场景 | 每种异常有明确提示和处理 | ## 🔑 鉴权 前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API Key,通过以下方式配置: ```bash # 方式一:配置文件(如 OpenClaw 的 ~/.openclaw/openclaw.json) { "env": { "REDFOX_API_KEY": "ak_xxxx..." } } # 方式二:终端环境变量 export REDFOX_API_KEY="ak_xxxx..." ``` ## 🔄 工作流程 ### Step 1:提取搜索关键词 从用户自然语言描述中提取搜索意图和关键词,作为 `inquiry_text` 传入。 ### Step 2:调用搜索脚本 ```bash python3 ~/.agents/skills/kimi-websearch/scripts/kimi_search.py "<搜索关键词>" ``` 脚本自动完成: 1. **提交搜索**:`POST /story/api/kimi/submit`,传入 `{"inquiry_text": "...", "source": "kimi websearch-GitHub"}` 2. **轮询结果**:每 5 秒 `POST /story/api/kimi/result` 查询一次,直到状态为 `completed` 3. **实时反馈**:轮询期间通过 stderr 输出等待提示 4. **最终输出**:状态 `completed` 后输出完整 JSON 结果到 stdout ### Step 3:展示结果 脚本返回 JSON 后,提取 `data.content` 中的 Kimi 回答文本和 `data.result` 中的引用来源,结构化整理后向用户展示。 ## 📦 依赖 ```bash pip3 install requests ``` ## ⚠️ 错误处理 | 情况 | 处理方式 | |------|---------| | 未配置 `REDFOX_API_KEY` | 提示用户前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API Key | | 提交失败 | 输出错误信息,建议用户重试 | | 轮询超时(5 分钟) | 提示超时,建议稍后重试 | | 任务失败(status=failed) | 输出失败详情 |
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.