Smart Search MCP

Overview Schema Related Servers Score Discussions

ai_search_web

Perform web searches across Google, Bing, Baidu, or Sogou to find information online. Returns search URLs for accessing results through web fetching tools.

Instructions

🔍 网络搜索 - 通用网络搜索（Google/Bing/百度/搜狗）

【重要】此工具会返回搜索URL，Claude Code应该使用WebFetch工具访问该URL以获取真实搜索结果。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`query`	Yes	搜索关键词
`engine`	No	搜索引擎，默认baidu	baidu
`count`	No	期望的结果数量，默认10

Implementation Reference

mcp_server_node.js:262-336 (handler)

Handler for the 'ai_search_web' tool. Normalizes input, selects search engine, constructs search URL, generates detailed content with tips and suggestions, saves to file, and returns response instructing to use WebFetch for results.

case 'ai_search_web': {
  const rawQuery = normalizeString(args.query);
  const requestedEngine = normalizeString(args.engine).toLowerCase();
  const resolvedCount = clampNumber(args.count, 1, 50, 10);

  if (!rawQuery) {
    throw new Error('搜索关键词不能为空');
  }

  const searchUrls = {
    google: `https://www.google.com/search?q=${encodeURIComponent(rawQuery)}&num=${resolvedCount}`,
    bing: `https://www.bing.com/search?q=${encodeURIComponent(rawQuery)}&count=${resolvedCount}`,
    baidu: `https://www.baidu.com/s?wd=${encodeURIComponent(rawQuery)}&rn=${resolvedCount}`,
    sogou: `https://www.sogou.com/web?query=${encodeURIComponent(rawQuery)}&num=${resolvedCount}`
  };

  const engineNames = {
    google: 'Google',
    bing: 'Bing (必应)',
    baidu: '百度',
    sogou: '搜狗'
  };

  const resolvedEngine = pickKey(searchUrls, requestedEngine, 'baidu');
  const searchUrl = searchUrls[resolvedEngine];

  const tips = [
    `精确匹配: "${rawQuery}"`,
    `排除关键词: ${rawQuery} -排除词`,
    `限定站点: site:github.com ${rawQuery}`,
    `文件类型: ${rawQuery} filetype:pdf`,
    `时间范围: ${rawQuery} after:2023`,
  ];

  const relatedSearches = [
    `${rawQuery} 教程`,
    `${rawQuery} 最佳实践`,
    `${rawQuery} 示例`,
    `${rawQuery} 文档`
  ];

  const detailsContent = `🔍 网络搜索\n\n` +
    `**搜索关键词**: ${rawQuery}\n` +
    `**搜索引擎**: ${engineNames[resolvedEngine]}\n` +
    `**期望结果数**: ${resolvedCount} 条\n\n` +
    `---\n\n` +
    `🔗 **搜索链接**: ${searchUrl}\n\n` +
    `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
    `\`\`\`javascript\n` +
    `WebFetch({\n` +
    `  url: "${searchUrl}",\n` +
    `  prompt: "提取前${resolvedCount}条搜索结果，包括：标题、链接、摘要"\n` +
    `})\n` +
    `\`\`\`\n\n` +
    `---\n\n` +
    `💡 **高级搜索技巧**:\n` +
    tips.map(tip => `• ${tip}`).join('\n') +
    `\n\n📌 **相关搜索建议**:\n` +
    relatedSearches.map(s => `• ${s}`).join('\n') +
    `\n\n🌐 **其他搜索引擎**:\n` +
    Object.keys(searchUrls)
      .filter(e => e !== resolvedEngine)
      .map(e => `• ${engineNames[e]}: ${searchUrls[e]}`)
      .join('\n');

  const filepath = await saveSearchResult('web-search', rawQuery, detailsContent);

  return makeTextResponse(
    `🔍 **网络搜索** (${engineNames[resolvedEngine]})\n\n` +
    `**关键词**: ${rawQuery}\n` +
    `**搜索链接**: ${searchUrl}\n\n` +
    `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
    `💡 使用 WebFetch 工具访问搜索链接获取结果`
  );
}

mcp_server_node.js:77-89 (schema)

Tool schema definition for 'ai_search_web', including name, description, and inputSchema with properties for query (required), engine, and count.

{
  name: 'ai_search_web',
  description: '🔍 网络搜索 - 通用网络搜索（Google/Bing/百度/搜狗）\n\n【重要】此工具会返回搜索URL，Claude Code应该使用WebFetch工具访问该URL以获取真实搜索结果。',
  inputSchema: {
    type: 'object',
    properties: {
      query: { type: 'string', description: '搜索关键词' },
      engine: { type: 'string', enum: ['google', 'bing', 'baidu', 'sogou'], description: '搜索引擎，默认baidu', default: 'baidu' },
      count: { type: 'number', description: '期望的结果数量，默认10', default: 10 }
    },
    required: ['query']
  }
},

mcp_server_node.js:252-254 (registration)
Registration of the ListToolsRequestHandler that returns the list of tools, including 'ai_search_web' via the AI_TOOLS array.
```
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: AI_TOOLS,
}));
```

mcp_server_node.js:256-955 (handler)

The overall CallToolRequestHandler containing the switch statement that dispatches to the ai_search_web case.

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;

  try {
    switch (name) {
      // === 搜索工具处理 ===
      case 'ai_search_web': {
        const rawQuery = normalizeString(args.query);
        const requestedEngine = normalizeString(args.engine).toLowerCase();
        const resolvedCount = clampNumber(args.count, 1, 50, 10);

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const searchUrls = {
          google: `https://www.google.com/search?q=${encodeURIComponent(rawQuery)}&num=${resolvedCount}`,
          bing: `https://www.bing.com/search?q=${encodeURIComponent(rawQuery)}&count=${resolvedCount}`,
          baidu: `https://www.baidu.com/s?wd=${encodeURIComponent(rawQuery)}&rn=${resolvedCount}`,
          sogou: `https://www.sogou.com/web?query=${encodeURIComponent(rawQuery)}&num=${resolvedCount}`
        };

        const engineNames = {
          google: 'Google',
          bing: 'Bing (必应)',
          baidu: '百度',
          sogou: '搜狗'
        };

        const resolvedEngine = pickKey(searchUrls, requestedEngine, 'baidu');
        const searchUrl = searchUrls[resolvedEngine];

        const tips = [
          `精确匹配: "${rawQuery}"`,
          `排除关键词: ${rawQuery} -排除词`,
          `限定站点: site:github.com ${rawQuery}`,
          `文件类型: ${rawQuery} filetype:pdf`,
          `时间范围: ${rawQuery} after:2023`,
        ];

        const relatedSearches = [
          `${rawQuery} 教程`,
          `${rawQuery} 最佳实践`,
          `${rawQuery} 示例`,
          `${rawQuery} 文档`
        ];

        const detailsContent = `🔍 网络搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**搜索引擎**: ${engineNames[resolvedEngine]}\n` +
          `**期望结果数**: ${resolvedCount} 条\n\n` +
          `---\n\n` +
          `🔗 **搜索链接**: ${searchUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前${resolvedCount}条搜索结果，包括：标题、链接、摘要"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **高级搜索技巧**:\n` +
          tips.map(tip => `• ${tip}`).join('\n') +
          `\n\n📌 **相关搜索建议**:\n` +
          relatedSearches.map(s => `• ${s}`).join('\n') +
          `\n\n🌐 **其他搜索引擎**:\n` +
          Object.keys(searchUrls)
            .filter(e => e !== resolvedEngine)
            .map(e => `• ${engineNames[e]}: ${searchUrls[e]}`)
            .join('\n');

        const filepath = await saveSearchResult('web-search', rawQuery, detailsContent);

        return makeTextResponse(
          `🔍 **网络搜索** (${engineNames[resolvedEngine]})\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_github': {
        const rawQuery = normalizeString(args.query);
        const languageFilter = normalizeString(args.language);
        const requestedType = normalizeString(args.type).toLowerCase();
        const requestedSort = normalizeString(args.sort).toLowerCase();

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const typeNames = {
          repositories: '仓库',
          code: '代码',
          issues: '问题',
          users: '用户'
        };

        const sortNames = {
          stars: 'Star数',
          forks: 'Fork数',
          updated: '更新时间'
        };

        const typeKey = pickKey(typeNames, requestedType, 'repositories');
        const sortKey = pickKey(sortNames, requestedSort, 'stars');

        // 构建搜索URL
        let searchUrl = `https://github.com/search?q=${encodeURIComponent(rawQuery)}`;
        if (languageFilter) searchUrl += `+language:${encodeURIComponent(languageFilter)}`;
        searchUrl += `&type=${typeKey}&s=${sortKey}&o=desc`;

        // GitHub 搜索技巧
        const tips = [
          `Stars数量: ${rawQuery} stars:>1000`,
          `Fork数量: ${rawQuery} forks:>100`,
          `特定语言: ${rawQuery} language:javascript`,
          `最近更新: ${rawQuery} pushed:>2024-01-01`,
          `主题标签: ${rawQuery} topic:react`,
          `组织仓库: ${rawQuery} org:facebook`,
          `仓库大小: ${rawQuery} size:>10000`
        ];

        // 相关搜索建议
        const relatedSearches = [];
        if (typeKey === 'repositories') {
          relatedSearches.push(
            `${rawQuery} stars:>1000`,
            `${rawQuery} language:${languageFilter || 'javascript'}`,
            `awesome ${rawQuery}`
          );
        } else if (typeKey === 'code') {
          relatedSearches.push(
            `${rawQuery} extension:js`,
            `${rawQuery} path:src`,
            `${rawQuery} filename:README`
          );
        }

        const detailsContent = `🐙 GitHub 搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**搜索类型**: ${typeNames[typeKey]}\n` +
          `**编程语言**: ${languageFilter || '全部语言'}\n` +
          `**排序方式**: ${sortNames[sortKey]}\n\n` +
          `---\n\n` +
          `🔗 **搜索链接**: ${searchUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前10个${typeNames[typeKey]}的名称、描述、${typeKey === 'repositories' ? 'Star数、Fork数' : '相关信息'}和链接"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **GitHub 高级搜索技巧**:\n` +
          tips.map(tip => `• ${tip}`).join('\n') +
          (relatedSearches.length > 0
            ? `\n\n📌 **相关搜索建议**:\n` + relatedSearches.map(s => `• ${s}`).join('\n')
            : '') +
          `\n\n📚 **更多搜索类型**:\n` +
          Object.keys(typeNames)
            .filter(t => t !== typeKey)
            .map((t) => {
              let altUrl = `https://github.com/search?q=${encodeURIComponent(rawQuery)}`;
              if (languageFilter) altUrl += `+language:${encodeURIComponent(languageFilter)}`;
              altUrl += `&type=${t}&s=${sortKey}&o=desc`;
              return `• ${typeNames[t]}: ${altUrl}`;
            })
            .join('\n');

        const filepath = await saveSearchResult('github-search', rawQuery, detailsContent);

        return makeTextResponse(
          `🐙 **GitHub搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_stackoverflow': {
        const rawQuery = normalizeString(args.query);
        const tagsInput = normalizeString(args.tags);
        const requestedSort = normalizeString(args.sort).toLowerCase();

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const sortNames = {
          relevance: '相关性',
          votes: '投票数',
          creation: '创建时间',
          activity: '活跃度'
        };

        const sortKey = pickKey(sortNames, requestedSort, 'relevance');

        let searchQuery = rawQuery;
        let tagList = [];
        if (tagsInput) {
          tagList = tagsInput
            .split(',')
            .map((t) => normalizeString(t))
            .filter(Boolean);
          if (tagList.length > 0) {
            searchQuery += ` ${tagList.map(t => `[${t}]`).join(' ')}`;
          }
        }

        const searchUrl = `https://stackoverflow.com/search?q=${encodeURIComponent(searchQuery)}&sort=${sortKey}`;
        const tagsDisplay = tagList.length > 0 ? tagList.join(', ') : '无';

        // StackOverflow 搜索技巧
        const tips = [
          `标签搜索: [javascript] ${rawQuery}`,
          `已回答问题: ${rawQuery} is:answer`,
          `已接受答案: ${rawQuery} isaccepted:yes`,
          `投票数筛选: ${rawQuery} score:5..`,
          `多个标签: [react] [hooks] ${rawQuery}`,
          `代码搜索: code:"${rawQuery}"`,
          `标题搜索: title:"${rawQuery}"`
        ];

        // 热门技术标签推荐
        const popularTags = [
          'javascript', 'python', 'java', 'react', 'node.js',
          'typescript', 'html', 'css', 'sql', 'docker'
        ];

        const detailsContent = `💬 StackOverflow 搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**标签筛选**: ${tagsDisplay}\n` +
          `**排序方式**: ${sortNames[sortKey]}\n\n` +
          `---\n\n` +
          `🔗 **搜索链接**: ${searchUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前10个问题的标题、投票数、回答数、是否已解决和链接"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **高级搜索技巧**:\n` +
          tips.map(tip => `• ${tip}`).join('\n') +
          `\n\n🏷️ **热门技术标签**:\n` +
          popularTags.map(tag => `• [${tag}]`).join(' ') +
          `\n\n📊 **其他排序方式**:\n` +
          Object.keys(sortNames)
            .filter(s => s !== sortKey)
            .map((s) =>
              `• ${sortNames[s]}: https://stackoverflow.com/search?q=${encodeURIComponent(searchQuery)}&sort=${s}`
            )
            .join('\n');

        const filepath = await saveSearchResult('stackoverflow-search', rawQuery, detailsContent);

        return makeTextResponse(
          `💬 **StackOverflow搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_npm': {
        const rawQuery = normalizeString(args.query);
        const resolvedSize = clampNumber(args.size, 1, 100, 10);

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const searchUrl = `https://www.npmjs.com/search?q=${encodeURIComponent(rawQuery)}`;
        const registryUrl = `https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(rawQuery)}&size=${resolvedSize}`;

        // NPM 搜索技巧
        const tips = [
          `精确包名: ${rawQuery} (使用完整包名)`,
          `关键词搜索: keywords:${rawQuery}`,
          `作者搜索: author:${rawQuery}`,
          `维护者: maintainer:${rawQuery}`,
          `作用域包: @scope/${rawQuery}`,
          `特定版本: ${rawQuery}@latest`
        ];

        // 相关搜索建议
        const relatedSearches = [
          `${rawQuery} typescript`,
          `${rawQuery} cli`,
          `${rawQuery} plugin`,
          `@types/${rawQuery}`
        ];

        // 热门类别推荐
        const categories = [
          'react', 'vue', 'express', 'webpack',
          'babel', 'eslint', 'testing', 'cli-tools'
        ];

        const detailsContent = `📦 NPM 包搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**期望结果数**: ${resolvedSize} 个\n\n` +
          `---\n\n` +
          `🔗 **网页搜索**: ${searchUrl}\n` +
          `🔗 **API搜索**: ${registryUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `// 方式1: 网页搜索\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前${resolvedSize}个包的：包名、描述、版本号、周下载量、最后更新时间"\n` +
          `})\n\n` +
          `// 方式2: API搜索 (推荐，结构化数据)\n` +
          `WebFetch({\n` +
          `  url: "${registryUrl}",\n` +
          `  prompt: "解析JSON数据，提取包的名称、描述、版本、作者和下载统计"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **NPM 搜索技巧**:\n` +
          tips.map(tip => `• ${tip}`).join('\n') +
          `\n\n📌 **相关搜索建议**:\n` +
          relatedSearches.map(s => `• ${s}`).join('\n') +
          `\n\n🏷️ **热门包分类**:\n` +
          categories.map(cat => `• ${cat}`).join(' ') +
          `\n\n📚 **直接访问包详情**: https://www.npmjs.com/package/${rawQuery}`;

        const filepath = await saveSearchResult('npm-search', rawQuery, detailsContent);

        return makeTextResponse(
          `📦 **NPM包搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_docs': {
        const rawQuery = normalizeString(args.query);
        const requestedFramework = normalizeString(args.framework).toLowerCase();

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const docUrls = {
          react: `https://react.dev/?search=${encodeURIComponent(rawQuery)}`,
          vue: `https://cn.vuejs.org/search/?query=${encodeURIComponent(rawQuery)}`,
          angular: `https://angular.io/api?query=${encodeURIComponent(rawQuery)}`,
          nodejs: `https://nodejs.org/api/all.html`,
          python: `https://docs.python.org/zh-cn/3/search.html?q=${encodeURIComponent(rawQuery)}`,
          java: `https://docs.oracle.com/en/java/javase/21/docs/api/search.html?q=${encodeURIComponent(rawQuery)}`,
          general: `https://developer.mozilla.org/zh-CN/search?q=${encodeURIComponent(rawQuery)}`
        };

        const frameworkNames = {
          react: 'React',
          vue: 'Vue.js',
          angular: 'Angular',
          nodejs: 'Node.js',
          python: 'Python',
          java: 'Java',
          general: 'MDN Web Docs'
        };

        const frameworkTips = {
          react: ['Hooks', 'Components', 'Props', 'State', 'Context', 'useEffect'],
          vue: ['组合式API', '响应式', 'computed', 'watch', '组件', '指令'],
          angular: ['Directives', 'Services', 'Modules', 'Components', 'Routing'],
          nodejs: ['fs', 'http', 'path', 'events', 'stream', 'crypto'],
          python: ['列表推导', '装饰器', '生成器', '异步', 'pandas', 'numpy'],
          java: ['Collections', 'Stream', 'Optional', 'Lambda', 'Generic'],
          general: ['HTML', 'CSS', 'JavaScript', 'Web API', 'HTTP']
        };

        const resolvedFramework = pickKey(docUrls, requestedFramework, 'general');

        const detailsContent = `📚 ${frameworkNames[resolvedFramework]} 文档搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**框架/语言**: ${frameworkNames[resolvedFramework]}\n\n` +
          `---\n\n` +
          `🔗 **文档链接**: ${docUrls[resolvedFramework]}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取文档内容**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${docUrls[resolvedFramework]}",\n` +
          `  prompt: "查找'${rawQuery}'相关的：API说明、参数列表、返回值、使用示例、注意事项"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **${frameworkNames[resolvedFramework]} 常用主题**:\n` +
          frameworkTips[resolvedFramework].map(tip => `• ${tip}`).join(' | ') +
          `\n\n📚 **其他文档资源**:\n` +
          Object.keys(docUrls)
            .filter(f => f !== resolvedFramework)
            .map(f => `• ${frameworkNames[f]}: ${docUrls[f].replace(/\?.*$/, '')}`)
            .slice(0, 4)
            .join('\n');

        const filepath = await saveSearchResult('docs-search', rawQuery, detailsContent);

        return makeTextResponse(
          `📚 **技术文档搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${docUrls[resolvedFramework]}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_api_reference': {
        const rawApiName = normalizeString(args.api_name);
        const rawPlatform = normalizeString(args.platform);

        if (!rawApiName) {
          throw new Error('API名称不能为空');
        }
        if (!rawPlatform) {
          throw new Error('平台/库名称不能为空');
        }

        const searchUrls = {
          google: `https://www.google.com/search?q=${encodeURIComponent(`${rawPlatform} ${rawApiName} API documentation`)}`,
          devdocs: `https://devdocs.io/#q=${encodeURIComponent(`${rawPlatform} ${rawApiName}`)}`,
          github: `https://github.com/search?q=${encodeURIComponent(`${rawPlatform} ${rawApiName}`)}&type=code`
        };

        // 常见平台的直接文档链接
        const platformDocs = {
          express: `https://expressjs.com/en/api.html`,
          axios: `https://axios-http.com/docs/api_intro`,
          lodash: `https://lodash.com/docs/`,
          mongoose: `https://mongoosejs.com/docs/api.html`,
          sequelize: `https://sequelize.org/api/`,
          'socket.io': `https://socket.io/docs/v4/`,
          jwt: `https://github.com/auth0/node-jsonwebtoken#readme`
        };

        const directDoc = platformDocs[rawPlatform.toLowerCase()];

        const detailsContent = `🔗 API 参考搜索\n\n` +
          `**平台/库**: ${rawPlatform}\n` +
          `**API名称**: ${rawApiName}\n\n` +
          `---\n\n` +
          `🔍 **搜索资源**:\n` +
          `• Google: ${searchUrls.google}\n` +
          `• DevDocs: ${searchUrls.devdocs}\n` +
          `• GitHub: ${searchUrls.github}\n` +
          (directDoc ? `• 官方文档: ${directDoc}\n` : '') +
          `\n⚠️ **请使用 WebFetch 工具获取API文档**:\n` +
          `\`\`\`javascript\n` +
          `// 推荐：先搜索官方文档\n` +
          `WebFetch({\n` +
          `  url: "${directDoc || searchUrls.google}",\n` +
          `  prompt: "查找'${rawApiName}'的：函数签名、参数说明、返回值、使用示例、注意事项"\n` +
          `})\n\n` +
          `// 备选：在DevDocs搜索\n` +
          `WebFetch({\n` +
          `  url: "${searchUrls.devdocs}",\n` +
          `  prompt: "提取${rawPlatform}的${rawApiName} API详细文档"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **查询提示**:\n` +
          `• 精确搜索: "${rawPlatform}.${rawApiName}()"\n` +
          `• 示例代码: ${rawPlatform} ${rawApiName} example\n` +
          `• 参数说明: ${rawPlatform} ${rawApiName} parameters\n` +
          `• 错误处理: ${rawPlatform} ${rawApiName} error handling\n\n` +
          `📚 **相关资源**:\n` +
          `• NPM包: https://www.npmjs.com/package/${rawPlatform}\n` +
          `• GitHub仓库: https://github.com/search?q=${encodeURIComponent(rawPlatform)}&type=repositories\n` +
          `• StackOverflow: https://stackoverflow.com/search?q=${encodeURIComponent(`${rawPlatform} ${rawApiName}`)}`;

        const filepath = await saveSearchResult('api-search', rawApiName, detailsContent);

        return makeTextResponse(
          `🔗 **API参考搜索**\n\n` +
          `**关键词**: ${rawApiName}\n` +
          `**搜索链接**: ${directDoc || searchUrls.google}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      // === 国内搜索工具 ===
      case 'ai_search_wechat_docs': {
        const rawQuery = normalizeString(args.query);
        const platformInput = normalizeString(args.platform).toLowerCase();

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const platformUrls = {
          miniprogram: `https://developers.weixin.qq.com/miniprogram/dev/framework/`,
          officialaccount: `https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html`,
          open: `https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/getting_started/how_to_read.html`,
          payment: `https://pay.weixin.qq.com/wiki/doc/apiv3/index.shtml`,
          all: `https://developers.weixin.qq.com/`
        };

        // 构建搜索URL（微信文档使用百度站内搜索）
        const searchUrl = `https://www.baidu.com/s?wd=site:developers.weixin.qq.com ${encodeURIComponent(rawQuery)}`;

        const platformNames = {
          miniprogram: '小程序',
          officialaccount: '公众号',
          open: '开放平台',
          payment: '微信支付',
          all: '全平台'
        };

        const resolvedPlatform = pickKey(platformNames, platformInput, 'all');

        // 常用API分类
        const apiCategories = {
          miniprogram: ['wx.request', 'wx.getUserInfo', 'wx.login', 'wx.showToast', 'wx.navigateTo'],
          officialaccount: ['接收消息', '发送消息', '自定义菜单', '网页授权', '模板消息'],
          payment: ['JSAPI支付', '小程序支付', 'APP支付', '退款', '对账单']
        };

        const detailsContent = `📱 微信开发者文档搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**平台类型**: ${platformNames[resolvedPlatform]}\n\n` +
          `---\n\n` +
          `🔗 **站内搜索**: ${searchUrl}\n` +
          `🔗 **${platformNames[resolvedPlatform]}文档**: ${platformUrls[resolvedPlatform]}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `// 方式1: 百度站内搜索\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取微信文档中关于'${rawQuery}'的搜索结果"\n` +
          `})\n\n` +
          `// 方式2: 直接访问文档首页\n` +
          `WebFetch({\n` +
          `  url: "${platformUrls[resolvedPlatform]}",\n` +
          `  prompt: "在文档中查找'${rawQuery}'相关内容"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **常用${platformNames[resolvedPlatform]}API**:\n` +
          (apiCategories[resolvedPlatform] || ['基础组件', 'API接口', '开发工具']).map(api => `• ${api}`).join(' | ') +
          `\n\n📚 **其他微信平台**:\n` +
          Object.keys(platformNames)
            .filter(p => p !== resolvedPlatform)
            .map(p => `• ${platformNames[p]}: ${platformUrls[p]}`)
            .slice(0, 3)
            .join('\n') +
          `\n\n🔗 **开发者社区**: https://developers.weixin.qq.com/community/`;

        const filepath = await saveSearchResult('wechat-docs', rawQuery, detailsContent);

        return makeTextResponse(
          `📱 **微信开发者文档搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_csdn':
      case 'ai_search_juejin':
      case 'ai_search_segmentfault':
      case 'ai_search_cnblogs':
      case 'ai_search_oschina':
      case 'ai_search_aliyun_docs':
      case 'ai_search_tencent_docs': {
        const rawQuery = normalizeString(args.query);

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const searchUrls = {
          ai_search_csdn: `https://so.csdn.net/so/search?q=${encodeURIComponent(rawQuery)}`,
          ai_search_juejin: `https://juejin.cn/search?query=${encodeURIComponent(rawQuery)}`,
          ai_search_segmentfault: `https://segmentfault.com/search?q=${encodeURIComponent(rawQuery)}`,
          ai_search_cnblogs: `https://zzk.cnblogs.com/s?w=${encodeURIComponent(rawQuery)}`,
          ai_search_oschina: `https://www.oschina.net/search?scope=all&q=${encodeURIComponent(rawQuery)}`,
          ai_search_aliyun_docs: `https://help.aliyun.com/search?spm=a2c4g.11186623.0.0&k=${encodeURIComponent(rawQuery)}`,
          ai_search_tencent_docs: `https://cloud.tencent.com/search?s=doc&keyword=${encodeURIComponent(rawQuery)}`
        };

        const platformInfo = {
          ai_search_csdn: {
            name: 'CSDN',
            icon: '📝',
            description: '中国最大的IT社区和服务平台',
            tips: ['博客文章', '技术问答', '代码片段', '下载资源'],
            homepage: 'https://www.csdn.net/',
            toolKey: 'csdn-search'
          },
          ai_search_juejin: {
            name: '掘金',
            icon: '💎',
            description: '面向开发者的技术内容分享平台',
            tips: ['前端开发', '后端开发', 'Android', 'iOS', '人工智能'],
            homepage: 'https://juejin.cn/',
            toolKey: 'juejin-search'
          },
          ai_search_segmentfault: {
            name: 'SegmentFault',
            icon: '🔧',
            description: '中文技术问答社区',
            tips: ['技术问答', '技术文章', '活动沙龙', '编程挑战'],
            homepage: 'https://segmentfault.com/',
            toolKey: 'sf-search'
          },
          ai_search_cnblogs: {
            name: '博客园',
            icon: '📚',
            description: '开发者的网上家园',
            tips: ['.NET', 'C#', 'Java', 'Python', '数据库'],
            homepage: 'https://www.cnblogs.com/',
            toolKey: 'cnblogs-search'
          },
          ai_search_oschina: {
            name: '开源中国',
            icon: '🌐',
            description: '中国最大的开源技术社区',
            tips: ['开源项目', '技术资讯', '代码托管', '协作翻译'],
            homepage: 'https://www.oschina.net/',
            toolKey: 'oschina-search'
          },
          ai_search_aliyun_docs: {
            name: '阿里云文档',
            icon: '☁️',
            description: '阿里云产品文档中心',
            tips: ['ECS', 'OSS', 'RDS', 'SLB', '容器服务'],
            homepage: 'https://help.aliyun.com/',
            toolKey: 'aliyun-docs'
          },
          ai_search_tencent_docs: {
            name: '腾讯云文档',
            icon: '☁️',
            description: '腾讯云产品文档中心',
            tips: ['CVM', 'COS', 'CDN', 'SCF', '数据库'],
            homepage: 'https://cloud.tencent.com/document/product',
            toolKey: 'tencent-docs'
          }
        };

        const info = platformInfo[name];
        const searchUrl = searchUrls[name];

        const detailsContent = `${info.icon} ${info.name} 搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**平台介绍**: ${info.description}\n\n` +
          `---\n\n` +
          `🔗 **搜索链接**: ${searchUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前10条搜索结果（标题、作者、发布时间、摘要、链接）"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **${info.name} 热门主题**:\n` +
          info.tips.map(tip => `• ${tip}`).join(' | ') +
          `\n\n🏠 **平台首页**: ${info.homepage}\n\n` +
          `📌 **搜索建议**:\n` +
          `• 使用精确关键词获得更好的结果\n` +
          `• 结合多个平台搜索可获得更全面的信息\n` +
          `• 关注文章的发布时间，优先查看最新内容`;

        const filepath = await saveSearchResult(info.toolKey, rawQuery, detailsContent);

        return makeTextResponse(
          `${info.icon} **${info.name}搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      default:
        throw new Error(`Unknown tool: ${name}`);
    }
  } catch (error) {
    return {
      content: [
        {
          type: 'text',
          text: `❌ 错误: ${error instanceof Error ? error.message : String(error)}`,
        },
      ],
      isError: true,
    };
  }
});

mcp_server_node.js:54-71 (helper)

Helper function used by ai_search_web handler to save detailed search results to a markdown file.

const saveSearchResult = async (toolName, query, details) => {
  try {
    const resultsDir = join(process.cwd(), '.search-results');
    if (!existsSync(resultsDir)) {
      await mkdir(resultsDir, { recursive: true });
    }

    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
    const filename = `${toolName}-${timestamp}.md`;
    const filepath = join(resultsDir, filename);

    await writeFile(filepath, details, 'utf-8');
    return filepath;
  } catch (error) {
    console.error('Failed to save search result:', error);
    return null;
  }
};

Tool Definition Quality

A3.6/5.0

Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It reveals the tool returns search URLs rather than actual content, which is valuable behavioral information. However, it doesn't disclose other important traits like rate limits, authentication needs, pagination behavior, or what happens with invalid queries. The description adds some context but leaves significant behavioral aspects unspecified.

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

Conciseness4/5

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

The description is appropriately sized with two sentences that both earn their place. The first sentence establishes the core functionality, and the second provides critical usage guidance about URL returns and WebFetch integration. The emoji and formatting are slightly decorative but don't detract from the essential information. It could be slightly more structured but is generally efficient.

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

Completeness3/5

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

Given no annotations and no output schema, the description provides adequate but incomplete context. It explains the core behavior (returns search URLs) and integration requirement (use WebFetch), which addresses the most critical gap. However, for a web search tool with 3 parameters and many sibling alternatives, it should ideally provide more guidance about when to choose this versus specialized search tools, and more details about the URL format or result structure.

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%, so the schema already fully documents all three parameters (query, engine, count) with descriptions and defaults. The description doesn't add any parameter semantics beyond what's in the schema - it doesn't explain query formatting, engine selection criteria, or count limitations. Baseline 3 is appropriate when the schema does all the parameter documentation work.

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 clearly states the tool performs '通用网络搜索' (general web search) and lists specific search engines (Google/Bing/百度/搜狗), providing a specific verb+resource. However, it doesn't explicitly distinguish this general web search tool from its many specialized sibling tools (like ai_search_github, ai_search_stackoverflow, etc.) that search specific platforms.

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

Usage Guidelines4/5

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

The description provides clear context about when to use this tool - for general web searches across major search engines. The 【重要】 section explicitly states this tool returns search URLs that should be accessed with WebFetch tool, providing important usage guidance. However, it doesn't explicitly say when NOT to use it versus the specialized sibling tools for platform-specific searches.

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

Install Server

Other Tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/adminhuan/smart-search-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server