← 返回 Skills 市场

Google SERP Maps Search API

Name: Google SERP Maps Search API
Author: justserpapi

作者 justserpapi · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install justserpapi-google-maps-search

功能描述

Call GET /api/v1/google/maps/search for Google SERP Maps Search through Just Serp API with query.

使用说明 (SKILL.md)

Google SERP Maps Search

Use this focused Just Serp API skill for Google SERP Maps Search. It targets GET /api/v1/google/maps/search. Required inputs are query. OpenAPI describes it as: Get Google maps Search data, including business listings, ratings and contact data, and coordinate and location targeting, for local market research and lead discovery.

Endpoint Scope

Group key: google
Endpoint key: maps/search
Group family: Google SERP
Skill slug: justserpapi-google-maps-search

Operation	Version	Method	Path	OpenAPI summary
`mapsSearch`	`v1`	`GET`	`/api/v1/google/maps/search`	Search

Inputs

Parameter	In	Required by	Optional by	Type	Notes
`country`	`query`	n/a	all	`string`	Set the target country code (e.g., 'us', 'uk') to localize results. See \x3Ca href="/reference/google-countries">Google Countries\x3C/a>
`data`	`query`	n/a	all	`string`	Advanced Google Maps data parameter used for certain map/place-specific result filters and views. It can be copied from a Google Maps URL after applying filters, or constructed for specific place searches. This parameter is commonly used when type = "place". If you’re not familiar with it, you can leave it empty
`domain`	`query`	n/a	all	`string`	The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See \x3Ca href="/reference/google-domains">Google Domains\x3C/a>
`language`	`query`	n/a	all	`string`	Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See \x3Ca href="/reference/google-language">Google Language\x3C/a>
`ll`	`query`	n/a	all	`string`	GPS coordinates for the search origin. Format: '@\x3Clatitude>,\x3Clongitude>,\x3Czoom>'. Required for precise localization and pagination
`page`	`query`	n/a	all	`integer`	The results pagination offset. Start at 0 and increment by 20 for each subsequent page
`place_id`	`query`	n/a	all	`string`	The unique Google Place ID to directly retrieve information for a specific location
`query`	`query`	all	n/a	`string`	The search query for Google Maps (e.g., 'restaurants', 'hospitals in New York')

Request body: none documented; send parameters through path or query arguments.

Version Choice

Use mapsSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: mapsSearch.

node {baseDir}/bin/run.mjs --operation "mapsSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"\x3Cquery>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, URLs, keywords, and filters unchanged.

Environment

Required: JUST_SERP_API_KEY
Pass the API key with --api-key "$JUST_SERP_API_KEY"; do not paste key values into chat messages, screenshots, or logs.
Project site: Just Serp API.
Authentication details: Just Serp API Docs.

Output Focus

State the operation ID and endpoint path used, for example mapsSearch on /api/v1/google/maps/search.
Echo the required lookup scope (query) before summarizing results.
Prioritize fields that support this endpoint purpose: Get Google maps Search data, including business listings, ratings and contact data, and coordinate and location targeting, for local market research and lead discovery.
Return raw JSON only after the short, endpoint-specific summary.
If the backend errors, include the backend payload and the exact operation ID.

安全使用建议

Install only if you are comfortable sending Google Maps search terms, optional GPS coordinates, place IDs, and localization parameters to Just Serp API using your API key. Avoid submitting sensitive personal locations or confidential business searches unless that third-party handling is acceptable for your use case.

能力标签

requires-sensitive-credentials

能力评估

✓ Purpose & Capability

The stated purpose, documentation, manifest, and helper script all align around one GET request to /api/v1/google/maps/search for maps search results.

ℹ Instruction Scope

The skill asks the agent to collect missing required inputs and preserve user-provided query values; optional location, place, country, language, and pagination parameters are documented.

✓ Install Mechanism

The artifacts contain documentation, a generated operations manifest, and a Node helper script; there are no package install hooks, hidden setup steps, or self-modifying behavior.

ℹ Credentials

Requiring JUST_SERP_API_KEY and Node is proportionate for a third-party API integration, but users should understand that precise map searches or coordinates leave the local environment.

✓ Persistence & Privilege

Manual review found no persistence, background worker, local indexing, local file reads, credential-store access, privilege escalation, or mutation of user data.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install justserpapi-google-maps-search
安装完成后，直接呼叫该 Skill 的名称或使用 /justserpapi-google-maps-search 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Updated operation summary for `mapsSearch` from "Maps Search" to "Search". - Removed the file `skill-card.md`. - SKILL.md and documentation files updated for clarity and consistency with API documentation. - No functional or interface changes to endpoint usage or input parameters.

v1.0.0

Initial publish

元数据

Slug justserpapi-google-maps-search

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题