gemini-websearch

Perform web searches via Gemini CLI with caching and validation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/d-oit/do-novelist-ai --skill gemini-websearch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gemini-websearch
Source: https://github.com/d-oit/do-novelist-ai/tree/main/.claude/skills/gemini-websearch
Command: npx skills add https://github.com/d-oit/do-novelist-ai --skill gemini-websearch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill performs advanced web searches using Gemini CLI in headless mode, with intelligent caching, result validation, and analytics to improve research efficiency.

Core Features & Use Cases

  • Caching: MD5-keyed cache with TTL to minimize repeated queries.
  • Validation: Result quality scoring and relevance checks to filter low-quality results.
  • Analytics: Track latency, cache performance, and query quality for continuous improvement.
  • Content Extraction: Optional extraction of structured results from search responses.

Quick Start

Basic search: python .claude/skills/gemini-websearch/scripts/search.py "search for React 19 features"

Frequently Asked Questions about gemini-websearch

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

FAQPage Schema
How do I perform web searches with caching and validation?

Web searches with caching store results by MD5-keyed query hash with a 1-hour TTL to avoid repeated requests, while validation scoring filters low-quality results. This Skill implements both via Gemini CLI's google_web_search tool in headless mode, returning JSON-formatted validated results.

Can I track search performance and cache hit rates?

Yes. This Skill provides built-in analytics that track latency, cache performance metrics, and query quality scores. Analytics help identify bottlenecks and measure the efficiency gains from caching across single and batch search operations.

How do I run batch web searches with retry logic?

Batch mode processes multiple queries in a single execution with optional retry on failure. The Skill accepts batch inputs, applies the same validation and caching logic to each query, and outputs aggregated JSON results with per-query analytics.

What format do search results return in?

Search results return in JSON format with structured fields including validated content, relevance scores, latency metrics, and cache status. This format enables downstream processing, filtering, and integration into analytics pipelines.

Does this work for both documentation lookups and user-requested queries?

Yes. The Skill handles both use cases—searching for current documentation, release notes, and API references, as well as general user-requested web queries. The same caching, validation, and analytics apply across all query types.

What happens if a search query repeats within the cache window?

Repeated queries within the 1-hour TTL return cached results instantly without hitting the web search tool, reducing latency and API calls. Cache misses trigger a fresh search, update the cache, and reset the TTL counter.