Google Search

该 Skill 通过 AceDataCloud 的 Google SERP 接口按关键词检索网页、图片、新闻、地图、地点或视频，支持国家、语言、时间范围与分页参数，返回标题、摘要、链接等结构化结果，并可选配合 MCP 工具使用。

Germey

热度 49.37

最近更新 2026-05-11 17:34:59

分类：搜索依赖：第三方 API / MCP 服务应用场景：研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add acedatacloud-google-search

Metadata

name: google-search
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.
license: Apache-2.0
metadata: {"author":"acedatacloud","version":"1.0"}
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-serp for tool-use.

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, snippet
knowledge_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 specify search_type for non-web searches
Country and language codes affect result localization significantly
number controls results per page, not total results — use page for 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")