Serper

ToolByIronHubVersion0.2.0

Google Search API oracle for Ironclaw via Serper.dev. Retrieves organic results, news, images, videos, local places, and shopping listings.

SearchWebSearchSEOSERP

Use Cases

  • Google web search for real-time web context and research
  • Google News query for trending topics and current events
  • Google Maps Places query for local business directories
  • Google Images/Videos search for media context
  • Google Shopping search for product prices and availability
Install
$ironclaw ironhub install serper

Description

Serper.dev Search Tool

Install and configure

Install the tool from IronHub. For a manual package import, open Extensions → Registry → Import, select the tool archive, and click Install.

Open Configure and store a Serper API key from https://serper.dev. IronClaw injects it into X-API-KEY only for google.serper.dev.

Each operation is exposed as a named capability with its own input schema. Use only the parameters shown for that capability in the examples below.

Credentials are stored by IronClaw and injected only at the declared HTTP boundary; they are not included in model input or exposed to the WASM component.

A sandboxed WASM tool that gives an IronClaw agent access to the Serper.dev Google Search API for real-time web results, news, images, videos, maps/places, and shopping listings.

The host injects the API key at the HTTP boundary — the WASM code never sees the raw secret — and network access is restricted to google.serper.dev as declared in manifest.toml; the Rust adapter retains route and method validation.

Serper tool

Capabilities

CapabilityRequiredOptionalDescription
searchqgl, hl, location, num, page, autocorrectGet standard Google search organic results.
newsqgl, hl, location, num, pageGet Google News results.
imagesqgl, hl, location, num, pageGet Google Image search results.
videosqgl, hl, location, num, pageGet YouTube/Google Video search results.
placesqgl, hl, location, numQuery Google Maps local business data.
shoppingqgl, hl, location, num, pageSearch Google Shopping listings.

Examples

// Query Google Web Search
// Capability: serper.search
{
  "q": "Rust WASM tool tutorial",
  "gl": "us",
  "hl": "en"
}

// Get Google News about Generative AI
// Capability: serper.news
{
  "q": "Generative AI",
  "num": 5
}

Access & Credentials

Credential method

API key header

Credential accounts
SerperRequired

API key header

serper_api_key

Network & Permissions

Network destinations
google.serper.dev
Effects
Uses network accessUses credentials
Default permissions
Allowed by default

Implementation

WIT Interface0.3.0
Source Pathtools/serper
Technical tags
WASM toolHTTP allowlist

Resources

Review implementation and setup instructions before installing.