← 返回 Skills 市场

Google SERP Local Search API

Name: Google SERP Local Search API
Author: justserpapi

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

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install justserpapi-google-local-search

功能描述

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

使用说明 (SKILL.md)

Google SERP Local Search

Use this focused Just Serp API skill for Google SERP Local Search. It targets GET /api/v1/google/local/search. Required inputs are query. OpenAPI describes it as: Get Google local Search data, including business listings, ratings, and contact details, for local lead generation and competitor research.

Endpoint Scope

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

Operation	Version	Method	Path	OpenAPI summary
`localSearch`	`v1`	`GET`	`/api/v1/google/local/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>
`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>
`location`	`query`	n/a	all	`string`	The textual location name (e.g., 'New York, NY') to localize the search results
`ludocid`	`query`	n/a	all	`string`	The unique Google Business Profile listing ID (CID) to get details for a specific business
`page`	`query`	n/a	all	`integer`	The results page number. Use 0 for the first page, 1 for the second, and so on
`query`	`query`	all	n/a	`string`	The search query for local businesses (e.g., 'pizza', 'dentist near me')
`tbs`	`query`	n/a	all	`string`	Advanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty
`uule`	`query`	n/a	all	`string`	Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it

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

Version Choice

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

Run This Endpoint

Supported operation IDs in this skill: localSearch.

node {baseDir}/bin/run.mjs --operation "localSearch" --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 localSearch on /api/v1/google/local/search.
Echo the required lookup scope (query) before summarizing results.
Prioritize fields that support this endpoint purpose: Get Google local Search data, including business listings, ratings, and contact details, for local lead generation and competitor research.
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 trust Just Serp API with the searches and locations you submit and are comfortable using your API key and quota for this endpoint. Avoid pasting the key into chat or logs; use the documented environment variable.

能力标签

requires-sensitive-credentials

能力评估

✓ Purpose & Capability

The stated purpose is to call GET /api/v1/google/local/search and the artifacts implement only that single local-search operation with documented query parameters.

✓ Instruction Scope

Runtime instructions are scoped to collecting missing endpoint parameters, preserving user-provided search inputs, and summarizing or returning endpoint results.

✓ Install Mechanism

The skill consists of markdown, generated endpoint metadata, and a Node helper; it declares the required node binary and JUST_SERP_API_KEY environment requirement.

ℹ Credentials

It sends user-provided search, location, and localization parameters to api.justserpapi.com, which is expected for the integration, and may consume API quota.

ℹ Persistence & Privilege

No file writes, background processes, privilege changes, or local persistence were found; the only sensitive item is the API key used for the outbound request header.

如何使用

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

版本历史

v1.0.1

- Updated endpoint OpenAPI summary for clarity ("Local Search" → "Search") - Removed the redundant skill-card.md file for a cleaner project structure - Minor documentation improvements and cleanup in SKILL.md and generated docs - No breaking changes to usage or required parameters

v1.0.0

Initial publish

元数据

Slug justserpapi-google-local-search

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题