Google Custom Search Skill

Name: Google Custom Search Skill
Availability: InStock
Author: dingdyan

Retrieve Google Custom Search API results with a CX identifier and return formatted JSON.

Updated Apr 5, 2026

Search Tags:#api #web search #citations #google #structured json #custom search

Ready to run

npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill google-custom-search-skill

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Google Custom Search Skill
Source: https://github.com/dingdyan/openclaw-workspace-v2/tree/main/skills/google-custom-search
Command: npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill google-custom-search-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly locate relevant information on the web by running Google Custom Search from an agent-friendly tool, avoiding manual browsing and copy-paste research.

Core Features & Use Cases

Targeted Web Search with CX: Use a specific Programmable Search Engine ID (CX) to narrow results, or configure a “Whole Web” CX for broader coverage.
API-Key Driven Queries: Runs via Google’s Custom Search API using GOOGLE_API_KEY with an optional GOOGLE_CX default.
Structured JSON Output: Returns predictable fields (title, link, snippet, displayLink) plus meta (totalResults, searchTime) for downstream reasoning or citation.

Quick Start

Ask your agent to run a search for "OpenClaw AI agent framework" using the Google Custom Search Skill and return the top 10 results.

Frequently Asked Questions about Google Custom Search Skill

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

FAQPage Schema

How do I get structured JSON web search results from Google?▼

To get structured JSON web search results, this Skill queries the Google Custom Search API using your GOOGLE_API_KEY and CX identifier, returning fields like title, link, snippet, and totalResults for programmatic consumption.

How do I run a targeted web search using a Programmable Search Engine ID?▼

You run a targeted web search by providing a specific Programmable Search Engine ID (CX value) as an argument or via the GOOGLE_CX environment variable to narrow the Google Custom Search results to your configured scope.

What do I need to configure before using Google Custom Search API queries?▼

Before using Google Custom Search API queries, you need a valid GOOGLE_API_KEY and a CX value (from an argument or GOOGLE_CX) to authenticate requests and define your search engine scope.

Can I retrieve whole-web search results instead of targeted CX results?▼

Yes, you can retrieve whole-web search results by configuring a valid CX value specifically set to whole-web mode, allowing the Google Custom Search API to return broader coverage beyond targeted sites.

What metadata is included in the JSON output from Google Custom Search?▼

The JSON output from Google Custom Search includes per-result fields like title, link, snippet, and displayLink, plus meta totals such as totalResults and searchTime for downstream reasoning or citation.

Why use structured JSON for web search instead of manual browsing?▼

Structured JSON for web search avoids manual browsing and copy-paste research by delivering predictable fields and meta totals directly from the Google Custom Search API, enabling agent-friendly downstream reasoning and citation.