WebSearch - Advanced Web Search and Content Extraction Tool

概述

WebSearch 是一个强大的网络搜索和内容提取工具，使用 Python 构建，通过 Model Context Protocol (MCP) 与 Claude 无缝集成。

前提条件

• Python 3.8+
• uv 包管理器
• Firecrawl API 密钥
• OpenAI API 密钥（可选）

安装步骤

1. 安装 uv

   # Windows
   pip install uv
   
   # Unix/MacOS
   curl -LsSf https://astral.sh/uv/install.sh | sh
   export PATH="$HOME/.local/bin:$PATH"
   

2. 克隆并设置项目

   git clone https://github.com/yourusername/websearch.git
   cd websearch
   
   # 创建并激活虚拟环境
   uv venv
   
   # Windows激活
   .venv\Scripts\activate.ps1
   
   # Unix/MacOS激活
   source .venv/bin/activate
   
   # 安装依赖
   uv sync
   

3. 配置API密钥

   # 创建.env文件
   cp .env.example .env
   # 编辑文件添加API密钥
   # FIRECRAWL_API_KEY=your_key_here
   # OPENAI_API_KEY=your_key_here
   

与Claude桌面版集成

1. 找到Claude配置文件:

   • Windows: %AppData%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加WebSearch配置:

   {
     "mcpServers": {
       "websearch": {
         "command": "uv",
         "args": [
           "--directory",
           "D:\\ABSOLUTE\\PATH\\TO\\WebSearch",
           "run",
           "main.py"
         ]
       }
     }
   }
   

3. 重启Claude以应用更改

功能和用法

WebSearch提供四个主要工具:

1. 搜索 - 执行网络搜索查询
2. 提取信息 - 从URL提取特定信息
3. 爬取网站 - 以可配置的深度爬取网站
4. 抓取内容 - 抓取单个URL的内容

设置完成后，可以在Claude桌面版工具菜单(锤子图标)中找到这些功能。

故障排除

• 确保所有API密钥正确设置
• 验证配置文件路径使用绝对路径
• 检查环境变量是否正确加载
• 确认API密钥有效且未过期

获取帮助

如有问题，请联系José Martín Rodriguez Mortaloni @m4s1t425

---

查看完整文档获取更多详细信息和高级配置选项。