google-image-search

Query Google Custom Search API to fetch and embed relevant images.

3|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/pinion05/skills --skill google-image-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-image-search
Source: https://github.com/pinion05/skills/tree/main/google-image-search
Command: npx skills add https://github.com/pinion05/skills --skill google-image-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of finding and embedding relevant images for articles, presentations, research, or Obsidian notes, saving time and improving visual quality.

Core Features & Use Cases

  • Simple Query: Fetches images for a single topic using Google Custom Search API with AI-assisted selection.
  • Batch Processing: Executes image searches for multiple terms from a JSON config.
  • Config from Terms: Generates JSON search configs from plain terms using an LLM, reducing manual setup.
  • Obsidian Enrichment: Inserts image embeds below headings in Obsidian notes and manages attachments.
  • Use Case: Enrich a technical article with visuals by automatically sourcing, scoring, and embedding top images.

Quick Start

Run a simple query to fetch 5 images and save them to a local directory: python3 ~/.claude/skills/google-image-search/scripts/google_image_search.py --query "neural interface wearable" --output-dir ./images --num-results 5

Frequently Asked Questions about google-image-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate image search and embedding for Obsidian notes?

Automating image search for Obsidian notes involves querying the Google Custom Search API and using an LLM to select relevant visuals. This process inserts image embeds below headings and manages attachments automatically.

What do I need to set up before automating image discovery for technical articles?

Before automating image discovery, you need a Google Custom Search API key and CX, plus an OpenRouter API key for LLM-based selection. Credentials must be stored in a .env file with the llm CLI installed.

Can I batch process image searches for multiple research terms?

Yes, you can batch process image searches by executing queries for multiple terms from a JSON config. You can also generate the JSON search config from plain terms using an LLM to reduce manual setup.

How does LLM-based selection work for note enrichment visuals?

LLM-based selection for note enrichment works by scoring and selecting top images fetched via Google Custom Search API. The AI evaluates relevance to ensure articles and notes receive appropriate visual context.

What is the best way to source relevant visuals for presentations without manual searching?

The best way to source visuals for presentations is running a Python script that queries Google Custom Search and uses AI-assisted selection. This fetches and saves top images to a local directory automatically.

Are there limitations when using Google Custom Search API for automated image curation?

Limitations of using Google Custom Search for image curation include dependency on external API quotas and the necessity of the llm CLI at a specific path. Results require LLM scoring to ensure visual relevance.