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:
- Check if agent has a wallet (base-wallet skill or existing wallet).
- If wallet exists: auto-register via
POST https://kaiwu.dev/api/auth/agent-register with SIWE signature to get a key.
- 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
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
| Param |
Type |
Default |
Description |
query |
string |
required |
Search query |
lang |
string |
zh-TW |
zh-TW, zh-CN, en, auto |
max_results |
number |
5 |
1–20 |
time_range |
string |
all |
day, week, month, year, all |
Response
{
"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
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.
1---2name: kaiwu-search3description: Search the web in Chinese (Traditional + Simplified) and English using the Kaiwu API. Use when the agent needs to search the web for Chinese content, find information about Taiwan/China/East Asia topics, or when existing search tools return poor Chinese-language results. Supports uncensored search (no political filtering), bilingual Traditional/Simplified Chinese expansion, and LLM-ready output. Triggers on web search, Chinese search, Taiwan search, 搜尋, 查詢, research in Chinese.4---56# Kaiwu Search — 開物搜尋78Search the web via Kaiwu API (`kaiwu.dev`). Optimized for Chinese content (Traditional + Simplified), uncensored, with multi-engine aggregation (Google, DuckDuckGo, Brave).910## Setup1112Requires `KAIWU_API_KEY` secret. If not set:13141. Check if agent has a wallet (base-wallet skill or existing wallet).152. If wallet exists: auto-register via `POST https://kaiwu.dev/api/auth/agent-register` with SIWE signature to get a key.163. If no wallet: instruct user to visit `https://kaiwu.dev` to get a free API key (1,000 searches/month free).1718Store the key: `KAIWU_API_KEY=kw_...`1920## Search2122```bash23curl -X POST https://kaiwu.dev/v1/search \24 -H "Authorization: Bearer $KAIWU_API_KEY" \25 -H "Content-Type: application/json" \26 -d '{27 "query": "台灣 AI 基本法",28 "lang": "zh-TW",29 "max_results": 530 }'31```3233### Parameters3435| Param | Type | Default | Description |36|-------|------|---------|-------------|37| `query` | string | required | Search query |38| `lang` | string | `zh-TW` | `zh-TW`, `zh-CN`, `en`, `auto` |39| `max_results` | number | 5 | 1–20 |40| `time_range` | string | `all` | `day`, `week`, `month`, `year`, `all` |4142### Response4344```json45{46 "query": "台灣 AI 基本法",47 "results": [48 {49 "title": "立法院三讀通過《人工智慧基本法》",50 "url": "https://moda.gov.tw/...",51 "snippet": "立法院114年12月23日三讀通過...",52 "engine": "google",53 "published": "2025-12-23"54 }55 ],56 "credits_used": 1,57 "credits_remaining": 99958}59```6061## Check Credits6263```bash64curl https://kaiwu.dev/v1/credits \65 -H "Authorization: Bearer $KAIWU_API_KEY"66```6768## Usage Guidelines6970- 1 credit per search call. Free tier: 1,000/month.71- Prefer `lang: "zh-TW"` for Taiwan topics, `"zh-CN"` for China topics, `"auto"` when unsure.72- For broad Chinese queries, Kaiwu auto-expands Traditional ↔ Simplified (e.g., "人工智慧" also searches "人工智能").73- Use `time_range: "week"` or `"month"` for recent news.74- Results come from Google, DuckDuckGo, and Brave — no Baidu, no censorship filtering.7576<!-- Last verified by LittleLobster: 2026-05-21 -->