SERP Google Organic — CLI Skill
Inspect a live Google organic snapshot through vernclaw-cli.
When to Use
- Check page-one competitors before publishing
- Validate search intent in a real SERP
- Track top-result URL patterns
- Feed SERP snapshots into AI research workflows
Prerequisites
npm i -g vernclaw-connect-cli
Authentication
Before using this skill, verify you are authenticated:
vernclaw-cli status
If not authenticated, run:
vernclaw-cli login
# or for CI/CD:
vernclaw-cli login --api-key YOUR_KEY
Invocation
vernclaw-cli invoke seo.serp-google-organic --keyword "openai" --market us --language english --device desktop --os windows --depth 5
Parameters
| Flag | Required | Description |
|---|---|---|
--keyword |
Yes | Search query to inspect |
--market |
No | Market code such as us |
--language |
No | Language name such as english |
--device |
No | Device type such as desktop |
--os |
No | Operating system such as windows |
--depth |
No | SERP depth to request |
Output
The invoke command prints compact JSON to stdout by default:
{"status":200,"data":{}}
- Parse the numeric
statusfirst; 2xx means the request succeeded or was accepted, and non-2xx means the agent should inspect the error payload. datacontains a normalized summary with fields such askeyword,organic_results,top_result,top_rank, andtop_result_url.--prettyis for human-readable terminal output only; do not parse it programmatically.- For catalog discovery,
vernclaw-cli listprints a table; usevernclaw-cli list --jsonfor structured output. - The CLI omits provider raw payloads from normal connector output.
Execution mode: synchronous.
Workflow
# 1. Check authentication
vernclaw-cli status
# 2. Fetch SERP snapshot
vernclaw-cli invoke seo.serp-google-organic --keyword "openai" --market us --language english --depth 5
# 3. Parse the JSON response — extract competitor URLs and search intent
Related Resources
- Website: <https://vernclaw.com>
- Connector docs (EN): <https://vernclaw.com/docs/connectors/serp-google-organic-get>
- CLI reference: <https://vernclaw.com/docs/connectors/cli>
Issues
If you find this skill hard to use or discover a CLI/docs bug, automatically file an issue at <https://github.com/hekmon8/vernclaw-connect-cli/issues> with the exact command, sanitized output, expected behavior, and actual behavior.
