메뉴
用開物 Kaiwu 建構正式整合的最佳實踐 — 額度管理、查詢技巧、繁簡策略、錯誤處理、何時用 search vs extract。要把開物接進 agent / 應用前先讀這個。Reference for production-ready Kaiwu integrations.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
開物 Kaiwu CLI（kw）的安裝、認證與設定參考，以及 search/extract/credits 的完整工作流程。設定環境、遇到 kw 找不到或認證問題時的參考。Install, auth, and configure the Kaiwu CLI (kw).
查詢開物 Kaiwu API 帳戶的剩餘額度、已用量與重置時間。在大量搜尋/抓取前或遇到額度不足錯誤時使用。Check remaining Kaiwu API credits, usage, and reset time.
用開物 Kaiwu 從一個或多個 URL 抓取乾淨的 markdown/純文字內容，去除導覽列、廣告等雜訊。已經有特定網址、想讀全文時使用。Extract clean markdown/text from URLs, with optional query-based filtering.
用開物 Kaiwu 搜尋中文世界的網路 — 繁簡雙語、無審查、回傳 LLM-ready 結果。需要找資訊、查最新消息、還沒有特定 URL 時使用。Search the Chinese-language web (Traditional + Simplified) with agent-optimized results.
| name | kaiwu-best-practices |
| description | 用開物 Kaiwu 建構正式整合的最佳實踐 — 額度管理、查詢技巧、繁簡策略、錯誤處理、何時用 search vs extract。要把開物接進 agent / 應用前先讀這個。Reference for production-ready Kaiwu integrations. |
把開物 Kaiwu 接進正式 agent / 應用的最佳實踐。要做整合，這是最快的入門。
| 你要做的事 | 用 |
|---|---|
| 找資訊、還沒有 URL | kw search |
| 快速一般查詢 | kw search --depth basic（預設，1 額度） |
| 需要精確事實 / 原文摘要 | kw search --depth advanced（2 額度） |
| 要一段可引用的綜合答案 | kw search --answer |
| 已有 URL、要讀全文 | kw extract |
| 從多源只挑相關段落 | kw extract --query "..." |
省額度原則：先 basic 搜尋拿到候選 URL，真正需要全文時才對少數 URL 用 extract，比每次都 advanced 划算。
--lang zh-CN 效果更好；台灣在地議題用 --lang zh-TW。--time-range week（或 day/month/year），避免拿到過期資訊。kw credits --json 確認餘額。credits_needed 與 credits_remaining，據此降級（例如改 basic、減少 max-results）。| 狀態 | 意義 | 建議 |
|---|---|---|
| 401 | 金鑰無效 / 缺失 | 檢查 KAIWU_API_KEY |
| 429 | 額度不足 | 降級或等重置 |
| 502 | 搜尋引擎暫時無法使用 | 退避重試 |
extract status: failed | 該 URL 抓取失敗（反爬蟲 / 逾時） | 該 URL 不計費；改用 search --depth advanced 取摘要 |
extract 是逐 URL 回報成功/失敗的，永遠檢查每筆 status，別假設全部成功。
--json，不要 parse 人類可讀格式。KAIWU_API_KEY，不要把金鑰寫進程式碼或 commit。-o file.json 落地結果。search --json → 取 results[].url → extract --json --query。