Tools

DuckDuckGo 검색

OpenClaw는 DuckDuckGo를 키가 필요 없는 web_search 제공자로 지원합니다. API 키나 계정이 필요하지 않습니다.

설정

API 키가 필요 없습니다. DuckDuckGo를 제공자로 설정하기만 하면 됩니다.

  • Configure

    openclaw configure --section web
    # Select "duckduckgo" as the provider
    
  • 구성

    {
      tools: {
        web: {
          search: {
            provider: "duckduckgo",
          },
        },
      },
    }
    

    지역 및 SafeSearch에 대한 선택적 Plugin 수준 설정:

    {
      plugins: {
        entries: {
          duckduckgo: {
            config: {
              webSearch: {
                region: "us-en", // DuckDuckGo region code
                safeSearch: "moderate", // "strict", "moderate", or "off"
              },
            },
          },
        },
      },
    }
    

    도구 매개변수

    querystringrequired

    검색 쿼리입니다.

    countnumber

    반환할 결과 수입니다(1~10).

    regionstring

    DuckDuckGo 지역 코드입니다(예: us-en, uk-en, de-de).

    safeSearch'strict' | 'moderate' | 'off'

    SafeSearch 수준입니다.

    지역 및 SafeSearch는 Plugin 구성에서도 설정할 수 있습니다(위 참조). 도구 매개변수는 쿼리별로 구성 값을 재정의합니다.

    참고 사항

    • API 키 없음 - 별도 구성 없이 바로 작동합니다
    • 실험적 - 공식 API나 SDK가 아니라 DuckDuckGo의 JavaScript 미사용 HTML 검색 페이지에서 결과를 수집합니다
    • 봇 챌린지 위험 - 사용량이 많거나 자동화된 사용에서는 DuckDuckGo가 CAPTCHA를 표시하거나 요청을 차단할 수 있습니다
    • HTML 파싱 - 결과는 페이지 구조에 따라 달라지며, 페이지 구조는 예고 없이 변경될 수 있습니다
    • 자동 감지 순서 - DuckDuckGo는 자동 감지에서 첫 번째 키가 필요 없는 폴백입니다 (순서 100). 키가 구성된 API 기반 제공자가 먼저 실행되고, 그다음 Ollama Web Search(순서 110), 그다음 SearXNG(순서 200)가 실행됩니다
    • SafeSearch는 구성되지 않은 경우 moderate가 기본값입니다

    관련 항목