Google SERP Ai Mode API for Openclaw

A dedicated Openclaw skill to retrieve Google AI Mode search results, including AI-generated answers, citations, and follow-up prompts via the Just Serp API.

justserpapi
v1.0.1
Jun 9, 2026
0
534
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install justserpapi-google-ai-mode

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-ai-mode 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 Ai Mode API?

The Google SERP Ai Mode API skill is an integration designed to fetch and analyze Google Search AI-generated summaries (often known as Search Generative Experience or SGE). By connecting your AI agents to the Just Serp API, this skill allows them to monitor how brands and topics are represented in automated search overviews, fetching generated answers, follow-up prompts, and cited links with minimal latency.

Integrating this tool with Openclaw Skills empowers developers and marketers to automate SEO tracking for AI-driven search engines. By tracking citation sources and generated queries programmatically, teams can adapt their content strategy to stay visible in the evolving AI search landscape.

Google SERP Ai Mode API Use Cases

  • Monitor brand visibility within Google's AI-generated search overviews and answers.
  • Track and extract cited links from Google SGE responses to optimize content for AI discovery.
  • Programmatically capture follow-up prompts to understand conversational search journeys.
  • Localize search queries to analyze regional differences in AI-generated search results.

How Google SERP Ai Mode API Works

  1. The AI agent triggers the aiMode operation, accepting parameters like the search query and optional location markers.
  2. The skill constructs an authenticated GET request to the Just Serp API endpoint /api/v1/google/ai-mode.
  3. The backend executes the localized search and extracts structured AI search data, including generated responses and cited links.
  4. The skill returns the structured JSON data back to the AI agent or caller for automated evaluation or visualization.

Google SERP Ai Mode API Setup

To use this skill, ensure you have Node.js installed on your system. You will also need a valid API key from Just Serp API.

Set your environment variable:

export JUST_SERP_API_KEY="your_api_key_here"

Run the endpoint directly from your CLI:

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

Google SERP Ai Mode API Data Schema & Taxonomy

The skill processes query parameters and returns structured Google AI Mode data. Below is the input schema:

Parameter Type Required Description
query string Yes The search query for Google Search (e.g., 'coffee shops').
country string No Target country code (e.g., 'us', 'uk') to localize results.
location string No Textual location name (e.g., 'New York, NY') for localized queries.
html boolean No Set to true to return raw HTML alongside structured data.
safe string No SafeSearch filter setting ('active' or 'off').
uule string No Encoded location string (UULE) for precise positioning.

Response Schema

The response from the underlying Just Serp API includes standard JSON containing:

  • generated_answers: The automated text response generated by Google's AI.
  • cited_links: List of websites referenced inside the generated text.
  • follow_up_prompts: Recommended subsequent queries offered to searchers.

Google SERP Ai Mode API Advanced Features

  • Hyper-Local Targeting: Utilize coordinates or text-based locations (location) alongside advanced UULE parameters for granular local AI tracking.
  • SGE Competitive Analysis: Compare cited domains across multiple localized queries to trace competitor dominance in AI search.
  • Raw HTML Extraction: Enable the html parameter to retrieve the complete raw DOM for custom regex parsing or page layout auditing.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins node
Github Stars: 0
forks: 0

Featured*