Agent Skills
› NeverSight/learn-skills.dev
› google-search
google-search
GitHub通过AceDataCloud API执行Google搜索，支持网页、图片、新闻、地图、地点及视频等多种类型。具备本地化、时间过滤和分页功能，返回结构化数据。
Trigger Scenarios
需要查找最新网络信息或新闻
搜索特定地区的本地商家或位置
查找图片或视频资源
获取带有知识图谱的搜索结果
Install
npx skills add NeverSight/learn-skills.dev --skill google-search -g -y
SKILL.md
Frontmatter
{
"name": "google-search",
"license": "Apache-2.0",
"metadata": {
"author": "acedatacloud",
"version": "1.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."
}
Google Search (SERP)
Search the web through AceDataCloud's Google SERP API.
Setup: See authentication for token setup.
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", "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",
"type": "search",
"country": "us",
"language": "en",
"range": "qdr:w",
"number": 10,
"page": 1
}
| Parameter | Type | Description |
|---|---|---|
query |
string | Search query (required) |
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") |
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
Gotchas
- Default search type is
"search"(web). Always specifytypefor non-web searches - Country and language codes affect result localization significantly
numbercontrols results per page, not total results — usepagefor pagination- Time range (
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")
MCP:
pip install mcp-serp| Hosted:https://serp.mcp.acedata.cloud/mcp| See all MCP servers
Version History
- e0220ca Current 2026-07-05 22:54
