{"id":"41f7aa7f-8a92-4479-aa17-b45a188d3ee4","shortId":"cWC8gs","kind":"skill","title":"google-search","tagline":"Search the web using Google via AceDataCloud API. Use when searching for web pages, images, news, maps, local places, or videos. Supports localization, time filtering, and pagination. Returns structured results with titles, snippets, URLs, and rich data.","description":"# Google Search (SERP)\n\nSearch the web through AceDataCloud's Google SERP API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/serp/google \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\": \"latest AI news\", \"type\": \"search\"}'\n```\n\n## Search Types\n\n| Type | Description | Returns |\n|------|-------------|---------|\n| `search` | Web search (default) | Organic results, knowledge graph, rich snippets |\n| `images` | Image search | Image URLs, titles, sources |\n| `news` | News articles | Headlines, sources, publish dates |\n| `maps` | Map results | Locations, coordinates |\n| `places` | Local businesses/places | Name, address, rating, reviews |\n| `videos` | Video results | Video URLs, thumbnails, duration |\n\n## Parameters\n\n```json\nPOST /serp/google\n{\n  \"query\": \"your search query\",\n  \"type\": \"search\",\n  \"country\": \"us\",\n  \"language\": \"en\",\n  \"range\": \"qdr:w\",\n  \"number\": 10,\n  \"page\": 1\n}\n```\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `query` | string | Search query (required) |\n| `type` | string | One of: search, images, news, maps, places, videos |\n| `country` | string | Country code (e.g., \"us\", \"uk\", \"cn\", \"jp\") |\n| `language` | string | Language code (e.g., \"en\", \"zh\", \"ja\") |\n| `range` | string | Time filter (see below) |\n| `number` | int | Number of results per page |\n| `page` | int | Page number for pagination |\n\n## Time Range Options\n\n| Value | Period |\n|-------|--------|\n| `qdr:h` | Past hour |\n| `qdr:d` | Past 24 hours |\n| `qdr:w` | Past week |\n| `qdr:m` | Past month |\n| `qdr:y` | Past year |\n\n## Response Structure\n\nWeb search returns structured data including:\n- `organic_results`: Main search results with title, link, snippet\n- `knowledge_graph`: Entity information panel (when available)\n- `related_searches`: Related query suggestions\n\n## Gotchas\n\n- Default search type is `\"search\"` (web). Always specify `type` for non-web searches\n- Country and language codes affect result localization significantly\n- `number` controls results per page, not total results — use `page` for pagination\n- Time range (`range`) only applies to web search and news, not images or places\n- Image search returns thumbnail and full-size URLs — use full-size for downloads\n- Places search works best with location-specific queries (e.g., \"restaurants near Times Square\")\n\n> **MCP:** `pip install mcp-serp` | Hosted: `https://serp.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["google","search","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-google-search","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/google-search","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (2,604 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:02.509Z","embedding":null,"createdAt":"2026-05-18T13:21:32.907Z","updatedAt":"2026-05-18T19:14:02.509Z","lastSeenAt":"2026-05-18T19:14:02.509Z","tsv":"'/_shared/authentication.md':56 '/_shared/mcp-servers.md':357 '/mcp':352 '/serp/google':68,138 '1':155 '10':153 '24':222 'acedatacloud':10,48,72 'address':125 'affect':284 'ai':83 'alway':272 'api':11,52,73 'api.acedata.cloud':67 'api.acedata.cloud/serp/google':66 'appli':304 'application/json':79 'articl':111 'authent':55 'author':70 'avail':259 'bash':62 'bearer':71 'best':332 'businesses/places':123 'cn':181 'code':177,186,283 'content':77 'content-typ':76 'control':289 'coordin':120 'countri':145,174,176,280 'curl':63 'd':80,220 'data':40,242 'date':115 'default':95,266 'descript':90,158 'download':328 'durat':134 'e.g':178,187,338 'en':148,188 'entiti':255 'filter':28,194 'full':320,325 'full-siz':319,324 'googl':2,8,41,50 'google-search':1 'gotcha':265 'graph':99,254 'h':69,75,216 'headlin':112 'host':349 'hour':218,223 'imag':18,102,103,105,169,311,314 'includ':243 'inform':256 'instal':345 'int':198,205 'ja':190 'jp':182 'json':136 'knowledg':98,253 'languag':147,183,185,282 'latest':82 'link':251 'local':21,26,122,286 'locat':119,335 'location-specif':334 'm':229 'main':246 'map':20,116,117,171 'mcp':343,347,355 'mcp-serp':346 'month':231 'name':124 'near':340 'news':19,84,109,110,170,309 'non':277 'non-web':276 'number':152,197,199,207,288 'one':166 'option':212 'organ':96,244 'page':17,154,203,204,206,292,297 'pagin':30,209,299 'panel':257 'paramet':135,156 'past':217,221,226,230,234 'per':202,291 'period':214 'pip':344 'place':22,121,172,313,329 'post':65,137 'publish':114 'qdr':150,215,219,224,228,232 'queri':81,139,142,159,162,263,337 'quick':60 'rang':149,191,211,301,302 'rate':126 'relat':260,262 'requir':163 'respons':236 'restaur':339 'result':33,97,118,130,201,245,248,285,290,295 'return':31,91,240,316 'review':127 'rich':39,100 'search':3,4,14,42,44,86,87,92,94,104,141,144,161,168,239,247,261,267,270,279,307,315,330 'see':54,195,353 'serp':43,51,348 'serp.mcp.acedata.cloud':351 'serp.mcp.acedata.cloud/mcp':350 'server':356 'setup':53,59 'signific':287 'size':321,326 'skill' 'skill-google-search' 'snippet':36,101,252 'sourc':108,113 'source-acedatacloud' 'specif':336 'specifi':273 'squar':342 'start':61 'string':160,165,175,184,192 'structur':32,237,241 'suggest':264 'support':25 'thumbnail':133,317 'time':27,193,210,300,341 'titl':35,107,250 'token':58,74 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'total':294 'type':78,85,88,89,143,157,164,268,274 'uk':180 'url':37,106,132,322 'us':146,179 'use':7,12,296,323 'valu':213 'via':9 'video':24,128,129,131,173 'w':151,225 'web':6,16,46,93,238,271,278,306 'week':227 'work':331 'x':64 'y':233 'year':235 'zh':189","prices":[{"id":"09df702d-47ae-4f28-87f8-412b09265083","listingId":"41f7aa7f-8a92-4479-aa17-b45a188d3ee4","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:32.907Z"}],"sources":[{"listingId":"41f7aa7f-8a92-4479-aa17-b45a188d3ee4","source":"github","sourceId":"AceDataCloud/Skills/google-search","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/google-search","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:32.907Z","lastSeenAt":"2026-05-18T19:14:02.509Z"}],"details":{"listingId":"41f7aa7f-8a92-4479-aa17-b45a188d3ee4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"google-search","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"d416d06e355c4285fe888a201950450921aa0b12","skill_md_path":"skills/google-search/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/google-search"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"google-search","license":"Apache-2.0","description":"Search the web using Google via AceDataCloud API. Use when searching for web pages, images, news, maps, local places, or videos. Supports localization, time filtering, and pagination. Returns structured results with titles, snippets, URLs, and rich data.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-serp for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/google-search"},"updatedAt":"2026-05-18T19:14:02.509Z"}}