skills.rest
OpenSenseNova
OpenSenseNovaOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sn-search-image

Search Google Images via Serper.dev API and return image URLs, page URLs, and source metadata.

5.3k|380|Updated Apr 14, 2026
Search Tags:#api#Python#image search#Search#Serper#image urls#google images
One-click install
npx skills add https://github.com/OpenSenseNova/SenseNova-Skills --skill sn-search-image
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sn-search-image
Source: https://github.com/OpenSenseNova/SenseNova-Skills/tree/main/skills/sn-search-image
Command: npx skills add https://github.com/OpenSenseNova/SenseNova-Skills --skill sn-search-image

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Finding relevant images on the web programmatically requires an API-backed search pipeline. This Skill queries Google Images through Serper.dev and returns structured candidate results including image URLs, page URLs, titles, and source domains, removing the need to scrape search pages manually.

Core Features & Use Cases

  • Google-backed image search: Query Serper.dev's image endpoint with configurable result count, country bias (--gl), and language bias (--hl).
  • Flexible output modes: Print formatted results, raw JSON, image URLs only, or page URLs only, with optional result limits and JSON file export.
  • Use Case: While building a slide deck or article, run a query like "renewable energy infographic" to collect candidate image URLs and their source pages for review and attribution.

Quick Start

Ask the agent to search for images matching a query such as "modern office workspace" and list the top image URLs with their source pages.

Frequently Asked Questions about sn-search-image

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

FAQPage Schema
How do I search Google Images from the command line?▼

Run the serper_image_search.py script with a query string and a SERPER_API_KEY environment variable set. It posts to the Serper.dev images endpoint and prints formatted results including titles, image URLs, page URLs, and sources.

How do I get only image URLs from Serper image search?▼

Pass the --image-urls-only flag to print one direct image URL per line, and add --limit to cap how many URLs are printed. Use --page-urls-only instead if you want the source page links.

Can I bias image search results by country or language?▼

Yes, use the --gl flag with a two-letter country code such as 'us' and the --hl flag with a language code such as 'en'. These values are included in the Serper API request payload.

Why does the Serper image search script fail immediately?▼

The script exits if the SERPER_API_KEY environment variable is missing or empty. It also fails on HTTP errors from Serper or invalid JSON responses, printing the HTTP status and error details.

What are the limitations of Serper.dev image search?▼

The skill only returns candidate result metadata such as URLs and titles; it does not download, filter, or verify images. Result quality and quota depend on your Serper.dev API plan and query phrasing.

Related Skills

Explore More Content & Communication Skills→
vuralserhat86vuralserhat86
43

keyword_research

Analyze SEO keywords for search volume, difficulty, and search intent.

Community
Intermediate
the-cyber-boardroomthe-cyber-boardroom
11

infographic-gen

Generate infographics and slide decks from briefs or documents.

Official
Intermediate
bravebrave
164

images-search

Search for images via the Brave Search API with filtering options.

Official
Basic
gked2121gked2121

stock-photo-finder

Search Unsplash, Pexels, and Pixabay for stock photos by keywords and filters.

Community
Basic