How do I install the Google Pse Search skill?

Run npx skillmds@latest add chhanz/google-pse-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Google Pse Search safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Pse Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Google Pse Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Google Pse Search?

chhanz (@chhanz) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Google Pse Search by chhanz — Agent Skill

Name: Google Pse Search
Author: chhanz

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.

chhanz bff0245 2 files · 3.1 KB Updated Sep 17, 2026

File contents

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

# 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.

---name: google-pse-searchdescription: 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.---# 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 directorySKILL_DIR=~/.openclaw/workspace/skills/google-pse-search# Default search (Korean, kr region)python $SKILL_DIR/scripts/search.py "query"# English searchpython $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 searchpython $SKILL_DIR/scripts/search.py "query" --site example.com# Exact phrase / exclude termspython $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.

Frequently asked questions