Kaiwu Search — 開物搜尋#

Search the web via Kaiwu API ( kaiwu.dev). Optimized for Chinese content (Traditional + Simplified), uncensored, with multi-engine aggregation (Google, DuckDuckGo, Brave).

Setup#

Requires KAIWU_API_KEY secret. If not set:

1. Check if agent has a wallet (base-wallet skill or existing wallet).
2. If wallet exists: auto-register via POST https://kaiwu.dev/api/auth/agent-register with SIWE signature to get a key.
3. If no wallet: instruct user to visit https://kaiwu.dev to get a free API key (1,000 searches/month free).

Store the key: KAIWU_API_KEY=kw_...

Search#

bash

curl -X POST https://kaiwu.dev/v1/search \
  -H "Authorization: Bearer $KAIWU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "台灣 AI 基本法",
    "lang": "zh-TW",
    "max_results": 5
  }'

Parameters#

ParamTypeDefaultDescriptionquerystringrequiredSearch querylangstringzh-TW``zh-TW, zh-CN, en, auto``max_resultsnumber51–20time_rangestringall``day, week, month, year, all

Response#

json

{
  "query": "台灣 AI 基本法",
  "results": [
    {
      "title": "立法院三讀通過《人工智慧基本法》",
      "url": "https://moda.gov.tw/...",
      "snippet": "立法院114年12月23日三讀通過...",
      "engine": "google",
      "published": "2025-12-23"
    }
  ],
  "credits_used": 1,
  "credits_remaining": 999
}

Check Credits#

bash

curl https://kaiwu.dev/v1/credits \
  -H "Authorization: Bearer $KAIWU_API_KEY"

Usage Guidelines#

• 1 credit per search call. Free tier: 1,000/month.
• Prefer lang: "zh-TW" for Taiwan topics, "zh-CN" for China topics, "auto" when unsure.
• For broad Chinese queries, Kaiwu auto-expands Traditional ↔ Simplified (e.g., "人工智慧" also searches "人工智能").
• Use time_range: "week" or "month" for recent news.
• Results come from Google, DuckDuckGo, and Brave — no Baidu, no censorship filtering.