zzatpku/agentfactory/google-search

Search Tool

search_serper: High-quality search using Google via Serper API. Returns web page title, url and a short snippet.

Usage

from tools import search_serper
results = search_serper(query, topk=10)

Parameters

Returns

Returns a list of dictionaries directly:

[
    {
        "title": "web page title",
        "link": "web page url",
        "snippet": "brief snippet, NOT the full content...",
    },
    ...
]

Or on error:

[{"error": "error message"}]

Note: The snippet field is a very short excerpt, NOT the full page content. It may miss critical information. Always use read_url_jina to retrieve the full page content for any relevant result.

Example

from tools import search_serper
# Search for information about a topic
results = search_serper("capital of France", topk=3)
# Process results
for doc in results:
    if "error" in doc:
        print(f"Error: {doc['error']}")
        break
    print(f"Doc title: {doc['title']}")
    print(f"url: {doc['link']}")
    print(f"snippet: {doc['snippet']}...")
    print("---")

Tips

• Use specific, descriptive queries for better results
• Start with topk around 10 and adjust if needed
• Check the score to gauge relevance
• The `snippet` field is a brief excerpt, NOT the full content - it may miss critical information
• Always use `read_url_jina` to get the full page content for any relevant result - do NOT rely solely on the snippet from search
• Check for errors in the first result