Google Image Search Skill

When to Use

• Finding images to illustrate technical articles or research
• Adding visuals to presentations
• Enriching Obsidian notes with relevant images
• Batch image search for multiple topics
• Generating image search configs from plain text lists

Requirements

• Google Custom Search API key and Search Engine ID
• OpenRouter API key (for LLM selection)
• llm CLI installed at

  /opt/homebrew/bin/llm

.env

Google-Custom-Search-JSON-API-KEY=your_key
Google-Custom-Search-CX=your_cx
OPENROUTER_API_KEY=your_openrouter_key

Modes of Operation

1. Simple Query

python3 ~/.claude/skills/google-image-search/scripts/google_image_search.py \
  --query "neural interface wearable device" \
  --output-dir ./images \
  --num-results 5

2. Batch Processing

python3 ~/.claude/skills/google-image-search/scripts/google_image_search.py \
  --config image_queries.json \
  --output-dir ./images \
  --llm-select

3. Generate Config from Terms

python3 ~/.claude/skills/google-image-search/scripts/google_image_search.py \
  --generate-config \
  --terms "AlterEgo wearable" "sEMG electrodes" "BCI headset" \
  --output my_queries.json

4. Enrich Obsidian Note

python3 ~/.claude/skills/google-image-search/scripts/google_image_search.py \
  --enrich-note ~/Brains/brain/Research/neural-interfaces.md

1. Detects Obsidian vault and attachments folder
2. Uses LLM to extract visual-worthy terms from note
3. Searches for images for each term
4. Downloads best images to attachments folder
5. Inserts image embeds below relevant headings
6. Creates backup before modifying note

Key Options

--query TEXT

--config FILE

--generate-config

--terms

--enrich-note FILE

--output-dir DIR

--urls-only

--llm-select

--no-llm-select

--num-results N

--dry-run

JSON Config Format

{
  "id": "unique-id",
  "heading": "Display Heading",
  "description": "Context for what image to find",
  "query": "Google search query",
  "numResults": 5,
  "selectionCriteria": "What makes a good image",
  "requiredTerms": ["must", "have"],
  "optionalTerms": ["bonus", "terms"],
  "excludeTerms": ["stock", "clipart"],
  "preferredHosts": ["official-site.com"],
  "selectionCount": 2
}

references/api_config_reference.md

Scoring System

• Required terms: -80 if missing, +30 if all present
• Optional terms: +5 per match
• Exclude terms: -50 per match
• Preferred hosts: +25 if trusted, -5 if unknown
• MIME type: +5 for PNG/JPEG, -10 for GIF
• Resolution: +10 for high res, -10 for low res
• File size: -5 if very small

LLM Selection

• Title and URL metadata
• Scoring reasons
• Selection criteria

Obsidian Integration

• Auto-detects vault root via

  .obsidian

  folder
• Uses configured attachments folder (default:

  Attachments

  )
• Generates Obsidian-style embeds:

  ![[image.png|alt text]]

• Creates backup before modifying notes

Script Files

google_image_search.py

api.py

config.py

download.py

evaluate.py

llm_select.py

obsidian.py

output.py