# Serpapi

> Search the web and e-commerce platforms using the SerpApi API. Use when the user wants to search Google, Google Shopping, Google Jobs, eBay, or Amazon via SerpApi. Triggers on phrases like "search Google for...", "find products on eBay", "search Amazon for...", "find jobs on Google", "Google Shopping results for...", "use SerpApi to...", "search with SerpApi", "look up a product on Amazon", "find…

- **Type:** Skill
- **Install:** `agentstack add skill-peterfox-agent-skills-serpapi`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [peterfox](https://agentstack.voostack.com/s/peterfox)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [peterfox](https://github.com/peterfox)
- **Source:** https://github.com/peterfox/agent-skills/tree/main/serpapi

## Install

```sh
agentstack add skill-peterfox-agent-skills-serpapi
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SerpApi

Use the SerpApi REST API (via WebFetch) to retrieve structured search results from Google, Google Shopping, Google Jobs, eBay, and Amazon.

**Base endpoint**: `https://serpapi.com/search`
**Authentication**: Pass `api_key` as a query parameter on every request.

## Engines

| Engine | `engine` value | Reference |
|--------|---------------|-----------|
| Google Search | `google` | [references/google-search-api.md](references/google-search-api.md) |
| Google Shopping | `google_shopping` | [references/google-shopping-api.md](references/google-shopping-api.md) |
| Google Jobs | `google_jobs` | [references/google-jobs-api.md](references/google-jobs-api.md) |
| Google Immersive Product | `google_immersive_product` | [references/google-immersive-product-api.md](references/google-immersive-product-api.md) |
| eBay | `ebay` | [references/ebay-api.md](references/ebay-api.md) |
| Amazon Search | `amazon` | [references/amazon-search-api.md](references/amazon-search-api.md) |
| Amazon Product | `amazon_product` | [references/amazon-product-api.md](references/amazon-product-api.md) |

Read the relevant reference file before constructing any request.

## Key Patterns

### Chaining APIs
- **Google Shopping → Immersive Product**: A `shopping_results` item's `immersive_product_page_token` is the `page_token` for `google_immersive_product`.
- **Amazon search → Product detail**: A `organic_results` item's `serpapi_link` links directly to `amazon_product` for full product details, or use the `asin` manually.

### Filters from responses
- **Google Shopping**: `shoprs` tokens for category-specific filters (brand, colour, size, etc.) come from `filters[].options[].shoprs` or `carousel_filters[].shoprs` in the response — never construct them manually.
- **Google Jobs**: `uds` filter tokens come from `filters` in the response. `chips` and `ltype` are deprecated; use `uds` instead.
- **Google Jobs pagination**: `start` is discontinued — use `next_page_token` from `serpapi_pagination`.

### Presenting results
- Always show prices with currency and `extracted_price` for computation.
- For job listings: show `title`, `company_name`, `location`, `via`, and key `detected_extensions` fields (schedule type, remote, salary).
- For product results: show `title`, `price`, `rating`, `reviews`, and `source`/`seller`.
- For eBay: distinguish `sponsored` listings clearly.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [peterfox](https://github.com/peterfox)
- **Source:** [peterfox/agent-skills](https://github.com/peterfox/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-peterfox-agent-skills-serpapi
- Seller: https://agentstack.voostack.com/s/peterfox
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.