← 返回 Skills 市场

Google SERP Search Light API

Name: Google SERP Search Light API
Author: justserpapi

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

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install justserpapi-google-search-light

功能描述

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

使用说明 (SKILL.md)

Google SERP Search Light

Use this focused Just Serp API skill for Google SERP Search Light. It targets GET /api/v1/google/search/light. Required inputs are query. OpenAPI describes it as: Get Google light Search SERP data, including essential result data, for high-volume monitoring and fast rank checks.

Endpoint Scope

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

Operation	Version	Method	Path	OpenAPI summary
`searchLight`	`v1`	`GET`	`/api/v1/google/search/light`	Light 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>
`cr`	`query`	n/a	all	`string`	Limits results to search results from specific countries. Format: 'countryXX'. See \x3Ca href="/reference/google-cr-countries">Google CR 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>
`filter`	`query`	n/a	all	`string`	Toggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disable
`html`	`query`	n/a	all	`boolean`	Set to true to return the raw HTML of the Google search results page alongside the structured data
`ibp`	`query`	n/a	all	`string`	Parameter (ibp) used to control certain Google UI expansions or rendering modes (commonly in local/business result views). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
`kgmid`	`query`	n/a	all	`string`	Knowledge Graph entity/listing ID (KGMID) used to retrieve details for a specific entity. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
`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
`lr`	`query`	n/a	all	`string`	Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See \x3Ca href="/reference/google-lr-language">Google LR Language\x3C/a>
`lsig`	`query`	n/a	all	`string`	Signature parameter (lsig) sometimes required for certain Knowledge Graph / local map view features. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
`ludocid`	`query`	n/a	all	`string`	Google local business CID (place identifier). Used to target a specific Google Business Profile / local listing. Advanced parameter — if you don’t know it, you can omit it
`nfpr`	`query`	n/a	all	`string`	Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them
`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 Google Search (e.g., 'coffee shops', 'how to bake a cake')
`safe`	`query`	n/a	all	`string`	SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it
`si`	`query`	n/a	all	`string`	Cached search context parameter (si) used to reproduce specific Google search result views/context (e.g. some Knowledge Graph tabs). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
`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
`uds`	`query`	n/a	all	`string`	Advanced filter token (uds) used for specific Google search sub-filters. This is an advanced technical parameter, usually provided by Google in filter options/results — 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 searchLight for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: searchLight.

node {baseDir}/bin/run.mjs --operation "searchLight" --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 searchLight on /api/v1/google/search/light.
Echo the required lookup scope (query) before summarizing results.
Prioritize fields that support this endpoint purpose: Get Google light Search SERP data, including essential result data, for high-volume monitoring and fast rank checks.
Return raw JSON only after the short, endpoint-specific summary.
If the backend errors, include the backend payload and the exact operation ID.

安全使用建议

Before installing, understand that searches and optional localization parameters may be sent to Just Serp API. Avoid using secrets, highly personal information, confidential business investigations, or sensitive location context in queries unless you are comfortable sharing them with that service.

能力标签

requires-sensitive-credentials

能力评估

✓ Purpose & Capability

The reported behavior, sending search queries and localization parameters to api.justserpapi.com, fits a search/SERP integration.

ℹ Instruction Scope

Search queries, location, country, and uule-style localization fields may be sensitive; the scanner reports limited user-facing disclosure or guardrails around that data flow.

✓ Install Mechanism

No artifact-backed evidence of unusual install steps, package mutation, persistence, or background execution was provided or found during local inspection.

ℹ Credentials

Network access to a third-party search provider is proportionate for this purpose, but users should treat submitted search terms and localization data as shared with that provider.

✓ Persistence & Privilege

No evidence indicates credential harvesting, privileged local access, persistent workers, or durable storage beyond the expected API request behavior.

如何使用

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

版本历史

v1.0.0

Initial publish

元数据

Slug justserpapi-google-search-light

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题