Websearch (Google)

🚀 網頁搜索

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 許可證。