skills.rest
dingdyan
dingdyanCOMMUNITY
Explore all skills by this author →
GitHub

Google Custom Search Skill

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
One-click install
npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill google-custom-search-skill
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Marketing & Sales Skills→
omriariavomriariav
7

gws-search

Perform Google Programmable Search Engine web searches with structured JSON output.

Community
Intermediate
semaes111semaes111

search

Retrieve Google search results via Bright Data's SERP API with pagination.

Community
Intermediate
okenwaokenwa

research

Conduct multi-source web research and generate cited reports.

Community
Intermediate
KISHOR403KISHOR403

google-image-search

Searches Google Custom Search API for images and returns metadata.

Community
Advanced