功能描述

Performs real-time web searches to retrieve up-to-date online information, news, research data, and fact-checking results.

使用说明 (SKILL.md)

\r \r

AI Search Skill (Web Search for AI Agents)\r

Name: smartsearch
Author: prismheart

\r This skill enables AI agents and LLM systems to perform web search and retrieve real-time information from the internet.\r \r It works similarly to modern search engines such as:\r \r

Google\r
Bing\r
Perplexity\r
Brave Search\r
Tavily\r \r The skill allows AI systems to access up-to-date information, including:\r \r
news\r
websites\r
research articles\r
documentation\r
trending topics\r \r ---\r \r

When Should This Skill Be Used\r

\r Use this skill when the user asks about:\r \r • searching the internet \r • latest news or current events \r • information from websites \r • online research topics \r • finding articles or documentation \r • verifying facts \r • gathering information from multiple sources \r \r Example queries:\r \r

"latest AI news"\r
"search the web for vector database benchmarks"\r
"find information about GPT models"\r
"what happened in AI this week"\r
"latest updates from OpenAI"\r
"research agentic AI architecture"\r \r ---\r \r

Example Use Cases\r

\r

Web Search\r

\r Search the internet for general information.\r \r Example:\r \r

\r
search the web for latest AI developments\r
\r
```\r
\r
---\r
\r
## News Search\r
\r
Retrieve recent news or trending events.\r
\r
Example:\r
\r
```\r
\r
latest AI news this week\r
\r
```\r
\r
---\r
\r
## Research Tasks\r
\r
AI agents gathering information from multiple sources.\r
\r
Example:\r
\r
```\r
\r
research agentic AI architecture\r
\r
```\r
\r
---\r
\r
## Fact Checking\r
\r
Verify claims using multiple web sources.\r
\r
Example:\r
\r
```\r
\r
check if GPT-5 has been released\r
\r
````\r
\r
---\r
\r
# Quick Setup\r
\r
1. **Get your API Key**\r
\r
Sign up at:\r
\r
https://cloudsway.ai\r
\r
2. **Set environment variable**\r
\r
```bash\r
export CLOUDSWAYS_AK="your-api-key"\r
````\r
\r
That's it. The skill is ready to use.\r
\r
---\r
\r
# Quick Start\r
\r
## Method 1: Using the Script\r
\r
```bash\r
cd ~/scripts/search\r
./scripts/search.sh '{"q": "your search query"}'\r
```\r
\r
### Examples\r
\r
```bash\r
# Basic search\r
./scripts/search.sh '{"q": "latest AI developments"}'\r
\r
# Search with time filter\r
./scripts/search.sh '{"q": "OpenAI news", "freshness": "Week", "count": 20}'\r
\r
# Deep research\r
./scripts/search.sh '{"q": "Agentic AI architecture", "enableContent": true, "mainText": true}'\r
```\r
\r
---\r
\r
## Method 2: Direct API Call\r
\r
```bash\r
curl -s -G \\r
  --url "https://aisearchapi.cloudsway.net/api/search/smart" \\r
  --header "Authorization: ${CLOUDSWAYS_AK}" \\r
  --data-urlencode "q=your search query" \\r
  --data-urlencode "count=20" \\r
  --data-urlencode "freshness=Week"\r
```\r
\r
### Real-world Example\r
\r
```bash\r
curl -s -G \\r
  --url "https://aisearchapi.cloudsway.net/api/search/smart" \\r
  --header "Authorization: ${CLOUDSWAYS_AK}" \\r
  --data-urlencode "q=latest AI news February 2026" \\r
  --data-urlencode "count=20" \\r
  --data-urlencode "freshness=Week" \\r
  --data-urlencode "enableContent=true" \\r
  --data-urlencode "mainText=true"\r
```\r
\r
---\r
\r
# API Reference\r
\r
## Endpoint\r
\r
```\r
GET https://aisearchapi.cloudsway.net/api/search/smart\r
```\r
\r
---\r
\r
## Headers\r
\r
| Header        | Type   | Value       | Description           |\r
| ------------- | ------ | ----------- | --------------------- |\r
| Authorization | String | `{YOUR_AK}` | Your assigned API Key |\r
\r
---\r
\r
## Request Parameters\r
\r
| Parameter      | Required | Type    | Default | Description                    |\r
| -------------- | -------- | ------- | ------- | ------------------------------ |\r
| q              | Yes      | String  | -       | Search query                   |\r
| count          | No       | Integer | 10      | Must be 10 / 20 / 30 / 40 / 50 |\r
| freshness      | No       | String  | null    | Day / Week / Month             |\r
| offset         | No       | Integer | 0       | Pagination offset              |\r
| enableContent  | No       | Boolean | false   | Extract full text              |\r
| contentType    | No       | String  | TEXT    | HTML / MARKDOWN / TEXT         |\r
| contentTimeout | No       | Float   | 3.0     | Extraction timeout             |\r
| mainText       | No       | Boolean | false   | Smart summary fragments        |\r
\r
---\r
\r
# Response Format\r
\r
```json\r
{\r
  "queryContext": {\r
    "originalQuery": "your search query"\r
  },\r
  "webPages": {\r
    "value": [\r
      {\r
        "name": "Article Title",\r
        "url": "https://example.com/article",\r
        "datePublished": "2026-02-27T15:46:11.0000000",\r
        "snippet": "Short summary...",\r
        "mainText": "Relevant excerpts...",\r
        "content": "Full webpage text...",\r
        "score": 0.85\r
      }\r
    ]\r
  }\r
}\r
```\r
\r
---\r
\r
# Content Strategy\r
\r
Choose the right field based on your needs:\r
\r
| Field    | Latency | Token Cost | Use Case         |\r
| -------- | ------- | ---------- | ---------------- |\r
| snippet  | Fast    | Low        | Quick browsing   |\r
| mainText | Medium  | Medium     | Focused research |\r
| content  | Slower  | High       | Deep analysis    |\r
\r
---\r
\r
# Recommended Settings\r
\r
### Quick Research\r
\r
```json\r
{"q": "topic", "count": 10}\r
```\r
\r
---\r
\r
### Focused Research\r
\r
```json\r
{"q": "topic", "count": 20, "freshness": "Week", "enableContent": true, "mainText": true}\r
```\r
\r
---\r
\r
### Deep Research\r
\r
```json\r
{"q": "topic", "count": 20, "enableContent": true, "contentType": "MARKDOWN"}\r
```\r
\r
---\r
\r
# Troubleshooting\r
\r
### Invalid JSON\r
\r
Use curl directly if the script fails.\r
\r
### Count Parameter Error\r
\r
Valid values:\r
\r
```\r
10 / 20 / 30 / 40 / 50\r
```\r
\r
### Environment Variable Missing\r
\r
Check configuration:\r
\r
```bash\r
echo $CLOUDSWAYS_AK\r
```\r
\r
---\r
\r
# Keywords\r
\r
web search\r
AI search\r
internet search\r
online search\r
search engine\r
Google search\r
Bing search\r
Perplexity search\r
Brave search\r
Tavily search\r
AI research tool\r
LLM web search\r
AI agent search\r
internet information retrieval\r
\r
---\r
\r
Last Updated: 2026-03-09\r
\r
```\r
\r
---\r

安全使用建议

This skill's code and SKILL.md call a Cloudsway search API and require an API key (CLOUDSWAYS_AK) plus curl and jq. However the registry metadata omitted those requirements (and the top-level homepage/source are missing), which is an inconsistency you should resolve before installing. Before proceeding: 1) Verify the publisher and origin (ask for a source repo or official Cloudsway documentation confirming aisearchapi.cloudsway.net). 2) Confirm you are comfortable providing CLOUDSWAYS_AK to this skill and consider creating a scoped or limited API key for testing. 3) Ensure your environment has curl and jq, and test the script on a non-sensitive account. 4) If you need higher assurance, ask the publisher to correct registry metadata (declare CLOUDSWAYS_AK and required binaries) or provide signed releases/source code. These steps will reduce risk from the observed metadata/code mismatch.

功能分析

Type: OpenClaw Skill Name: cloudsway-smartsearch Version: 1.0.6 The cloudsway-smartsearch skill is a legitimate web search integration for the Cloudsway AI API. The implementation in scripts/search.sh is well-structured, using jq for robust JSON parsing and curl's --data-urlencode flag to safely handle user-provided search queries, preventing command injection. No evidence of data exfiltration, malicious execution, or prompt injection was found.

能力评估

⚠ Purpose & Capability

The name/description match the code and SKILL.md (it calls a Cloudsway search API). However the registry metadata at the top claims no required env vars or homepage while SKILL.md and scripts clearly require CLOUDSWAYS_AK and use curl/jq. That mismatch between declared registry requirements and actual runtime needs is incoherent and could be an omission or packaging error.

⚠ Instruction Scope

SKILL.md and scripts instruct the agent to read CLOUDSWAYS_AK and perform HTTP calls to https://aisearchapi.cloudsway.net, returning webpage snippets/content. That behavior is within the stated purpose (web search) but the instructions reference an environment variable and binaries (curl, jq) that the registry metadata did not declare. The skill does not attempt to read unrelated system files or other creds.

✓ Install Mechanism

There is no install spec and only a small shell script is included. No remote downloads or archive extraction occur, so installation risk is low.

⚠ Credentials

The runtime requires a single API key (CLOUDSWAYS_AK), which is proportionate to calling a third-party search API. The concern is that the registry metadata did not list this required env var (top-level metadata claims none), creating a mismatch between what the skill actually needs and what was declared.

✓ Persistence & Privilege

The skill does not request always:true, does not modify other skills or system-wide settings, and has no config path requirements. It only needs transient access to an API key to call the remote endpoint.

版本历史

v1.0.6

cloudsway-smartsearch v1.0.6 - Expanded SKILL.md with detailed feature descriptions, usage instructions, and API documentation - Added setup and quick start guides for both script and direct API use - Provided comprehensive parameter and response reference tables - Included troubleshooting tips and recommended settings for various search tasks - Clearly outlined supported use cases and content strategies

元数据

Slug cloudsway-smartsearch

版本 1.0.6

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

smartsearch 是什么？

Performs real-time web searches to retrieve up-to-date online information, news, research data, and fact-checking results. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 121 次。

如何安装 smartsearch？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install cloudsway-smartsearch」即可一键安装，无需额外配置。

smartsearch 是免费的吗？

是的，smartsearch 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

smartsearch 支持哪些平台？

smartsearch 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 smartsearch？

由 nodunjj（@prismheart）开发并维护，当前版本 v1.0.6。

smartsearch