Cloudsway SmartSearch

Cloudsway SmartSearch

An MCP server integrating the Cloudsway Smart Search API, providing web search functionality for MCP clients.

1
Stars
0
Forks
0
Releases

Overview

SmartSearch MCP Server integrates the Cloudsway Smart Search API to deliver web search capabilities to MCP clients. It exposes a dedicated tool called SmartSearch that returns structured results suitable for downstream processing. The server supports web search with pagination, language selection, freshness filtering, and optional site restrictions, enabling precise queries. It responds with a JSON payload containing a queryContext with the original query and a webPages.value array of results. Each result includes fields such as name, url, displayUrl, snippet, datePublished, dateLastCrawled, siteName, thumbnailUrl, and score. Input parameters for the tool include query (required), count (default 10; accepted values 10,20,30,40,50), offset (default 0), setLang (language code, defaults to en), freshness, and sites. The README provides error handling (200 success and 429 rate limit) and instructions for API key management and environment configuration via SERVER_KEY, which must be provided in deployment (example MCP service config shown). Entry point is src/smartsearch/smartsearch.py. This implementation enables MCP clients to perform optimized, structured web searches with configurable filters.

Details

Owner
Cloudsway-AI
Language
JavaScript
License
Updated
2025-12-07

Features

Web search with advanced filters

Provides pagination, language, freshness, and site filtering to refine results for MCP clients.

Structured JSON output

Returns a JSON payload suitable for downstream processing with fields like queryContext and webPages.value[].

MCP-compatible deployment

Server is designed for MCP deployment with a dedicated service configuration example.

Configurable input parameters

Tool accepts query, count, offset, setLang, freshness, and sites with sensible defaults.

Rich response metadata

Includes datePublished, dateLastCrawled, siteName, thumbnailUrl, and score for each result.

API key management

Obtain Endpoint and AccessKey from Cloudsway and set as SERVER_KEY in environment.

Deployment details and entry point

Entry file located at src/smartsearch/smartsearch.py; ensure SERVER_KEY is provided.

Example MCP service configuration

Shows an example JSON configuration using npx @cloudsway-ai/smartsearch with SERVER_KEY.

Tags

web searchMCPCloudswaySmart Searchstructured JSONpaginationlanguage filtersite filteringfreshnessAPI keydeploymentexample configurationMCP deploymentserver configurationsearch resultsHTTP 429entry pointMCP service