Skills

A skill is a package of structured files that teaches an AI coding agent how to work with a specific tool or framework. The skill below was generated by Great Docs from this project’s documentation. Install it in your agent and it will be able to run commands, edit configuration, write content, and troubleshoot problems without step-by-step guidance from you.

Any agent — install with npx:

npx skills add https://serpapi.github.io/serpapi-search-tools-python/

Codex / OpenCode

Tell the agent:
Fetch the skill file at https://serpapi.github.io/serpapi-search-tools-python/skill.md and follow the instructions.

Manual — download the skill file:

curl -O https://serpapi.github.io/serpapi-search-tools-python/skill.md

Or browse the SKILL.md file.

SKILL.md

---
name: serpapi-search-tools
description: >
  Add live SerpApi search to Python agents and agent SDKs. Use when writing Python code that uses the serpapi_search_tools package.
license: MIT
compatibility: Requires Python >=3.10.
---

# serpapi-search-tools

Add live SerpApi search to Python agents and agent SDKs.

## Installation

```bash
pip install serpapi-search-tools
```

## API overview

### Enumerations and errors

Supported engines, response modes, semantic travel values, and search failures

- `WebSearchEngine`: General web indexes supported by :func:`web_search`
- `ShoppingSearchEngine`: Product indexes supported by :func:`shopping_search`
- `SearchResultMode`: Control how much of a SerpApi response is returned to the agent
- `TravelClass`: Cabin class shared by flight and travel-explore tools
- `SerpApiSearchError`: A sanitized failure raised while executing a search

### Functions

Create capability-specific search tools for Python and agent SDKs

- `web_search`: Create a general-web search tool
- `news_search`: Create a Google News query-mode tool for current articles and stories
- `maps_search`: Create a Google Maps search-mode tool for places and businesses
- `images_search`: Create a Google Images tool for image URLs and metadata
- `shopping_search`: Create a multi-marketplace product search tool
- `videos_search`: Create a YouTube tool for videos, channels, and playlists
- `hotels_search`: Create a Google Hotels tool with explicit stay dates
- `flights_search`: Create a Google Flights tool for one-way and round-trip routes
- `travel_explore_search`: Create a Google Travel Explore destination-discovery tool

## Resources

- [Full documentation](https://serpapi.github.io/serpapi-search-tools-python/)
- [llms.txt](llms.txt) — Indexed API reference for LLMs
- [llms-full.txt](llms-full.txt) — Comprehensive documentation for LLMs
- [Source code](https://github.com/serpapi/serpapi-search-tools-python)