/install acedatacloud-google-search
Google Search (SERP)
Search the web through AceDataCloud's Google SERP API.
Authentication
export ACEDATACLOUD_API_TOKEN="your-token-here"
Quick Start
curl -X POST https://api.acedata.cloud/serp/google \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query": "latest AI news", "search_type": "search"}'
Search Types
| Type | Description | Returns |
|---|---|---|
search |
Web search (default) | Organic results, knowledge graph, rich snippets |
images |
Image search | Image URLs, titles, sources |
news |
News articles | Headlines, sources, publish dates |
maps |
Map results | Locations, coordinates |
places |
Local businesses/places | Name, address, rating, reviews |
videos |
Video results | Video URLs, thumbnails, duration |
Parameters
POST /serp/google
{
"query": "your search query",
"search_type": "search",
"country": "us",
"language": "en",
"time_range": "qdr:w",
"number": 10,
"page": 1
}
| Parameter | Type | Description |
|---|---|---|
query |
string | Search query (required) |
search_type |
string | One of: search, images, news, maps, places, videos |
country |
string | Country code (e.g., "us", "uk", "cn", "jp") |
language |
string | Language code (e.g., "en", "zh", "ja") |
time_range |
string | Time filter (see below) |
number |
int | Number of results per page |
page |
int | Page number for pagination |
Time Range Options
| Value | Period |
|---|---|
qdr:h |
Past hour |
qdr:d |
Past 24 hours |
qdr:w |
Past week |
qdr:m |
Past month |
qdr:y |
Past year |
Response Structure
Web search returns structured data including:
organic_results: Main search results with title, link, snippetknowledge_graph: Entity information panel (when available)related_searches: Related query suggestions
MCP Server
pip install mcp-serp
Or hosted: https://serp.mcp.acedata.cloud/mcp
Key tool: serp_google_search
Gotchas
- Default search type is
"search"(web). Always specifysearch_typefor non-web searches - Country and language codes affect result localization significantly
numbercontrols results per page, not total results — usepagefor pagination- Time range only applies to web search and news, not images or places
- Image search returns thumbnail and full-size URLs — use full-size for downloads
- Places search works best with location-specific queries (e.g., "restaurants near Times Square")
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install acedatacloud-google-search - After installation, invoke the skill by name or use
/acedatacloud-google-search - Provide required inputs per the skill's parameter spec and get structured output
What is Google Search?
Search the web using Google via AceDataCloud API. Use when searching for web pages, images, news, maps, local places, or videos. Supports localization, time... It is an AI Agent Skill for Claude Code / OpenClaw, with 160 downloads so far.
How do I install Google Search?
Run "/install acedatacloud-google-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Google Search free?
Yes, Google Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Google Search support?
Google Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Google Search?
It is built and maintained by Germey (@germey); the current version is v1.0.0.