CLI & AGENT SKILLS · 命令列與技能

把中文搜尋接進終端機與 coding agent。

一行安裝，Day-1 支援 Claude Code 與 Cursor。CLI 與 Skills 共用你在儀表板建立的同一把金鑰。

npm install -g @kaiwu/cli && kw login

快速開始

安裝 CLI

npm install -g @kaiwu/cli
# 或免安裝
npx @kaiwu/cli search "台灣 AI 基本法"
# 或一鍵安裝器（需要 Node 18+）
curl -fsSL https://kaiwu.dev/install.sh | bash

登入：到儀表板建立金鑰（kw_…），然後 kw login；非互動環境用 KAIWU_API_KEY 環境變數。

搜尋

kw search "台灣 AI 基本法草案重點" --depth advanced --answer

Agent Skills（Claude Code / Cursor）

開物提供一組 Agent Skills，讓 coding agent 在需要中文資料時自動用開物搜尋與抓取——就像 Tavily 的 skills，但為中文世界打造。

# 先裝 CLI 並登入
npm install -g @kaiwu/cli && kw login

# 安裝全部 skills
npx skills add dAAAb/Kaiwu-Dev --all
# 或單獨安裝
npx skills add dAAAb/Kaiwu-Dev --skill kaiwu-search

# Claude Code plugin marketplace（兩步：登錄 marketplace → 安裝）
/plugin marketplace add dAAAb/Kaiwu-Dev
/plugin install kaiwu@kaiwu

Skill	用途
`kaiwu-search`	中文網路搜尋，回傳 agent 最佳化結果
`kaiwu-extract`	從 URL 抓取乾淨 markdown / 文字
`kaiwu-credits`	查詢剩餘額度
`kaiwu-cli`	安裝、認證、API 對照參考
`kaiwu-best-practices`	正式整合的最佳實踐

Skills 會依情境自動觸發，也可以用 slash command 明確呼叫：

/kaiwu-search 台灣 AI 基本法草案重點
/kaiwu-extract https://example.com/article
/kaiwu-credits
/kaiwu-best-practices

CLI 指令

kw search

kw search "你的查詢" --json
kw search "量子電腦" --depth advanced --max-results 10 --json
kw search "輝達 GTC 發表" --time-range week --json
echo "查詢" | kw search - --json   # 從 stdin

選項	說明
`--depth, -d`	basic（預設）/ advanced（抓網頁 + 語意摘要）
`--max-results, -n`	結果數量，1–20（預設 5）
`--time-range, -t`	day / week / month / year
`--lang, -l`	zh-TW（預設）/ zh-CN / en
`--answer, -a`	生成 AI 綜合答案（+1 額度）
`--json`	結構化 JSON 輸出
`-o, --output`	存到檔案

kw extract

kw extract "https://example.com/article" --json
kw extract "https://a.com" "https://b.com" --json
kw extract "https://example.com/docs" --query "API 認證" --json

選項	說明
`--format, -f`	markdown（預設）/ text
`--query, -q`	只保留與查詢相關的內容（+1 額度）
`--json`	結構化 JSON 輸出
`-o, --output`	存到檔案

kw credits

kw credits          # 人類可讀
kw credits --json   # 給程式解析

設定與環境變數

項目	說明
`~/.kaiwu/config.json`	kw login 寫入的金鑰（權限 600）
`KAIWU_API_KEY`	覆蓋設定檔的金鑰；CI / agent 建議使用
`KAIWU_API_URL`	自訂 API 位址（預設 https://kaiwu.dev）

直接打 API

CLI 是 REST API 的薄封裝。完整參數、回應與錯誤格式見開發者文件，機器可讀版本在 /openapi.json。

curl -s https://kaiwu.dev/v1/search \
  -H "Authorization: Bearer $KAIWU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"台灣 AI 政策","search_depth":"advanced","include_answer":true}'

額度計費

動作	額度
`search（basic）`	1
`search（advanced）`	2
`search --answer`	+1
`extract（每個成功 URL）`	1
`extract --query`	+1

目前限時免費：每月 1,000 額度。付費方案籌備中，詳見定價。