SerpAPI Tool

Guide for using the SerpAPI tool with PraisonAI agents.

The SerpAPI tool lets an agent search Google and other engines through the SerpAPI service.

Diagram

SerpAPI

User

Agent

SerpAPIWrapper

SerpAPI

Results

Overview

The SerpAPI tool is a tool that allows you to search the web using the SerpAPI.

bash
pip install langchain-community google-search-results
export SERPAPI_API_KEY="${SERPAPI_API_KEY:?Set SERPAPI_API_KEY in your shell}"
export OPENAI_API_KEY="${OPENAI_API_KEY:?Set OPENAI_API_KEY in your shell}"
python
from praisonaiagents import Agent, AgentTeam
from langchain_community.utilities import SerpAPIWrapper

data_agent = Agent(instructions="Search about AI job trends in 2025", tools=[SerpAPIWrapper])
editor_agent = Agent(instructions="Write a blog article")

agents = AgentTeam(agents=[data_agent, editor_agent])
agents.start()

How It Works

Diagram
SerpAPISerpAPIWrapperAgentUserSerpAPISerpAPIWrapperAgentUser“Search for X”run(query)HTTPS requestresultsparsed resultfinal answer

Getting Started

  1. Simple Usage
    1. Install dependencies (see Overview above)
    2. Set required API keys in your environment
    3. Run the agent example in Overview
  2. With Configuration

    Use the same tool with an agent — see the Overview example, or pass env vars from the sections above.

Best Practices

Keep SERPAPI_API_KEY in the environment

Set SERPAPI_API_KEY in your shell or .env. SerpAPIWrapper reads it automatically — never hard-code the key.

Watch the monthly quota

SerpAPI plans cap total searches per month. Cache repeated queries so agents do not exhaust the quota mid-task.

Handle rate limits

SerpAPI returns an error when the quota is exceeded. Wrap the call in try/except so the agent can fall back to another search tool.

Related Tools