Cloudsway SmartSearch CLI

Web search CLI via Cloudsway SmartSearch API. Get real-time search results with snippets and full content extraction.

Installation

npm install -g cloudsway-search

Or run directly with npx:

npx cloudsway-search "your query"

Setup

1. Get your API key at https://aisearch.cloudsway.net
2. Set environment variable:

   export CLOUDSWAYS_AK="your-api-key"

Usage

cloudsway-search <query> [options]

Options

| Option | Description | |--------|-------------| | --count <n> | Results count: 10, 20, 30, 40, or 50 (default: 10) | | --freshness <period> | Time filter: Day, Week, or Month | | --content | Enable full content extraction | | --mainText | Return smart excerpts (requires --content) | | --json | Output raw JSON | | --help | Show help |

Examples

# Basic search
cloudsway-search "latest AI news"

# Recent results only
cloudsway-search "OpenAI GPT" --freshness Week --count 20

# Deep research with smart excerpts
cloudsway-search "RAG architecture" --content --mainText

# JSON output for piping
cloudsway-search "Claude AI" --json | jq '.webPages.value[0]'

Use with Claude Code / AI Agents

This CLI is designed to work seamlessly with AI coding assistants:

# Claude Code can run this directly
npx cloudsway-search "React best practices 2026" --content --mainText

License

MIT