duckduckgo

name	duckduckgo
description	Web search via DuckDuckGo — free, no API key required. Returns titles, URLs, and snippets.
version	0.1.2
type	extension
runtime	python3
entry	plugin.py
permissions	["net","tool","route","widget"]
env_from_settings	[]
dependencies	["ddgs"]
when_to_use	User asks to search the web, find information, look up facts, or research a topic — and no OpenAI key is available for web_search.
timeout_sec	60
ui_tab	{"tab_id":"search","title":"DuckDuckGo Search","icon":"search","render":{"kind":"declarative","schema_version":1,"components":[{"type":"form","route":"search","method":"POST","target":"search_results","fields":[{"name":"query","label":"Search query","type":"text","placeholder":"Search the web...","required":true},{"name":"max_results","label":"Max results","type":"text","placeholder":"5"}],"submit_label":"Search"},{"type":"json","target":"search_results"}]}}

DuckDuckGo Search

A zero-config web search extension using the DuckDuckGo search engine. No API keys required — works with any Ouroboros configuration.

Capabilities

• Agent tool: ext_..._duckduckgo_search — the LLM can call this to search the web
• HTTP route: POST /api/extensions/duckduckgo/search — JSON body {"query": "...", "max_results": 5}
• Widget: declarative form on the Widgets page for manual searches

Dependencies

Requires the ddgs Python package. Ouroboros installs it automatically from the manifest dependencies declaration during review/install.

Network policy

Connects to DuckDuckGo servers only. No other external hosts are contacted.