duckduckgo_web_search

Instructions

Implementation Reference

• src/index.ts:154-199 (handler)

  Core handler function that performs the DuckDuckGo web search. Calls DDG.search, handles rate limiting via checkRateLimit, processes results, and returns formatted Markdown output.

  async function performWebSearch(
    query: string,
    count: number = CONFIG.search.defaultResults,
    safeSearch: "strict" | "moderate" | "off" = CONFIG.search.defaultSafeSearch
  ): Promise<string> {
    console.error(
      `[DEBUG] Performing search - Query: "${query}", Count: ${count}, SafeSearch: ${safeSearch}`
    );
  
    try {
      checkRateLimit();
  
      const safeSearchMap = {
        strict: DDG.SafeSearchType.STRICT,
        moderate: DDG.SafeSearchType.MODERATE,
        off: DDG.SafeSearchType.OFF,
      };
  
      const searchResults = await DDG.search(query, {
        safeSearch: safeSearchMap[safeSearch],
      });
  
      if (searchResults.noResults) {
        console.error(`[INFO] No results found for query: "${query}"`);
        return `# DuckDuckGo 搜索结果\n没有找到与 "${query}" 相关的结果。`;
      }
  
      const results: SearchResult[] = searchResults.results
        .slice(0, count)
        .map((result: DDG.SearchResult) => ({
          title: result.title,
          description: result.description || result.title,
          url: result.url,
        }));
  
      console.error(
        `[INFO] Found ${results.length} results for query: "${query}"`
      );
  
      // 格式化结果
      return formatSearchResults(query, results);
    } catch (error) {
      console.error(`[ERROR] Search failed - Query: "${query}"`, error);
      throw error;
    }
  }

• src/index.ts:56-80 (schema)

  JSON Schema definition for the tool's input parameters, including query, count, and safeSearch with constraints and defaults.

    inputSchema: {
      type: "object",
      properties: {
        query: {
          type: "string",
          description: `Search query (max ${CONFIG.search.maxQueryLength} chars)`,
          maxLength: CONFIG.search.maxQueryLength,
        },
        count: {
          type: "number",
          description: `Number of results (1-${CONFIG.search.maxResults}, default ${CONFIG.search.defaultResults})`,
          minimum: 1,
          maximum: CONFIG.search.maxResults,
          default: CONFIG.search.defaultResults,
        },
        safeSearch: {
          type: "string",
          description: "SafeSearch level (strict, moderate, off)",
          enum: ["strict", "moderate", "off"],
          default: CONFIG.search.defaultSafeSearch,
        },
      },
      required: ["query"],
    },
  };

• src/index.ts:225-227 (registration)

  Registers the tool by including it in the list returned for ListTools requests.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [WEB_SEARCH_TOOL],
  }));

• src/index.ts:243-259 (handler)

  Tool dispatcher case in the CallToolRequest handler that validates arguments and invokes the performWebSearch function.

  case "duckduckgo_web_search": {
    if (!isDuckDuckGoWebSearchArgs(args)) {
      throw new Error("Invalid arguments for duckduckgo_web_search");
    }
  
    const {
      query,
      count = CONFIG.search.defaultResults,
      safeSearch = CONFIG.search.defaultSafeSearch,
    } = args;
    const results = await performWebSearch(query, count, safeSearch);
  
    return {
      content: [{ type: "text", text: results }],
      isError: false,
    };
  }

• src/index.ts:204-222 (helper)

  Helper function to format search results into a structured Markdown response.

  function formatSearchResults(query: string, results: SearchResult[]): string {
    const formattedResults = results
      .map((r: SearchResult) => {
        return `### ${r.title}
  ${r.description}
  
  🔗 [阅读更多](${r.url})
  `;
      })
      .join("\n\n");
  
    return `# DuckDuckGo 搜索结果
  ${query} 的搜索结果（${results.length}件）
  
  ---
  
  ${formattedResults}
  `;
  }