Skip to main content
Glama

duckduckgo_search

Destructive

当用户需要通过 DuckDuckGo 搜索公开网页信息,或希望获取 DuckDuckGo 的隐私搜索结果、网页结果或搜索摘要时触发。

Input Schema

NameRequiredDescriptionDefault
mNo该参数定义要返回的最大结果数量。默认值:10,最小值:1,最大值:50。当 start 设置为 0 或留空时,最多可返回 25 个自然结果。DuckDuckGo 可能返回重复结果或数量可变的结果,这在使用较大的 start 和 m 参数时更可能发生。m 和 search_assist 不能一起使用。10
qYes该参数定义爬取时的搜索结果。您可以输入任意想要查询的关键词,也可以是任意语言。调用方必须提供非空值,不使用默认值。
dfNo该参数定义按日期过滤的结果。可设置为:d - 过去一天,w - 过去一周,m - 过去一月,y - 过去一年;也可以按 start_date..end_date 格式传递自定义日期,例如:2021-06-15..2024-06-16。
klNo该参数定义 DuckDuckGo 搜索要使用的地区。地区代码示例:us-en 代表美国,uk-en 代表英国,fr-fr 代表法国。请访问 DuckDuckGo 地区页面查看支持的地区完整列表。
jsonNo该参数定义采集结果的输出格式;可选择 JSON、HTML(支持下载)格式,默认为 JSON;1 返回 JSON,2 返回 JSON+HTML,3 返回 HTML,4 返回 Light JSON。1
safeNo该参数定义成人内容的过滤级别。可设置为:1 - 严格,-1 - 中等(默认),-2 - 关闭。-1
startNo该参数定义结果偏移量,它跳过指定数量的结果。当 start 设置为 0 或留空时,最多可返回 25 个自然结果;当 start 大于 0 时,最多可返回 10 个自然结果。DuckDuckGo 可能返回重复结果或数量可变的结果,这在使用较大的 start 和 m 参数时更可能发生。0
no_cacheNo默认情况下,5 分钟内缓存相同参数的搜索结果;将 no_cache 设为 true 可跳过缓存,设为 false(默认)则使用缓存结果;缓存搜索免费,且不计入搜索统计。false
search_assistNo该参数决定是否在响应中返回 DuckDuckGo 的 AI 搜索辅助。可设置为 true 或 false(默认)。search_assist 和 m 不能一起使用。false

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare readOnlyHint=false and destructiveHint=true, yet the description frames the tool purely as a read/search operation ('搜索公开网页信息', '获取搜索结果'), creating an inconsistency with the destructive hint. Beyond that mismatch the description adds no behavioral context such as credit consumption, rate limits, or privacy-mode semantics despite the 'privacy search' mention.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is a single short sentence with the trigger front-loaded, but it lists overlapping concepts ('隐私搜索结果、网页结果或搜索摘要') that repeat the same idea rather than adding distinct information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter tool with two enums, no output schema, and a large sibling set of competing search tools, the description leaves critical gaps: it never explains the output-format behavior controlled by 'json', the search_assist/m exclusivity, or how to choose it over sibling search tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the schema richly documents all 9 parameters (date filter, region, output format, safe search, pagination, caching). The description contributes nothing beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb+resource: searching public web information via DuckDuckGo and retrieving privacy/web results or search summaries. Naming DuckDuckGo implicitly distinguishes it from siblings like google_search, bing_search, and yandex_search, though it never makes that contrast explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The whole text is a 'trigger when the user needs...' phrasing but gives no conditions, prerequisites, or when-NOT-to-use guidance. It never tells the agent when to prefer DuckDuckGo over the many other search siblings (google_search, bing_search, yandex_search).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources