← 返回 Skills 市场

Google SERP Images Search API

Name: Google SERP Images Search API
Author: justserpapi

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

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install justserpapi-google-images-search

功能描述

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

使用说明 (SKILL.md)

Google SERP Images Search

Use this focused Just Serp API skill for Google SERP Images Search. It targets GET /api/v1/google/images/search. Required inputs are query. OpenAPI describes it as: Get Google images Search data, including image URLs and metadata, for filtered image discovery for research and monitoring workflows.

Endpoint Scope

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

Operation	Version	Method	Path	OpenAPI summary
`imagesSearch`	`v1`	`GET`	`/api/v1/google/images/search`	Search

Inputs

Parameter	In	Required by	Optional by	Type	Notes
`chips`	`query`	n/a	all	`string`	Additional suggested search terms (chips) to filter images. Values are obtained from previous responses
`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>
`end_date`	`query`	n/a	all	`string`	End date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241231')
`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
`image_color`	`query`	n/a	all	`string`	Filter images by a dominant color (e.g., 'red', 'blue', 'bw' for black and white, 'trans' for transparent)
`image_type`	`query`	n/a	all	`string`	Filter by image type. Supported values: 'face', 'photo', 'clipart', 'lineart', 'animated'
`imgar`	`query`	n/a	all	`string`	Filter by image aspect ratio. Supported values: 's' (Square), 't' (Tall), 'w' (Wide), 'xw' (Panoramic)
`imgsz`	`query`	n/a	all	`string`	Filter by image size. Supported values: 'l' (Large), 'm' (Medium), 'i' (Icon), and specific resolutions like '4mp', '10mp'
`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>
`licenses`	`query`	n/a	all	`string`	Filter by usage rights and licenses. Supported values: 'f' (Free to use), 'fc' (Commercial use), 'cl' (Creative Commons)
`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>
`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
`period_unit`	`query`	n/a	all	`string`	Time unit for 'recent' image results. Supported values: 's' (Second), 'n' (Minute), 'h' (Hour), 'd' (Day), 'w' (Week), 'm' (Month), 'y' (Year)
`period_value`	`query`	n/a	all	`string`	Time duration value used with 'period_unit' (e.g., 15 for 15 days). Default: 1
`query`	`query`	all	n/a	`string`	The search query for images (e.g., 'mountain landscape', 'luxury cars')
`safe`	`query`	n/a	all	`string`	SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it
`start_date`	`query`	n/a	all	`string`	Start date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241201')
`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 imagesSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: imagesSearch.

node {baseDir}/bin/run.mjs --operation "imagesSearch" --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 imagesSearch on /api/v1/google/images/search.
Echo the required lookup scope (query) before summarizing results.
Prioritize fields that support this endpoint purpose: Get Google images Search data, including image URLs and metadata, for filtered image discovery for research and monitoring workflows.
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 image search queries, filters, localization parameters, and your Just Serp API key to Just Serp API. Avoid secrets, personal data, regulated data, or precise location details in queries unless you have reviewed the provider's privacy and retention terms.

能力标签

requires-sensitive-credentials

能力评估

✓ Purpose & Capability

The skill purpose, documentation, and helper code all align around one GET endpoint for Just Serp API Google image search.

ℹ Instruction Scope

Instructions ask the agent to pass user-provided query terms and filters unchanged; this is expected for search but can transmit sensitive terms, localization fields, or raw HTML requests to the API provider.

✓ Install Mechanism

The artifact contains documentation, generated operation metadata, and a single Node helper; no install script, package dependency execution, or hidden setup behavior was found.

✓ Credentials

The required Node runtime and JUST_SERP_API_KEY are proportionate for calling the documented external API endpoint.

✓ Persistence & Privilege

No persistence, background execution, local file indexing, privilege escalation, destructive actions, or credential-store access was found; the API key is only sent as the documented request header.

如何使用

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

版本历史

v1.0.1

- Operation summary for imagesSearch updated from "Images Search" to "Search". - skill-card.md file removed. - Minor documentation and formatting updates in SKILL.md and generated files.

v1.0.0

Initial publish

元数据

Slug justserpapi-google-images-search

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题