mcpField
K
kimi-websearch

kimi-websearch

github.com/redfox-data生産性45083 回インストール1 日前に更新
リポジトリ

kimi-websearch について

kimi-websearchは、最新情報が必要な場面でKimi WebSearchを利用するSkillです。検索を非同期で送信して完了まで状態を確認し、回答と引用元を含むJSONを返します。

主な機能

  1. 01検索語を送信してタスクIDを取得
  2. 02検索タスクの状態を自動確認
  3. 03stderrで待機中の進捗を表示
  4. 04検索結果をJSONで出力
  5. 05認証、失敗、タイムアウトに対応

活用シーン

  1. 01更新される情報を検索
  2. 02Agentに構造化された検索結果を提供
  3. 03回答と引用元を確認
  4. 04検索タスクの失敗やタイムアウトを調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/redfox-data/redfox-community --skill kimi-websearch

インストール後、Claude Code で/kimi-websearchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.en.md
README.md
scripts/
kimi_search.py

詳細

プロジェクトの README より

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 "<搜索关键词>"

脚本自动完成：

  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 中的引用来源，结构化整理后向用户展示。

📦 依赖

pip3 install requests

⚠️ 错误处理

情况处理方式
未配置 REDFOX_API_KEY提示用户前往 红狐hub 获取 API Key
提交失败输出错误信息，建议用户重试
轮询超时（5 分钟）提示超时，建议稍后重试
任务失败（status=failed）输出失败详情

コメント

Markdown 対応