Cloudsway Search

Fast web search for AI agents. Use when: user asks to search, Google something, look up info, find news, research topics. Better Chinese support than Brave/T...

Security Scan

The skill's code and instructions are consistent with a web-search API client that needs one API key and curl/jq; nothing in the package attempts unrelated access or persistence.

Purpose & Capability

Name/description, required binaries (curl, jq), declared env CLOUDSWAYS_AK, and the search.sh implementation all align with a web-search API client. Minor note: the script calls https://truthapi.cloudsway.net while SKILL.md links to cloudsway.ai/docs — this is plausibly the API domain but you may want to confirm the domain is official.

Instruction Scope

SKILL.md instructs the agent to set CLOUDSWAYS_AK and run scripts/search.sh with a JSON payload. The script only reads its JSON argument and the single env var, validates input, calls the API, and formats the response — it does not read other files, credentials, or system state.

Install Mechanism

This is instruction-only plus a small shell script; there is no install step, no downloads, and nothing is written to disk beyond running the included script. Low install risk.

Credentials

Only CLOUDSWAYS_AK is required, which is proportional for calling a third-party search API. No other credentials or config paths are requested. The script uses the API key only in the Authorization header.

Persistence & Privilege

always:false and no code that modifies agent/system config. The skill does not persist state or attempt elevated privileges.

Assessment

This skill appears to do what it says: it forwards query parameters to the Cloudsway API and returns parsed results. Before installing, confirm that truthapi.cloudsway.net is an official Cloudsway endpoint (the SKILL.md points to cloudsway.ai), and only provide an API key with minimal scopes/limits. Be aware that enabling full content (enableContent) may cause page contents to be fetched and returned by the third-party service — avoid sending sensitive queries or secrets. If you need tighter control, create a scoped/test API key and review the provider's privacy/docs. If you want extra assurance, run the script locally with a test key to observe requests and responses.

🌐 Fast web search for AI agents — Simple, reliable, with smart content extraction.

Brave/Tavily alternative with excellent Chinese language support.

When to Use

✅ USE this skill when:

• "搜索 xxx" / "search xxx" / "Google xxx"
• "查一下 xxx" / "look up xxx"
• "有什么关于 xxx 的信息" / "find info about xxx"
• Real-time information needed
• News and current events
• Fact verification

❌ DON'T use this skill when:

• AI already knows the answer
• Math calculations
• Code-only tasks

Setup

1. Get free API key: https://www.cloudsway.ai
2. Set env: export CLOUDSWAYS_AK="your-key"

Usage

Simple search:

./scripts/search.sh '{"q": "your query"}'

Recent news:

./scripts/search.sh '{"q": "topic", "freshness": "Week", "count": 20}'

Deep research:

./scripts/search.sh '{"q": "topic", "enableContent": true, "mainText": true, "count": 20}'

Parameters

Param	Required	Default	Notes
q	✅	-	Search query
count	❌	10	10/20/30/40/50 only
freshness	❌	-	Day / Week / Month
enableContent	❌	false	Get full page content
mainText	❌	false	Smart excerpts (needs enableContent)

Why Cloudsway?

• ✅ Smart excerpts — AI-friendly content extraction
• ✅ Chinese optimized — Better than Brave/Tavily for 中文
• ✅ Free tier — Get started in 2 minutes
• ✅ Fast — Low latency responses

Links

• 🔑 Get API Key: https://www.cloudsway.ai
• 📖 Docs: https://www.cloudsway.ai/docs