shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

iFlytek Web 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.

personAuthor: jpengcheng523-netizenhubclawhub
open_in_newRepositorydownloadDownload package

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

| 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 <XFYUN_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