---
title: "Serper"
description: "Google Search API oracle for Ironclaw via Serper.dev. Retrieves organic results, news, images, videos, local places, and shopping listings."
canonical: "https://hub.ironclaw.com/marketplace/serper"
markdown: "https://hub.ironclaw.com/marketplace/serper.md"
type: "tool"
version: "0.2.0"
author: "IronHub"
category: "Dev Tools"
tags: ["WASM tool","HTTP allowlist"]
---

# Serper

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

## Details

- **Type:** Tool
- **Version:** 0.2.0
- **Author:** IronHub
- **Category:** Dev Tools
- **Status:** live
- **Tags:** WASM tool, HTTP allowlist


## 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

## Limits

- 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.
- Capabilities

## Documentation

# 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](https://serper.dev/) 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](https://hub.ironclaw.com/api/catalog/repository-asset/tool/serper/screenshot.jpg)

## Capabilities
| Capability | Required | Optional | Description |
|--------|----------|----------|-------------|
| `search` | `q` | `gl`, `hl`, `location`, `num`, `page`, `autocorrect` | Get standard Google search organic results. |
| `news` | `q` | `gl`, `hl`, `location`, `num`, `page` | Get Google News results. |
| `images` | `q` | `gl`, `hl`, `location`, `num`, `page` | Get Google Image search results. |
| `videos` | `q` | `gl`, `hl`, `location`, `num`, `page` | Get YouTube/Google Video search results. |
| `places` | `q` | `gl`, `hl`, `location`, `num` | Query Google Maps local business data. |
| `shopping` | `q` | `gl`, `hl`, `location`, `num`, `page` | Search Google Shopping listings. |

## Examples

```jsonc
// 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
}
```

## Links

- [HTML page](https://hub.ironclaw.com/marketplace/serper)
- [Source](https://github.com/nearai/ironhub/blob/main/tools/serper)
- [Documentation](https://github.com/nearai/ironhub/blob/main/tools/serper/serper-tool.capabilities.json)