ai_search_csdn

Search CSDN technical blogs and Q&A content to find programming solutions and tutorials. Returns search URLs for accessing detailed results through web fetching tools.

Instructions

📝 CSDN搜索 - 搜索CSDN技术博客和问答

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

Input Schema

TableJSON Schema

Name	Required	Description	Default
`query`	Yes	搜索关键词
`type`	No	搜索类型	all

Implementation Reference

mcp_server_node.js:167-177 (schema)

Schema definition for the ai_search_csdn tool, including input parameters: query (required string), type (enum: blog/ask/all).

{
  name: 'ai_search_csdn',
  description: '📝 CSDN搜索 - 搜索CSDN技术博客和问答\n\n【重要】此工具会返回CSDN搜索URL，Claude Code应该使用WebFetch工具访问该URL以获取真实搜索结果。',
  inputSchema: {
    type: 'object',
    properties: {
      query: { type: 'string', description: '搜索关键词' },
      type: { type: 'string', enum: ['blog', 'ask', 'all'], description: '搜索类型', default: 'all' }
    },
    required: ['query']
  }

mcp_server_node.js:824-939 (handler)

Handler for ai_search_csdn (shared with similar domestic search tools): validates query, selects CSDN-specific search URL and platform info, generates detailed Markdown response with WebFetch instructions, saves to file, returns text response.

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 工具访问搜索链接获取结果`
  );
}

mcp_server_node.js:252-254 (registration)
Registers the ai_search_csdn tool (among others in AI_TOOLS array) for the ListToolsRequestSchema.
```
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: AI_TOOLS,
}));
```

mcp_server_node.js:837-939 (helper)

Helper configuration objects for search URLs and platform information used in the handler for ai_search_csdn.

  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 工具访问搜索链接获取结果`
  );
}

mcp_server_node.js:256-955 (registration)

Registers the CallToolRequestSchema handler which includes the switch case for executing ai_search_csdn.

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,
    };
  }
});

Smart Search MCP

ai_search_csdn

Instructions

Input Schema

Implementation Reference

Other Tools

Latest Blog Posts

MCP directory API