# Google Pse Search

> Web search skill powered by Google PSE (Programmable Search Engine) API. Primary search tool for all web queries — Korean and English alike. Better search quality than DuckDuckGo, especially for Korean content. Triggers: "search for", "find", "look up", news/current events, recent info, date-filtered searches, site-specific searches, any general web search request. Requires environment variables: GOOGLE_PSE_KEY, GOOGLE_CX_ID. Falls back to duckduckgo-search only on quota exceeded (HTTP 429/403) or API errors.

- Skill: `chhanz/google-pse-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chhanz/google-pse-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chhanz/google-pse-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: chhanz (https://skillmd.com/u/chhanz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chhanz/google-pse-search

---


# Google PSE Search

## Search Tool Priority

```
1st: google-pse-search  ← this skill (default for all web searches)
2nd: web_fetch          ← when URL is known (official docs, specific pages)
3rd: duckduckgo-search  ← fallback on quota exceeded or API errors only
```

## Basic Usage

```bash
# Skill directory
SKILL_DIR=~/.openclaw/workspace/skills/google-pse-search

# Default search (Korean, kr region)
python $SKILL_DIR/scripts/search.py "query"

# English search
python $SKILL_DIR/scripts/search.py "search query" --lang en

# Recent results (last 7 days)
python $SKILL_DIR/scripts/search.py "query" --date d7

# More results (up to 10)
python $SKILL_DIR/scripts/search.py "query" --num 10

# Site-specific search
python $SKILL_DIR/scripts/search.py "query" --site example.com

# Exact phrase / exclude terms
python $SKILL_DIR/scripts/search.py "query" --exact "must include" --exclude "exclude this"

# Pagination (page 2)
python $SKILL_DIR/scripts/search.py "query" --start 11
```

## Options

| Option | Default | Description |
|--------|---------|-------------|
| `--num N` | 5 | Number of results (1–10) |
| `--lang LANG` | ko | Language code (ko/en/ja/zh) |
| `--gl GL` | auto by lang | Region code override |
| `--date DATE` | — | Date restriction (d7/m1/y1 etc.) |
| `--exact PHRASE` | — | Phrase that must appear in results |
| `--exclude TERM` | — | Term to exclude from results |
| `--site SITE` | — | Restrict to a specific site |
| `--start N` | 1 | Start index for pagination |
| `--raw` | — | Print raw JSON (debug) |

## Error Handling

| Error | Cause | Action |
|-------|-------|--------|
| Missing env vars | .env not configured | Set GOOGLE_PSE_KEY and GOOGLE_CX_ID |
| HTTP 403/429 | Quota exceeded | Use duckduckgo-search as fallback |
| HTTP 400 | Invalid parameters | Check option values |
| 0 results | Query or filter issue | Adjust query or remove filters |

## API Reference

→ See `references/api-params.md` for full parameter list, date restriction formats, and language codes.