CLI wrapper around Google Search backed by the kimi-webbridge browser daemon. Runs inside the user's real Chrome session — no API key, no login loop — and emits JSON on stdout.
| Command | Usage | Returns |
|---|---|---|
search |
google-cli search <query> [--limit 10] [--hl en] |
[{title, url, snippet}] |
result |
google-cli result <url> |
{url, title, description, text} |
All output:
{"ok": true, "data": ...}or on failure (non-zero exit):
{"ok": false, "error": {"code": "...", "message": "..."}}kimi-webbridge daemon running on 127.0.0.1:10086 — install from https://www.kimi.com/features/webbridge.
Pre-built binary (recommended): download google-cli-{platform}.tar.gz from Releases and extract. macOS users: clear the Gatekeeper quarantine once with xattr -d com.apple.quarantine ./google-cli.
Available platforms: darwin-{arm64,amd64}, linux-{amd64,arm64}, windows-{amd64,arm64}.
Build from source (requires Go 1.25+):
go build -o google-cli .
./google-cli --help./google-cli search "claude code" --limit 3
./google-cli result "https://code.claude.com/docs/en/overview"EU / anonymous browsers may hit consent.google.com on first Google navigation. When detected, search errors with code consent_required — accept it once in Chrome, then retry.
Google frequently renames DOM classes. The working selectors, rationale, and failure modes are pinned in ARCHAEOLOGY.md. When parsing breaks, re-run the site-archaeology protocol from that file and update both google/search.go and ARCHAEOLOGY.md together.
google-cli/
├── main.go # entrypoint
├── browser/client.go # kimi-webbridge HTTP client (+ EvaluateJSON helper)
├── output/output.go # JSON contract: {ok, data} / {ok, error}
├── google/
│ ├── common.go # evaluateWithRetry (handles CDP context races)
│ ├── search.go # search command backend
│ └── result.go # result command backend
├── cmd/
│ ├── root.go
│ ├── search.go
│ └── result.go
├── ARCHAEOLOGY.md # DOM-selector field notes
└── README.md
MIT — see LICENSE.