# Send Google Search Grounding 3 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-search-grounding-3",
    "name": "Google Search Grounding 3",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/phucanh08/google-search-grounding-3",
    "canonicalUrl": "https://clawhub.ai/phucanh08/google-search-grounding-3",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/google-search-grounding-3",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-search-grounding-3",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "install.sh",
      "lib/google_search.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/google-search-grounding-3"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-search-grounding-3",
    "downloadUrl": "https://openagent3.xyz/downloads/google-search-grounding-3",
    "agentUrl": "https://openagent3.xyz/skills/google-search-grounding-3/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-search-grounding-3/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-search-grounding-3/agent.md"
  }
}
```
## Documentation

### Google Search 🔍

Google web search powered by Gemini 2.5 Flash with Search Grounding + Custom Search API.

⭐ This is the PRIMARY web search tool. Prefer over built-in web_search (Perplexity).

### Requirements

GOOGLE_API_KEY environment variable
Enable in Google Cloud Console: Gemini API, Custom Search JSON API

### Configuration

Env VariableDefaultDescriptionGOOGLE_API_KEY—Required. Google API keyGOOGLE_CSE_CX—Custom Search Engine ID (required for raw/image modes)GOOGLE_SEARCH_LANGheDefault language code (he, en, ar, ja, etc.)GOOGLE_SEARCH_COUNTRYILDefault country code (IL, US, DE, etc.)

Set in OpenClaw config:

{
  "env": {
    "GOOGLE_API_KEY": "AIza...",
    "GOOGLE_SEARCH_LANG": "he",
    "GOOGLE_SEARCH_COUNTRY": "IL"
  }
}

### Script Location

python3 skills/google-search/lib/google_search.py <mode> "query" [options]

### Output Modes

Text mode (default): Best for most use cases. Clean readable output with answer, sources, and search queries.
JSON mode (--json): For programmatic processing. Includes confidence scores, grounding supports, and search queries.

### search — Grounded Search (Default, Recommended)

Gemini 2.0 Flash + Google Search tool → synthesized answer with numbered citations.

python3 lib/google_search.py search "query" [--lang he] [--country IL] [--json]

When to use: Questions, current events, "what is X", Hebrew queries, anything needing a direct answer.

Examples:

# Hebrew (default)
python3 lib/google_search.py search "מזג אוויר תל אביב"

# English override
python3 lib/google_search.py search "latest AI news" --lang en --country US

# JSON output
python3 lib/google_search.py search "OpenAI GPT-5 release date" --json

Output format:

<Synthesized answer text>

Sources:
  1. Source Title
     https://example.com/article
  2. Another Source
     https://example.com/other

### raw — Raw Search Results

Custom Search JSON API → links with titles and snippets.

python3 lib/google_search.py raw "query" [-n 5] [--lang he] [--country IL] [--json]

When to use: Need actual URLs, research, building reference lists, when you want links not answers.

Examples:

python3 lib/google_search.py raw "python asyncio tutorial" -n 5
python3 lib/google_search.py raw "best restaurants tel aviv" --json
python3 lib/google_search.py raw "rust vs go performance" -n 3 --lang en

Output format:

1. Page Title
   https://example.com/page
   Brief snippet from the page...

2. Another Page
   https://example.com/other
   Another snippet...

### image — Image Search

Custom Search image search → image URLs with titles.

python3 lib/google_search.py image "query" [-n 5] [--lang he] [--country IL] [--json]

When to use: Finding images, visual references, thumbnails.

Examples:

python3 lib/google_search.py image "aurora borealis" -n 5
python3 lib/google_search.py image "תל אביב חוף" --json

### Options Reference

OptionApplies ToDescriptionDefault--lang CODEallLanguage code (he, en, ar, ja…)env GOOGLE_SEARCH_LANG (he)--country CODEallCountry code (IL, US, DE…)env GOOGLE_SEARCH_COUNTRY (IL)-n NUMraw, imageNumber of results (1–10)10--jsonallStructured JSON outputoff

Language resolution order: --lang flag → GOOGLE_SEARCH_LANG env → None (auto)
Country resolution order: --country flag → GOOGLE_SEARCH_COUNTRY env → None (auto)

### Error Handling

Missing API key: Clear error message with setup instructions.
429 Rate Limit: Automatic retry once after 5-second wait.
Network errors: Descriptive error with cause.
No results: Clean "No results found." message.
Timeout: 30-second timeout on all HTTP requests.

### Quota & Rate Limits

APIFree TierRate LimitGemini API (grounded search)Generous free tier~15 RPM (free), higher on paidCustom Search JSON API (raw/image)100 queries/day10K queries/day (paid)

On 429 errors: Script retries once automatically. If quota exhausted, fall back to built-in web_search (Perplexity).

### Multilingual Support

Works with queries in any language. Hebrew is the default:

# Hebrew (default, no flags needed)
python3 lib/google_search.py search "חדשות טכנולוגיה"

# English
python3 lib/google_search.py search "technology news" --lang en

# Arabic
python3 lib/google_search.py search "أخبار التكنولوجيا" --lang ar

### Install

bash skills/google-search/install.sh
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: phucanh08
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/google-search-grounding-3)
- [Send to Agent page](https://openagent3.xyz/skills/google-search-grounding-3/agent)
- [JSON manifest](https://openagent3.xyz/skills/google-search-grounding-3/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/google-search-grounding-3/agent.md)
- [Download page](https://openagent3.xyz/downloads/google-search-grounding-3)