,Vj v d Z ddlmZ ddlZddlmZmZ ddlmZ ej e
Z G d de Z dS )u DuckDuckGo web search provider via the ``ddgs`` Python package.
DuckDuckGo does not provide an official programmatic search API. The
community-maintained `ddgs `_ package (the
renamed successor of ``duckduckgo-search``) scrapes DuckDuckGo's HTML results
page and normalizes them. It implements ``WebSearchProvider`` only — there is
no extract capability.
Configuration::
# No API key required. Enable by installing the package and pointing the
# web backend at ddgs:
pip install ddgs
# ~/.hermes/config.yaml
web:
search_backend: "ddgs"
extract_backend: "firecrawl" # pair with an extract provider if needed
Rate limits are enforced server-side by DuckDuckGo. Expect intermittent
``DuckDuckGoSearchException`` / 202 responses under heavy use; this provider
surfaces them as ``{"success": False, "error": ...}`` rather than crashing
the tool call.
See https://duckduckgo.com/?q=duckduckgo+tos for terms of use.
) annotationsN)AnyDict)WebSearchProviderc , e Zd ZdZddZddZddd Zd
S )DDGSSearchProvideru Search via the ``ddgs`` package (DuckDuckGo HTML scrape).
No API key required. The provider is considered "configured" when the
``ddgs`` package is importable — there is nothing else to set up.
returnstrc dS )Nddgs )selfs 6/root/.hermes/hermes-agent/tools/web_providers/ddgs.py
provider_namez DDGSSearchProvider.provider_name- s v boolc 2 ddl }dS # t $ r Y dS w xY w)zReturn True when the ``ddgs`` package is importable.
Called at tool-registration time; must not perform network I/O.
r NTF)r ImportError)r r s r
is_configuredz DDGSSearchProvider.is_configured0 s7
KKK4 55 s
querylimitintDict[str, Any]c , ddl m} n# t $ r dddcY S w xY wt dt | } g } | 5 }t | || D ]\ }}||k r nt | d p| d pd
} | t | d d
| t | d d
|dz d
ddd n # 1 swxY w Y n:# t $ r-}
t d|
dd|
dcY d}
~
S d}
~
ww xY wt
d|t | | dd|idS )a Execute a DuckDuckGo search and return normalized results.
Returns ``{"success": True, "data": {"web": [...]}}`` on success or
``{"success": False, "error": str}`` on failure (missing package,
rate-limited, network error, etc.).
r )DDGSFu8 ddgs package is not installed — run `pip install ddgs`)successerror ) max_resultshrefurl titlebody)r$ r" descriptionpositionNzDDGS search error: %szDuckDuckGo search failed: z'DDGS search '%s': %d results (limit %d)Tweb)r data)r r r maxr enumeratetextr
getappend Exceptionloggerwarninginfolen) r r r r
safe_limit web_resultsclientihitr" excs r searchzDDGSSearchProvider.search; s5 ! ! ! ! ! ! ! S
CJJ''
S K
6 ' Ez (R(R S S FAsJ cggfoo E E2FFC &&%(")=)=%>%>#&+.swwvr/B/B+C+C()A
S S S NN2C 8 8 8 $/QC/Q/QRR R R R R R R S =uc+FVFVX]^^^ %)=>>>sN D+ C D D+ D##D+ &D#'D+ +
E"5"E E" E"N)r r
)r r )r )r r
r r r r )__name__
__module__ __qualname____doc__r r r: r
r r r r & s_ '? '? '? '? '? '? '?r r )
r>
__future__r loggingtypingr r tools.web_providers.baser getLoggerr; r0 r r
r r rD s 6 # " " " " " 6 6 6 6 6 6 8 $ $<? <? <? <? <?* <? <? <? <? <?r