Serper

SerperTools enable an Agent to search Google, search news, search academic papers, search reviews, and scrape webpages using Serper.

Prerequisites

The following example requires an API key from Serper.

export SERPER_API_KEY=***

Example

The following agent will search for the latest news about artificial intelligence developments:

cookbook/tools/serper_tools.py

from agno.agent import Agent
from agno.tools.serper import SerperTools

agent = Agent(
    tools=[SerperTools()],
    show_tool_calls=True,
)

agent.print_response(
    "Search for the latest news about artificial intelligence developments",
    markdown=True,
)

Additional Examples

Google Scholar Search

agent.print_response(
    "Find 2 recent academic papers about large language model safety and alignment",
    markdown=True,
)

Reviews Search

agent.print_response(
    "Use this Google Place ID: ChIJ_Yjh6Za1j4AR8IgGUZGDDTs and analyze the reviews",
    markdown=True
)

Web Scraping

agent.print_response(
    "Scrape and summarize the main content from this OpenAI blog post: https://openai.com/index/gpt-4/",
    markdown=True
)

Toolkit Params

Parameter	Type	Default	Description
`api_key`	`Optional[str]`	`None`	API key for authentication.
`country`	`str`	`"us"`	Country code for search results (e.g., “us”, “uk”).
`location`	`Optional[str]`	`None`	Google location code for search results.
`language`	`str`	`"en"`	Language code for search results (e.g., “en”, “es”).
`num_results`	`int`	`10`	Default number of search results to retrieve.
`date_range`	`Optional[str]`	`None`	Default date range filter for searches.
`sort_reviews_by`	`Optional[str]`	`"mostRelevant"`	Sort order for reviews search (“mostRelevant”, “newest”, etc.).

Toolkit Functions

Function	Description
`search`	Searches Google for a query. Parameters: `query` (str), optional `num_results` (int).
`search_news`	Searches for news articles. Parameters: `query` (str), optional `num_results` (int).
`search_scholar`	Searches Google Scholar for academic papers. Parameters: `query` (str), optional `num_results` (int).
`search_reviews`	Searches for reviews using place identifiers. Parameters: optional `place_id`, `cid`, `fid`, or `topic_id` (str).
`scrape_webpage`	Scrapes content from a webpage. Parameters: `url` (str), optional `markdown` (bool).

Developer Resources

View Tools
View Cookbook

Introduction

Concepts

Other

How to

Prerequisites

Example

Additional Examples

Google Scholar Search

Reviews Search

Web Scraping

Toolkit Params

Toolkit Functions

Developer Resources

​Prerequisites

​Example

​Additional Examples

​Google Scholar Search

​Reviews Search

​Web Scraping

​Toolkit Params

​Toolkit Functions

​Developer Resources

Prerequisites

Example

Additional Examples

Google Scholar Search

Reviews Search

Web Scraping

Toolkit Params

Toolkit Functions

Developer Resources