← Back to Skills Marketplace
dr-xiaoming

小宿智能搜索

by Dr-xiaoming · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
157
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install xiaosu-search
Description
Web search via 小宿智能搜索 V2 API (XiaoSu Smart Search). Use when internet search, web lookup, real-time information retrieval, news search, or fact-checking is n...
README (SKILL.md)

小宿智能搜索 V2

Web search API for real-time internet information retrieval.

Setup (Required)

Set these environment variables before using this skill:

export XIAOSU_AK="\x3Cyour-access-key>"
export XIAOSU_ENDPOINT="\x3Cyour-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 "\x3Cquery>" \
  --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

Flag Description
--count N Results count: 10/20/30/40/50
--freshness X Time filter: Day, Week, Month
--offset N Pagination offset
--content Enable long-form content extraction
--content-type T TEXT (default), MARKDOWN, HTML
--content-timeout S Content read timeout (max 10s)
--main-text Enable smart snippet extraction
--sites HOST Restrict to site
--block HOST Exclude site
--no-cache Disable 10-min result cache
--json Raw JSON output

Direct API Usage (curl)

curl -s -G "https://searchapi.xiaosuai.com/search/$XIAOSU_ENDPOINT/smart" \
  --data-urlencode "q=\x3Cquery>" \
  --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
Usage Guidance
This skill is internally consistent and only needs an API key and an endpoint for the XiaoSu search service. Before installing, verify you trust the XiaoSu service (https://www.xiaosuai.com) because the provided API key will be sent to searchapi.xiaosuai.com. Do not reuse highly privileged or unrelated credentials as XIAOSU_AK. Prefer storing the key in a secure secrets manager or OpenClaw's secure env mechanism rather than plaintext shell profiles. If you need stronger assurance, review network traffic or run the script in an isolated environment to confirm it only communicates with the documented endpoint.
Capability Analysis
Type: OpenClaw Skill Name: xiaosu-search Version: 1.0.2 The xiaosu-search skill is a legitimate implementation of a web search tool using the XiaoSu Smart Search API. The Python script (scripts/xiaosu_search.py) uses standard libraries to interact with the API endpoint (searchapi.xiaosuai.com) and properly sanitizes query parameters using urllib.parse.urlencode. There is no evidence of data exfiltration, malicious execution, or harmful prompt injection instructions in SKILL.md.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the included Python script all implement a web-search client for the same API. The declared credentials (access key and endpoint) are appropriate for an external search API.
Instruction Scope
Runtime instructions only describe setting two env vars and running the script or curl against the documented API. The instructions do not ask the agent to read unrelated files, secrets, or system config.
Install Mechanism
There is no install spec; the skill is instruction-only plus a small Python script that uses only standard libraries. Nothing is downloaded from external/obscure URLs or written to nonstandard locations.
Credentials
The skill requests exactly two values (XIAOSU_AK and XIAOSU_ENDPOINT) which are necessary to authenticate to the XiaoSu search API. No unrelated credentials or high-privilege env vars are requested.
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges or modify other skills. Autonomous invocation is allowed (platform default) and is not combined with other red flags.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install xiaosu-search
  3. After installation, invoke the skill by name or use /xiaosu-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Security audit passed: no hardcoded credentials
v1.0.1
- Updated usage instructions to reference environment variables $XIAOSU_AK and $XIAOSU_ENDPOINT instead of sample access keys in example commands. - Modified curl example to use environment variables for credentials and endpoint path. - No changes to code or functionality; documentation only.
v1.0.0
Initial release: web search with time filter, content extraction, smart snippets, site filtering
Metadata
Slug xiaosu-search
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is 小宿智能搜索?

Web search via 小宿智能搜索 V2 API (XiaoSu Smart Search). Use when internet search, web lookup, real-time information retrieval, news search, or fact-checking is n... It is an AI Agent Skill for Claude Code / OpenClaw, with 157 downloads so far.

How do I install 小宿智能搜索?

Run "/install xiaosu-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 小宿智能搜索 free?

Yes, 小宿智能搜索 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 小宿智能搜索 support?

小宿智能搜索 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 小宿智能搜索?

It is built and maintained by Dr-xiaoming (@dr-xiaoming); the current version is v1.0.2.

💬 Comments