← 返回 Skills 市场

小宿智能搜索

Name: 小宿智能搜索
Author: dr-xiaoming

作者 Dr-xiaoming · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

157

总下载

当前安装

版本数

在 OpenClaw 中安装

/install xiaosu-search

功能描述

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

使用说明 (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

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install xiaosu-search
安装完成后，直接呼叫该 Skill 的名称或使用 /xiaosu-search 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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

元数据

Slug xiaosu-search

版本 1.0.2

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 3

常见问题