小宿智能搜索 V2

Web search API for real-time internet information retrieval.

Setup (Required)

Set these environment variables before using this skill:

export XIAOSU_AK="<your-access-key>"
export XIAOSU_ENDPOINT="<your-endpoint-path>"

Get your credentials at: https://www.xiaosuai.com (小宿智能搜索)

You can add them to your shell profile (~/.bashrc / ~/.zshrc) or OpenClaw's .env file.

Quick Usage

Run the search script directly:

python3 ~/.openclaw/skills/xiaosu-search/scripts/xiaosu_search.py "<query>" \
  --ak $XIAOSU_AK --endpoint $XIAOSU_ENDPOINT [options]

Common Patterns

# Basic search
python3 scripts/xiaosu_search.py "宁德时代" --ak $AK --endpoint $EP

# Recent news (last 24h)
python3 scripts/xiaosu_search.py "CATL battery" --freshness Day --ak $AK --endpoint $EP

# With full content extraction (for deep reading)
python3 scripts/xiaosu_search.py "储能行业趋势" --content --content-type MARKDOWN --content-timeout 5 --ak $AK --endpoint $EP

# Smart snippets (relevant text fragments)
python3 scripts/xiaosu_search.py "固态电池进展" --main-text --ak $AK --endpoint $EP

# Site-specific search
python3 scripts/xiaosu_search.py "宁德时代" --sites finance.eastmoney.com --ak $AK --endpoint $EP

# Raw JSON output (for programmatic use)
python3 scripts/xiaosu_search.py "query" --json --ak $AK --endpoint $EP

# Pagination
python3 scripts/xiaosu_search.py "query" --count 20 --offset 20 --ak $AK --endpoint $EP

Script Options

Direct API Usage (curl)

curl -s -G "https://searchapi.xiaosuai.com/search/$XIAOSU_ENDPOINT/smart" \
  --data-urlencode "q=<query>" \
  --data-urlencode "count=10" \
  -H "Authorization: Bearer $XIAOSU_AK"

Guidelines

• For news monitoring: use --freshness Day + --count 20
• For deep research: use --content --content-type MARKDOWN --content-timeout 5
• For fact-checking: use --main-text for relevant fragments without full content overhead
• Rate limit: 429 = QPS exceeded, back off and retry
• Results have a score field (0-1) indicating relevance; prioritize high-score results
• API reference details: see references/api-docs.md