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

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

Options

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

Error Codes

Tips

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