🚀 网页搜索

WebSearch 是一款强大的网页信息检索工具，借助 MCP 协议与模型交互。它能解析结构化搜索结果，还提供丰富的自定义选项，可灵活适配不同的使用场景。

🚀 快速开始

WebSearch 可通过 MCP 协议与模型进行交互，下面是一个简单的使用示例：

import { createMCPClient } from '@modelcontextprotocol/sdk';

// 创建 MCP 客户端
const client = createMCPClient({
  transport: { type: 'subprocess', command: 'npx websearch-mcp' }
});

// 执行一次网络搜索
const response = await client.request({
  method: 'call_tool',
  params: {
    name: 'web_search',
    arguments: {
      query: 'machine learning trends',
      numResults: 5,
      language: 'en'
    }
  }
});

console.log(response.result);

✨ 主要特性

核心功能

• 网络搜索：支持利用多个搜索引擎开展信息检索工作。
• 结果解析：能够对结构化的搜索结果进行解析，涵盖标题、摘要、链接等内容。
• 多种语言支持：支持返回多国语言的搜索结果。

自定义选项

• 结果数量：可自行指定返回的结果数量，默认返回 5 条。
• 语言过滤：能够指定搜索结果的语言。
• 域名排除/包含：可选择性地排除或包含特定域名的搜索结果。
• 关键词过滤：支持排除特定的关键词或短语。

示例响应

以下是一个典型的搜索响应示例：

{
  "query": "machine learning trends",
  "results": [
    {
      "title": "2025年人工智能趋势预测",
      "snippet": "2025年的人工智能发展趋势包括多模态AI、生成式模型和量子人工智能在企业中的应用...",
      "url": "https://example.com/ml-trends-2025",
      "siteName": "AI研究今日",
      "byline": "简·史密斯博士"
    },
    {
      "title": "2020至2025年人工智能演变历程",
      "snippet": "过去五年中，人工智能已经从监督学习方法发展到更复杂的自监督和强化学习范式...",
      "url": "https://example.com/ml-evolution",
      "siteName": "科技见解",
      "byline": "约翰·多伊"
    }
  ]
}

📦 安装指南

作为依赖安装

npm install websearch-mcp-sdk

克隆仓库

git clone https://github.com/yourusername/websearch.git
cd websearch
npm install

📚 详细文档

运行环境要求

• 操作系统：支持 Linux、Windows、macOS。
• Node.js 版本：需要 Node.js 14 或更高版本。

项目结构

websearch/
├── .gitignore
├── .npmignore
├── package.json
├── src/
│   ├── index.ts
│   └── types/
└── dist/
    └── main.js

开发步骤

1. 克隆仓库到本地。
2. 安装项目依赖：npm install
3. 启动开发服务器：npm run dev

问题排查

常见问题

• API 不可达：确保 WebSearch 服务正在运行，并且 API_URL 配置正确。
• 搜索结果不可用：检查 WebSearch 服务的日志以排除错误：

  docker-compose logs crawler
  

• FlareSolverr 问题：如果遇到 Cloudflare 防护，检查 FlareSolverr 是否正常运行：

  docker-compose logs flaresolverr
  

其他资源

• MCP 协议文档
• TypeScript 类型定义

📄 许可证

本项目采用 ISC 许可证。