/install test-search
test-search
Search the web using iFlytek ONE SEARCH API (万搜/聚合搜索). Returns titles, summaries, URLs, and full text content from web pages.
When to Use
- User asks to search the Chinese web or needs Chinese-language search results
- Need an alternative to Brave Search (especially for Chinese content)
- User explicitly requests iFlytek / 讯飞 / 万搜 search
Prerequisites
- Python 3 (standard library only, no pip install needed)
- Environment variable:
XFYUN_API_PASSWORD— API password from 讯飞控制台
Usage
The script is at scripts/search.py relative to this skill directory.
Basic Search
python3 scripts/search.py "搜索关键词"
Options
| Flag | Description |
|---|---|
--limit N |
Max results, 1–20 (default 10) |
--no-rerank |
Disable result reranking |
--no-fulltext |
Disable full text retrieval |
--raw |
Output raw JSON instead of formatted text |
Examples
# Simple search
python3 scripts/search.py "美国现任总统是谁"
# Limit to 5 results
python3 scripts/search.py "Python asyncio 教程" --limit 5
# Raw JSON output for programmatic use
python3 scripts/search.py "量子计算最新进展" --raw
# Minimal mode — no rerank, no full text
python3 scripts/search.py "天气预报" --no-rerank --no-fulltext
Output Format (default)
Query: 美国现任总统是谁
## 1. Page Title
URL: https://example.com/page
Summary: Brief description of the page content
## 2. Another Result
URL: https://example.com/other
Summary: Another brief description
Output Format (--raw)
Returns the full API JSON response including data.search_results.documents[].content (full page text).
API Details
- Endpoint:
POST https://search-api-open.cn-huabei-1.xf-yun.com/v2/search - Auth:
Authorization: Bearer \x3CXFYUN_API_PASSWORD> - Rate limits: Per-app daily and per-second limits apply (see error codes below)
Error Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 11200 | Authorization error or quota exceeded |
| 11201 | Daily rate limit exceeded |
| 11202 | Per-second rate limit exceeded |
| 11203 | Concurrent connection limit exceeded |
| 21001 | Missing parameters |
| 21009 | Unauthorized appId |
Tips
- Use complete questions (e.g. "美国现任总统是谁?") rather than keywords for better time-sensitive results
- Query length should be ≤512 characters
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install test-search - After installation, invoke the skill by name or use
/test-search - Provide required inputs per the skill's parameter spec and get structured output
What is test-search?
Search the web using iFlytek ONE SEARCH API (万搜/聚合搜索). Returns titles, summaries, URLs, and full text from web pages. Good for Chinese-language web search.22222. It is an AI Agent Skill for Claude Code / OpenClaw, with 54 downloads so far.
How do I install test-search?
Run "/install test-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is test-search free?
Yes, test-search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does test-search support?
test-search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created test-search?
It is built and maintained by M. (@kokkmiao); the current version is v2.0.1.