Google SERP Search Light API for Openclaw

A fast and optimized Openclaw Skills integration to query the Just Serp API and retrieve clean Google SERP data for high-volume rank monitoring.

justserpapi
v1.0.0
Jun 9, 2026
0
486
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install justserpapi-google-search-light

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install justserpapi-google-search-light using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Google SERP Search Light API?

The Google SERP Search Light API skill is a lightweight integration that leverages the Just Serp API to retrieve essential search engine results page (SERP) data. Specifically targeting the light search endpoint, it is optimized for speed, low resource consumption, and high-volume operations. By omitting heavy, unnecessary payload items, this tool allows developers, SEO agencies, and marketers to check rankings rapidly across hundreds or thousands of search queries.

As part of the Openclaw Skills ecosystem, this integration allows AI agents and workflows to effortlessly tap into localized Google Search data. It supports deep localization variables including specific countries, Google domains, languages, and precise coordinate or location strings via UULE, making it highly valuable for global and local SEO auditing.

Google SERP Search Light API Use Cases

  • High-Volume Keyword Tracking: Periodically monitor search positions for thousands of keywords without hitting performance bottlenecks.
  • Local SEO Rank Auditing: Localize search results using parameters like location, country, and UULE to see exactly what regional searchers see.
  • Competitor Intelligence: Regularly scrape SERP listings to track competitor movement on crucial commercial query phrases.
  • AI Research & Synthesis: Enable AI agents to pull real-time, lightweight search result snippets to ground answers in up-to-date web information.

How Google SERP Search Light API Works

  1. Triggering the Skill: The AI agent or automated script invokes the skill using the searchLight operation.
  2. Parameter Preparation: The workflow parses required parameters like query and any optional filters (such as country, language, or page).
  3. API Dispatch: The runner executes the request, passing the inputs to the Just Serp /api/v1/google/search/light endpoint authenticated via the secure environment key.
  4. Data Delivery: The API returns an optimized, lightweight SERP structure (along with raw HTML if requested), which is returned to the runner for subsequent parsing or AI context reinforcement.

Google SERP Search Light API Setup

Prerequisites

Ensure Node.js is installed on your local environment.

Configure Environment Variables

Configure your API Key dynamically by saving it to your environment:

export JUST_SERP_API_KEY="your_api_key"

Execution Syntax

Execute the CLI runner using the following schema:

node {baseDir}/bin/run.mjs --operation "searchLight" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"how to bake a cake"}'

Google SERP Search Light API Data Schema & Taxonomy

Parameter Reference

Parameter Type Required Description
query string Yes The search query for Google Search.
country string No Target country code (e.g., 'us', 'uk') to localize results.
domain string No Google domain to use for the search (e.g., 'google.com').
language string No Target language code (e.g., 'en', 'fr').
location string No Textual location name (e.g., 'New York, NY').
html boolean No Set to true to return the raw HTML of search results alongside structured data.
uule string No Encoded location string for ultra-precise localization.

Google SERP Search Light API Advanced Features

  • UULE Location Spoofing: Use encoded UULE coordinates for highly accurate local rank tracking down to specific neighborhoods.
  • Raw HTML Extraction: Retrieve both clean structured JSON data and full raw HTML layouts by setting the html parameter to true.
  • Advanced Search Parameters: Fine-tune query behaviors with support for Knowledge Graph entity listings, SafeSearch, search filters, and localized business profiles.
  • Scalable High-Volume Workflows: Built as one of the specialized Openclaw Skills to handle heavy concurrency and structured output formatting for multi-agent chains.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins node
Github Stars: 0
forks: 0

Featured*