Skip to main content

​
Overview

Web search tool using DuckDuckGo’s search engine.

​
Basic Usage

from upsonic import Agent, Task
from upsonic.tools.common_tools import duckduckgo_search_tool

# Create DuckDuckGo search tool
ddg_search = duckduckgo_search_tool(max_results=5)

# Create task
task = Task(
    description="Search for 'artificial intelligence trends 2024'",
    tools=[ddg_search]
)

# Create agent
agent = Agent(model="anthropic/claude-sonnet-4-5", name="Search Agent")

# Execute
result = agent.print_do(task)
print("Result:", result)

​
Custom Configuration

from upsonic.tools.common_tools import duckduckgo_search_tool
from ddgs import DDGS
from upsonic import Agent, Task

# Create custom client
custom_client = DDGS()

# Configure search tool
ddg_search = duckduckgo_search_tool(
    duckduckgo_client=custom_client,
    max_results=10
)

task = Task(
    description="Search for Python programming tutorials with 10 results",
    tools=[ddg_search]
)

agent = Agent(model="anthropic/claude-sonnet-4-5", name="Custom Search Agent")
result = agent.print_do(task)
print("Result:", result)

​
Parameters

Function Parameters:
  • duckduckgo_client (DDGS, optional): Custom DuckDuckGo client instance
  • max_results (int, optional): Maximum number of results to return
Tool Parameters:
  • query (str): The search query string

​
Result Format

Search results are returned as a list of dictionaries: 
[
    {
        "title": "Result Title",
        "href": "https://example.com",
        "body": "Description of the result"
    },
    # ... more results
]

​
Installation

uv pip install duckduckgo-search