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

> 安裝 @kaiwu/cli、kw login / search / extract / credits 指令說明，以及 kaiwu-search、kaiwu-extract 等 Claude Code / Cursor Agent Skills 的安裝與用法。

來源 Source: https://kaiwu.dev/cli · 標題 Title: 開物 CLI & Agent Skills — kw 指令與 Claude Code / Cursor 整合 · 本文件為 `Accept: text/markdown` 的 Markdown 版本

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

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

## 快速開始

1. **安裝 CLI**
```
npm install -g @kaiwu/cli
# 或免安裝
npx @kaiwu/cli search "台灣 AI 基本法"
# 或一鍵安裝器（需要 Node 18+）
curl -fsSL https://kaiwu.dev/install.sh | bash
```
2. **登入**：到 [儀表板](https://kaiwu.dev/dashboard) 建立金鑰（`kw_…`），然後 `kw login`；非互動環境用 `KAIWU_API_KEY` 環境變數。
3. **搜尋**
```
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 的薄封裝。完整參數、回應與錯誤格式見 [開發者文件](https://kaiwu.dev/developers)，機器可讀版本在 [/openapi.json](https://kaiwu.dev/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 額度。付費方案籌備中，詳見[定價](https://kaiwu.dev/#pricing)。

- [快速開始](https://kaiwu.dev/cli#start)
- [Agent Skills](https://kaiwu.dev/cli#skills)
- [CLI 指令](https://kaiwu.dev/cli#commands)
- [直接打 API](https://kaiwu.dev/cli#api)
- [額度計費](https://kaiwu.dev/cli#pricing)

- [開發者文件](https://kaiwu.dev/developers)
- [@kaiwu/cli on npm](https://www.npmjs.com/package/@kaiwu/cli)
- [skills/ 原始碼](https://github.com/dAAAb/Kaiwu-Dev/tree/main/skills)
- [儀表板](https://kaiwu.dev/dashboard)