← Back to Skills Marketplace
justserpapi

Google SERP Search API

by justserpapi · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
32
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install justserpapi-google-search
Description
Call GET /api/v1/google/search for Google SERP Search through Just Serp API with query.
README (SKILL.md)

Google SERP Search

Use this focused Just Serp API skill for Google SERP Search. It targets GET /api/v1/google/search. Required inputs are query. OpenAPI describes it as: Get Google search SERP data, including organic results, ads, and knowledge panels, for keyword tracking and SERP analysis across markets.

Endpoint Scope

  • Group key: google
  • Endpoint key: search
  • Group family: Google SERP
  • Skill slug: justserpapi-google-search
Operation Version Method Path OpenAPI summary
search v1 GET /api/v1/google/search Search

Inputs

Parameter In Required by Optional by Type Notes
country query n/a all string Set the target country code (e.g., 'us', 'uk') to localize results. See \x3Ca href="/reference/google-countries">Google Countries\x3C/a>
cr query n/a all string Limits results to search results from specific countries. Format: 'countryXX'. See \x3Ca href="/reference/google-cr-countries">Google CR Countries\x3C/a>
domain query n/a all string The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See \x3Ca href="/reference/google-domains">Google Domains\x3C/a>
filter query n/a all string Toggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disable
html query n/a all boolean Set to true to return the raw HTML of the Google search results page alongside the structured data
ibp query n/a all string Parameter (ibp) used to control certain Google UI expansions or rendering modes (commonly in local/business result views). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
kgmid query n/a all string Knowledge Graph entity/listing ID (KGMID) used to retrieve details for a specific entity. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
language query n/a all string Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See \x3Ca href="/reference/google-language">Google Language\x3C/a>
location query n/a all string The textual location name (e.g., 'New York, NY') to localize the search results
lr query n/a all string Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See \x3Ca href="/reference/google-lr-language">Google LR Language\x3C/a>
lsig query n/a all string Signature parameter (lsig) sometimes required for certain Knowledge Graph / local map view features. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
ludocid query n/a all string Google local business CID (place identifier). Used to target a specific Google Business Profile / local listing. Advanced parameter — if you don’t know it, you can omit it
nfpr query n/a all string Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them
page query n/a all integer The results page number. Use 0 for the first page, 1 for the second, and so on
query query all n/a string The search query for Google Search (e.g., 'coffee shops', 'how to bake a cake')
safe query n/a all string SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it
si query n/a all string Cached search context parameter (si) used to reproduce specific Google search result views/context (e.g. some Knowledge Graph tabs). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty
tbs query n/a all string Advanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty
uds query n/a all string Advanced filter token (uds) used for specific Google search sub-filters. This is an advanced technical parameter, usually provided by Google in filter options/results — if you’re not familiar with it, you can leave it empty
uule query n/a all string Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it

Request body: none documented; send parameters through path or query arguments.

Version Choice

Use search for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: search.

node {baseDir}/bin/run.mjs --operation "search" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"\x3Cquery>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, URLs, keywords, and filters unchanged.

Environment

  • Required: JUST_SERP_API_KEY
  • Pass the API key with --api-key "$JUST_SERP_API_KEY"; do not paste key values into chat messages, screenshots, or logs.
  • Project site: Just Serp API.
  • Authentication details: Just Serp API Docs.

Output Focus

  • State the operation ID and endpoint path used, for example search on /api/v1/google/search.
  • Echo the required lookup scope (query) before summarizing results.
  • Prioritize fields that support this endpoint purpose: Get Google search SERP data, including organic results, ads, and knowledge panels, for keyword tracking and SERP analysis across markets.
  • Return raw JSON only after the short, endpoint-specific summary.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
Install only if you are comfortable sending search terms, optional location/localization fields, and your Just Serp API key to Just Serp API. Avoid using it for secrets, private investigations, regulated data, or precise location searches unless that disclosure is acceptable.
Capability Tags
requires-sensitive-credentials
Capability Assessment
✓ Purpose & Capability
The artifacts consistently describe one capability: calling Just Serp API's GET /api/v1/google/search endpoint with a required search query and optional documented Google search filters.
✓ Instruction Scope
Runtime instructions are narrow: ask for missing required parameters, preserve user-provided query/filter values, call the helper for the documented operation, and summarize endpoint results.
✓ Install Mechanism
The package contains SKILL.md, generated operation docs, and a Node helper; it requires node and JUST_SERP_API_KEY but shows no install hooks, package installation, or background setup.
ℹ Credentials
The helper sends the API key plus user-supplied query and optional localization/search parameters to https://api.justserpapi.com, which is expected for this search API but can reveal sensitive search intent if users provide it.
✓ Persistence & Privilege
Manual review found no local file reads or writes, subprocess execution, credential-store access, scheduled jobs, persistence, privilege escalation, or unrelated network destinations.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justserpapi-google-search
  3. After installation, invoke the skill by name or use /justserpapi-google-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial publish
Metadata
Slug justserpapi-google-search
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Google SERP Search API?

Call GET /api/v1/google/search for Google SERP Search through Just Serp API with query. It is an AI Agent Skill for Claude Code / OpenClaw, with 32 downloads so far.

How do I install Google SERP Search API?

Run "/install justserpapi-google-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Google SERP Search API free?

Yes, Google SERP Search API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Google SERP Search API support?

Google SERP Search API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Google SERP Search API?

It is built and maintained by justserpapi (@justserpapi); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments