DuckDuckGo

DuckDuckGoTools is a convenience wrapper around WebSearchTools with the backend defaulting to DuckDuckGo. It enables an Agent to search the web for information using the DuckDuckGo search engine.

For more flexibility with multiple search backends (Google, Bing, Brave, Yandex, etc.), use WebSearchTools directly.

Prerequisites

The following example requires the ddgs library. To install DuckDuckGo, run the following command:

uv pip install -U ddgs

Example

from agno.agent import Agent
from agno.tools.duckduckgo import DuckDuckGoTools

agent = Agent(tools=[DuckDuckGoTools()])
agent.print_response("Whats happening in France?", markdown=True)

Toolkit Params

Parameter	Type	Default	Description
enable_search	bool	True	Enable DuckDuckGo search function.
enable_news	bool	True	Enable DuckDuckGo news function.
modifier	Optional[str]	None	A modifier to be used in the search request.
fixed_max_results	Optional[int]	None	A fixed number of maximum results.
proxy	Optional[str]	None	Proxy to be used in the search request.
timeout	Optional[int]	10	The maximum number of seconds to wait for a response.
verify_ssl	bool	True	Whether to verify SSL certificates.

Toolkit Functions

Function	Description
web_search	Search DuckDuckGo for a query. Parameters include query (str) for the search query and max_results (int, default=5) for maximum results. Returns JSON formatted search results.
search_news	Get the latest news from DuckDuckGo. Parameters include query (str) for the search query and max_results (int, default=5) for maximum results. Returns JSON formatted news results.

For backward compatibility, the aliases duckduckgo_search and duckduckgo_news are also available.

Developer Resources

• View Tools