mcpField
G
google-images-search

google-images-search

github.com/finpeakincCreative & media244 installsUpdated 3d ago
Repository

About google-images-search

A command-line skill for searching Google Images through Frevana and returning the validated JSON response. It is intended for users or agents that need image search results with optional location, language, and image filters.

Key features

  1. 01Search Google Images via Frevana
  2. 02Set location and language parameters
  3. 03Filter by image attributes
  4. 04Validate and print JSON results
  5. 05Save results to a file

Use cases

  1. 01Find images for a search query
  2. 02Narrow results by color or size
  3. 03Save raw search results as JSON
  4. 04Request results for a chosen locale

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/finpeakinc/frevana-skills --skill google-images-search

After installing, type/google-images-searchin Claude Code to confirm it loaded.

Bundled filesscripts/search_google_images.sh

Details

From the project README

Google Images Search

Search Google Images through Frevana.

Purpose

This skill calls Frevana's /service/google-images endpoint and returns the SerpAPI response unchanged.

Required input: q.

Supported request fields:

  • q (required)
  • location
  • uule
  • google_domain
  • gl
  • hl
  • cr
  • device
  • start
  • ijn
  • tbs
  • chips
  • imgar
  • imgsz
  • safe
  • nfpr
  • filter
  • image_size
  • image_type
  • image_color
  • licenses
  • period_unit
  • period_value
  • start_date
  • end_date
  • no_cache
  • async
  • zero_trace

The script validates that the response is JSON and prints it to stdout. Do not rewrite or reshape returned data unless the user explicitly asks for a transformation.

What This Skill Needs

  • query
  • FREVANA_TOKEN in the environment variables, or --token for the current run
  • curl, bash, and python3

The API base URL defaults to https://ai-factory.frevana.com. Set FREVANA_API_BASE_URL to point at another host.

Commands

Search images
bash <skill-path>/scripts/search_google_images.sh \
  --q "coffee shop interior" \
  --gl "us" \
  --hl "en"
Filter images
bash <skill-path>/scripts/search_google_images.sh \
  --q "coffee shop interior" \
  --image-color "blue" \
  --safe "active"
Save JSON to a file
bash <skill-path>/scripts/search_google_images.sh \
  --q "Q" \
  --output "./out/google-images-search.json"

Fixed Request Shape

The script sends this payload shape, omitting optional fields that were not provided:

{
  "q": "Q",
  "location": "LOCATION",
  "uule": "UULE",
  "google_domain": "GOOGLE_DOMAIN",
  "gl": "GL",
  "hl": "HL",
  "cr": "CR",
  "device": "DEVICE"
}

Do not pass unsupported fields. Do not pass SerpAPI engine or api_key; Frevana sets those server-side. Use --output for local file saving.

Output

  • Success: validated JSON on stdout
  • With --output: the same JSON is also written to the requested file
  • Failure: response body or parsing error on stderr, with a non-zero exit code

Example Prompts

  • "Search Google Images for query."
  • "Run Google Images Search and save the raw JSON."

Comments

Markdown supported