xfyun-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#

bash

python3 scripts/search.py "搜索关键词"

Options#

FlagDescription--limit NMax results, 1–20 (default 10)--no-rerankDisable result reranking--no-fulltextDisable full text retrieval--rawOutput raw JSON instead of formatted text

Examples#

bash

# 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)#

text

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 <XFYUN_API_PASSWORD>
• Rate limits: Per-app daily and per-second limits apply (see error codes below)

Error Codes#

CodeMeaning0Success11200Authorization error or quota exceeded11201Daily rate limit exceeded11202Per-second rate limit exceeded11203Concurrent connection limit exceeded21001Missing parameters21009Unauthorized appId

Tips#

• Use complete questions (e.g. "美国现任总统是谁？") rather than keywords for better time-sensitive results
• Query length should be ≤512 characters