ai-web-search 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Web Search
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,382 @@
+# AI Web Search
+
+🔍 为AI助手提供联网搜索能力的轻量级工具
+
+## 功能特点
+
+- **开箱即用**：从GitHub克隆后 `npm install` 即可使用，无需复杂配置
+- **免费搜索**：使用 DuckDuckGo 搜索引擎，无需API密钥
+- **智能回退**：DuckDuckGo不可用时自动切换到百度搜索，确保可用性
+- **兼容性强**：提供标准HTTP API，可与任何AI软件集成
+- **轻量快速**：启动速度快，资源占用少
+- **隐私保护**：不记录搜索历史，保护用户隐私
+
+## 安装
+
+### 方式1：从GitHub安装（推荐）
+
+```bash
+# 克隆仓库
+git clone https://github.com/your-username/ai-web-search.git
+
+# 进入项目目录
+cd ai-web-search
+
+# 安装依赖
+npm install
+
+# 创建全局命令（可选）
+npm link
+```
+
+### 方式2：直接从GitHub安装
+
+```bash
+# 直接从GitHub安装
+npm install git+https://github.com/your-username/ai-web-search.git
+
+# 或者指定分支
+npm install git+https://github.com/your-username/ai-web-search.git#main
+```
+
+### 方式3：下载ZIP文件
+
+1. 从GitHub下载ZIP文件
+2. 解压到本地目录
+3. 进入目录运行 `npm install`
+
+## 快速开始
+
+### 1. 启动服务器
+
+```bash
+# 如果已创建全局命令
+ai-web-search
+
+# 或者直接运行
+node src/index.js
+
+# 或者使用npm脚本
+npm start
+```
+
+服务器默认运行在 `http://localhost:3000`
+
+### 2. 测试搜索
+
+```bash
+# 使用curl测试
+curl "http://localhost:3000/search?query=人工智能最新发展"
+
+# 或者在浏览器中访问
+http://localhost:3000/search?query=人工智能最新发展
+```
+
+### 3. 集成到AI软件
+
+在你的AI软件中添加以下工具配置：
+
+```json
+{
+  "name": "web_search",
+  "endpoint": "http://localhost:3000/search",
+  "method": "GET",
+  "parameters": {
+    "query": "string",
+    "limit": "integer",
+    "type": "string"
+  }
+}
+```
+
+## 配置选项
+
+### 命令行参数
+
+```bash
+ai-web-search [选项]
+
+选项：
+  -p, --port <端口>      服务器端口（默认：3000）
+  -H, --host <主机>      服务器主机（默认：localhost）
+  -d, --dev              开发模式运行
+  -s, --search-function <路径>  自定义搜索引擎模块路径
+  -h, --help             显示帮助信息
+  -v, --version          显示版本号
+```
+
+### 环境变量
+
+创建 `.env` 文件：
+
+```env
+PORT=3000
+HOST=localhost
+RATE_LIMIT_MAX=100
+SEARCH_FUNCTION_PATH=./examples/custom-search.js
+```
+
+### 自定义搜索引擎
+
+如果默认的DuckDuckGo搜索引擎无法使用（如网络限制），你可以提供自定义搜索引擎实现。
+
+#### 创建自定义搜索引擎模块
+
+```javascript
+// custom-search.js
+async function customSearch(query, options = {}) {
+  const { limit = 5, timeRange = 'month', type = 'web' } = options;
+  
+  // 实现你的搜索逻辑
+  // 可以是百度、搜狗、Bing等搜索引擎的API调用
+  // 或者爬虫实现
+  
+  return {
+    results: [
+      {
+        title: '搜索结果标题',
+        url: 'https://example.com',
+        description: '搜索结果描述',
+        source: 'custom'
+      }
+    ]
+  };
+}
+
+module.exports = customSearch;
+```
+
+#### 使用自定义搜索引擎
+
+```bash
+# 命令行参数
+ai-web-search -s ./custom-search.js
+
+# 环境变量
+SEARCH_FUNCTION_PATH=./custom-search.js ai-web-search
+
+# .env 文件
+SEARCH_FUNCTION_PATH=./custom-search.js
+```
+
+详细的自定义搜索引擎示例请参考 `examples/custom-search.js` 文件。
+
+## API 文档
+
+### 搜索接口
+
+```
+GET /search
+```
+
+**参数：**
+
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+|------|------|------|--------|------|
+| query | string | 是 | - | 搜索查询关键词 |
+| limit | integer | 否 | 5 | 返回结果数量（1-20） |
+| type | string | 否 | web | 搜索类型：web（网页）或 news（新闻） |
+
+**响应示例：**
+
+```json
+{
+  "query": "人工智能",
+  "results": [
+    {
+      "title": "人工智能发展现状",
+      "url": "https://example.com/ai-development",
+      "snippet": "人工智能正在快速发展...",
+      "source": "duckduckgo"
+    }
+  ],
+  "totalResults": 10,
+  "timestamp": "2026-06-08T10:30:00.000Z"
+}
+```
+
+### 工具定义接口
+
+```
+GET /tool-definition
+```
+
+返回兼容 OpenAI 工具格式的 JSON 定义：
+
+```json
+{
+  "type": "function",
+  "function": {
+    "name": "web_search",
+    "description": "Search the internet to get latest information",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "The search query to find information"
+        },
+        "limit": {
+          "type": "integer",
+          "description": "Number of results to return (default: 5, max: 20)",
+          "default": 5
+        },
+        "type": {
+          "type": "string",
+          "enum": ["web", "news"],
+          "description": "Type of search",
+          "default": "web"
+        }
+      },
+      "required": ["query"]
+    }
+  }
+}
+```
+
+### 搜索建议接口
+
+```
+GET /suggest?query=部分关键词
+```
+
+### 健康检查接口
+
+```
+GET /health
+```
+
+## 使用示例
+
+### Python AI 助手集成
+
+```python
+import requests
+
+def web_search(query, limit=5):
+    response = requests.get(
+        "http://localhost:3000/search",
+        params={"query": query, "limit": limit}
+    )
+    return response.json()
+
+# 使用示例
+results = web_search("最新的AI技术")
+print(results)
+```
+
+### JavaScript AI 助手集成
+
+```javascript
+async function webSearch(query, limit = 5) {
+  const response = await fetch(
+    `http://localhost:3000/search?query=${encodeURIComponent(query)}&limit=${limit}`
+  );
+  return await response.json();
+}
+
+// 使用示例
+const results = await webSearch("机器学习最新进展");
+console.log(results);
+```
+
+## 故障排除
+
+### 1. 端口被占用
+
+```bash
+# 使用其他端口
+ai-web-search -p 8080
+```
+
+### 2. 搜索无结果
+
+- 检查网络连接
+- 尝试不同的搜索关键词
+- 查看服务器日志
+
+### 3. 连接被拒绝
+
+- 确认服务器正在运行
+- 检查防火墙设置
+- 验证端口是否正确
+
+### 4. Git克隆失败
+
+```bash
+# 如果git clone失败，检查网络连接
+git config --global http.proxy  # 设置代理（如果需要）
+
+# 或者使用SSH方式（需要配置SSH密钥）
+git clone git@github.com:your-username/ai-web-search.git
+
+# 如果证书问题，可以临时跳过SSL验证（不推荐）
+git -c http.sslVerify=false clone https://github.com/your-username/ai-web-search.git
+```
+
+### 5. npm install失败
+
+```bash
+# 清除npm缓存
+npm cache clean --force
+
+# 使用淘宝镜像（国内加速）
+npm install --registry=https://registry.npmmirror.com
+
+# 检查Node.js版本
+node --version  # 需要 >= 14.0.0
+```
+
+## 开发
+
+### 本地开发
+
+```bash
+# 克隆项目
+git clone https://github.com/your-username/ai-web-search.git
+cd ai-web-search
+
+# 安装依赖
+npm install
+
+# 开发模式运行
+npm run dev
+
+# 运行测试
+npm test
+```
+
+### 项目结构
+
+```
+ai-web-search/
+├── bin/
+│   └── cli.js           # 命令行入口
+├── src/
+│   ├── index.js         # 主入口
+│   ├── server.js        # HTTP服务器
+│   └── search.js        # 搜索引擎模块
+├── examples/
+│   ├── custom-search.js # 自定义搜索引擎示例
+│   └── baidu-search.js  # 百度搜索引擎实现
+├── test/
+│   ├── test.js          # 测试文件
+│   └── test-custom.js   # 自定义搜索测试
+├── package.json
+├── README.md
+├── .gitignore
+└── .env.example
+```
+
+## 许可证
+
+MIT License
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 相关项目
+
+- [duck-duck-scrape](https://github.com/Snazzah/duck-duck-scrape) - DuckDuckGo 搜索库
+- [Express](https://expressjs.com/) - Web 框架

package/bin/cli.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+const { createServer } = require('../src/server');
+const dotenv = require('dotenv');
+
+// Load environment variables
+dotenv.config();
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+const options = {};
+
+for (let i = 0; i < args.length; i++) {
+  switch (args[i]) {
+    case '-p':
+    case '--port':
+      options.port = parseInt(args[++i]) || 3000;
+      break;
+    case '-H':
+    case '--host':
+      options.host = args[++i] || 'localhost';
+      break;
+    case '-d':
+    case '--dev':
+      options.dev = true;
+      break;
+    case '-s':
+    case '--search-function':
+      options.searchFn = args[++i];
+      break;
+    case '-h':
+    case '--help':
+      showHelp();
+      process.exit(0);
+      break;
+    case '-v':
+    case '--version':
+      showVersion();
+      process.exit(0);
+      break;
+  }
+}
+
+// Configuration
+const config = {
+  port: options.port || process.env.PORT || 3000,
+  host: options.host || process.env.HOST || 'localhost',
+  dev: options.dev || process.argv.includes('--dev'),
+  searchFnPath: options.searchFn || process.env.SEARCH_FUNCTION_PATH || null,
+  rateLimit: {
+    windowMs: 15 * 60 * 1000,
+    max: parseInt(process.env.RATE_LIMIT_MAX) || 100
+  }
+};
+
+function showHelp() {
+  console.log(`
+🔍 AI Web Search - Enable AI assistants to search the internet
+
+Usage:
+  ai-web-search [options]
+
+Options:
+  -p, --port <port>      Port to run server on (default: 3000)
+  -H, --host <host>      Host to bind server to (default: localhost)
+  -d, --dev              Run in development mode
+  -s, --search-function <path>  Path to custom search function module
+  -h, --help             Show this help message
+  -v, --version          Show version number
+
+Environment Variables:
+  PORT                   Server port (default: 3000)
+  HOST                   Server host (default: localhost)
+  RATE_LIMIT_MAX         Max requests per 15 minutes (default: 100)
+  SEARCH_FUNCTION_PATH   Path to custom search function module
+
+Examples:
+  ai-web-search                    # Start with default settings
+  ai-web-search -p 8080           # Start on port 8080
+  ai-web-search -H 0.0.0.0        # Bind to all interfaces
+  ai-web-search --dev             # Start in development mode
+  `);
+}
+
+function showVersion() {
+  const pkg = require('../package.json');
+  console.log(pkg.version);
+}
+
+// Start server
+const server = createServer(config);
+
+server.listen(config.port, config.host, () => {
+  console.log(`🔍 AI Web Search server running at http://${config.host}:${config.port}`);
+  console.log(`📡 Search endpoint: http://${config.host}:${config.port}/search`);
+  console.log(`🔧 Environment: ${config.dev ? 'development' : 'production'}`);
+  console.log(`⚡ Press Ctrl+C to stop`);
+});
+
+// Handle graceful shutdown
+process.on('SIGINT', () => {
+  console.log('\n🛑 Shutting down server...');
+  server.close(() => {
+    console.log('✅ Server stopped');
+    process.exit(0);
+  });
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n🛑 Received SIGTERM, shutting down...');
+  server.close(() => {
+    console.log('✅ Server stopped');
+    process.exit(0);
+  });
+});

package/examples/baidu-search.js

@@ -0,0 +1,116 @@
+/**
+ * Baidu Search Engine for ai-web-search
+ * 
+ * 注意：此实现为爬虫方式，可能违反百度服务条款。
+ * 仅用于学习和测试，请勿用于商业用途。
+ * 
+ * @param {string} query - Search query
+ * @param {Object} options - Search options
+ * @returns {Promise<Object>} Search results
+ */
+const axios = require('axios');
+const cheerio = require('cheerio');
+
+async function baiduSearch(query, options = {}) {
+  const { limit = 5, type = 'web' } = options;
+  
+  console.log(`🔍 Baidu search: "${query}" (limit: ${limit}, type: ${type})`);
+  
+  try {
+    // 设置请求头，模拟浏览器
+    const headers = {
+      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+      'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8',
+      'Accept-Language': 'zh-CN,zh;q=0.9,en;q=0.8',
+      'Accept-Encoding': 'gzip, deflate',
+      'Connection': 'keep-alive',
+      'Upgrade-Insecure-Requests': '1'
+    };
+    
+    // 请求百度搜索
+    const response = await axios.get('https://www.baidu.com/s', {
+      params: {
+        wd: query,
+        rn: limit,
+        ie: 'utf-8'
+      },
+      headers,
+      timeout: 10000
+    });
+    
+    // 解析HTML
+    const $ = cheerio.load(response.data);
+    const results = [];
+    
+    // 百度搜索结果通常在 class 为 'result' 或 'c-container' 的div中
+    $('.result, .c-container').each((i, element) => {
+      if (results.length >= limit) return false;
+      
+      const titleElement = $(element).find('h3').first();
+      const title = titleElement.text().trim();
+      const url = titleElement.find('a').attr('href');
+      
+      // 获取摘要
+      const abstractElement = $(element).find('.c-abstract, .content-right_8Zs40');
+      const snippet = abstractElement.text().trim();
+      
+      // 有时候百度会用不同的结构
+      const alternativeSnippet = $(element).find('.c-span-last').text().trim();
+      
+      if (title && url) {
+        results.push({
+          title: title.replace(/\s+/g, ' '),
+          url: url,
+          snippet: snippet || alternativeSnippet || '暂无摘要',
+          source: 'baidu'
+        });
+      }
+    });
+    
+    // 如果没有找到结果，尝试其他选择器
+    if (results.length === 0) {
+      // 尝试更通用的选择器
+      $('div[id^="content_left"] > div').each((i, element) => {
+        if (results.length >= limit) return false;
+        
+        const titleElement = $(element).find('h3').first();
+        const title = titleElement.text().trim();
+        const url = titleElement.find('a').attr('href');
+        
+        const snippet = $(element).find('span.content-right_8Zs40, .c-abstract').text().trim();
+        
+        if (title && url && title !== '') {
+          results.push({
+            title: title.replace(/\s+/g, ' '),
+            url: url,
+            snippet: snippet || '暂无摘要',
+            source: 'baidu'
+          });
+        }
+      });
+    }
+    
+    console.log(`   Found ${results.length} results from Baidu`);
+    
+    return {
+      results: results.slice(0, limit)
+    };
+    
+  } catch (error) {
+    console.error('Baidu search error:', error.message);
+    
+    // 返回一个友好的错误信息，而不是抛出异常
+    return {
+      results: [
+        {
+          title: '百度搜索暂时不可用',
+          url: 'https://www.baidu.com',
+          snippet: `搜索出错: ${error.message}。请稍后重试或检查网络连接。`,
+          source: 'baidu-error'
+        }
+      ]
+    };
+  }
+}
+
+module.exports = baiduSearch;

package/examples/custom-search.js

@@ -0,0 +1,64 @@
+/**
+ * Example custom search function for ai-web-search
+ * 
+ * This function can be used as a template for implementing custom search engines.
+ * The function receives a query and options, and returns search results in the standard format.
+ * 
+ * Usage:
+ *   ai-web-search -s ./examples/custom-search.js
+ *   or
+ *   SEARCH_FUNCTION_PATH=./examples/custom-search.js ai-web-search
+ * 
+ * @param {string} query - Search query
+ * @param {Object} options - Search options
+ * @param {number} options.limit - Number of results to return
+ * @param {string} options.timeRange - Time range for search
+ * @param {string} options.type - Search type: 'web' or 'news'
+ * @returns {Promise<Object>} Search results
+ */
+async function customSearch(query, options = {}) {
+  const { limit = 5, timeRange = 'month', type = 'web' } = options;
+  
+  console.log(`🔍 Custom search: "${query}" (limit: ${limit}, type: ${type})`);
+  
+  // Example: Using a mock search engine
+  // In real implementation, you would call your custom search API here
+  
+  // Simulate API delay
+  await new Promise(resolve => setTimeout(resolve, 100));
+  
+  // Return mock results
+  const results = [
+    {
+      title: `Result 1 for "${query}"`,
+      url: `https://example.com/result1?q=${encodeURIComponent(query)}`,
+      description: `This is the first search result for "${query}". It contains relevant information about your query.`,
+      source: 'custom-search'
+    },
+    {
+      title: `Result 2 for "${query}"`,
+      url: `https://example.com/result2?q=${encodeURIComponent(query)}`,
+      description: `Another search result for "${query}". This provides additional information and perspectives.`,
+      source: 'custom-search'
+    },
+    {
+      title: `Result 3 for "${query}"`,
+      url: `https://example.com/result3?q=${encodeURIComponent(query)}`,
+      description: `Third result for "${query}". More details and related information.`,
+      source: 'custom-search'
+    }
+  ].slice(0, limit);
+  
+  return {
+    results: results.map(result => ({
+      title: result.title,
+      url: result.url,
+      description: result.description,
+      snippet: result.description, // alias for compatibility
+      source: result.source
+    }))
+  };
+}
+
+// Export the search function
+module.exports = customSearch;

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "ai-web-search",
+  "version": "1.0.0",
+  "description": "A lightweight tool that enables AI assistants to search the internet via local HTTP server",
+  "main": "src/index.js",
+  "type": "commonjs",
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node src/index.js --dev",
+    "test": "node test/test.js",
+    "lint": "eslint src/"
+  },
+  "keywords": [
+    "ai",
+    "search",
+    "duckduckgo",
+    "web-search",
+    "openai",
+    "tool",
+    "api"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "duck-duck-scrape": "^2.2.7",
+    "express": "^4.18.2",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express-rate-limit": "^7.1.5",
+    "axios": "^1.6.7",
+    "cheerio": "^1.0.0-rc.12"
+  },
+  "devDependencies": {
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "src/",
+    "bin/",
+    "examples/",
+    "test/",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "ai-web-search": "./bin/cli.js"
+  }
+}

package/src/index.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+const dotenv = require('dotenv');
+const { createServer } = require('./server');
+
+// Load environment variables
+dotenv.config();
+
+// Configuration
+const config = {
+  port: process.env.PORT || 3000,
+  host: process.env.HOST || 'localhost',
+  dev: process.argv.includes('--dev'),
+  searchFnPath: process.env.SEARCH_FUNCTION_PATH || null,
+  rateLimit: {
+    windowMs: 15 * 60 * 1000, // 15 minutes
+    max: parseInt(process.env.RATE_LIMIT_MAX) || 100 // limit each IP to 100 requests per windowMs
+  }
+};
+
+// Start server
+const server = createServer(config);
+
+server.listen(config.port, config.host, () => {
+  console.log(`🔍 AI Web Search server running at http://${config.host}:${config.port}`);
+  console.log(`📡 Search endpoint: http://${config.host}:${config.port}/search`);
+  console.log(`🔧 Environment: ${config.dev ? 'development' : 'production'}`);
+  console.log(`⚡ Press Ctrl+C to stop`);
+});
+
+// Handle graceful shutdown
+process.on('SIGINT', () => {
+  console.log('\n🛑 Shutting down server...');
+  server.close(() => {
+    console.log('✅ Server stopped');
+    process.exit(0);
+  });
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n🛑 Received SIGTERM, shutting down...');
+  server.close(() => {
+    console.log('✅ Server stopped');
+    process.exit(0);
+  });
+});

package/src/search.js

@@ -0,0 +1,224 @@
+const DuckDuckGo = require('duck-duck-scrape');
+let baiduSearchFn = null;
+try {
+  baiduSearchFn = require('../examples/baidu-search');
+} catch (e) {
+  // Baidu search module not available, ignore
+}
+
+class SearchEngine {
+  constructor(options = {}) {
+    this.options = {
+      safeSearch: options.safeSearch || DuckDuckGo.SafeSearchType.MODERATE,
+      timeout: options.timeout || 10000,
+      searchFn: options.searchFn || null,
+      ...options
+    };
+  }
+
+  /**
+   * Perform web search
+   * @param {string} query - Search query
+   * @param {Object} options - Search options
+   * @returns {Promise<Array>} Search results
+   */
+  async webSearch(query, options = {}) {
+    const { limit = 5, timeRange = 'month' } = options;
+    
+    try {
+      // Use custom search function if provided
+      if (this.options.searchFn) {
+        const searchResults = await this.options.searchFn(query, {
+          limit,
+          timeRange,
+          type: 'web',
+          ...options
+        });
+        
+        // Format results according to our standard
+        const results = (searchResults.results || []).slice(0, limit).map(result => ({
+          title: result.title || '',
+          url: result.url || '',
+          snippet: result.description || result.snippet || '',
+          source: result.source || 'custom'
+        }));
+
+        return {
+          query,
+          results,
+          totalResults: results.length,
+          timestamp: new Date().toISOString()
+        };
+      }
+      
+      // Default: Use DuckDuckGo
+      const searchResults = await DuckDuckGo.search(query, {
+        safeSearch: this.options.safeSearch,
+        timeRange,
+        ...this.options
+      });
+
+      // Limit and format results
+      const results = searchResults.results.slice(0, limit).map(result => ({
+        title: result.title,
+        url: result.url,
+        snippet: result.description,
+        source: result.source || 'duckduckgo'
+      }));
+
+      return {
+        query,
+        results,
+        totalResults: searchResults.results.length,
+        timestamp: new Date().toISOString()
+      };
+    } catch (error) {
+      console.log(`⚠️ DuckDuckGo search failed: ${error.message}`);
+      
+      // Try Baidu as fallback
+      if (baiduSearchFn) {
+        console.log('🔄 Trying Baidu as fallback...');
+        try {
+          const searchResults = await baiduSearchFn(query, {
+            limit,
+            timeRange,
+            type: 'web',
+            ...options
+          });
+          
+          const results = (searchResults.results || []).slice(0, limit).map(result => ({
+            title: result.title || '',
+            url: result.url || '',
+            snippet: result.description || result.snippet || '',
+            source: result.source || 'baidu-fallback'
+          }));
+
+          return {
+            query,
+            results,
+            totalResults: results.length,
+            timestamp: new Date().toISOString(),
+            note: 'Used Baidu as fallback due to DuckDuckGo failure'
+          };
+        } catch (fallbackError) {
+          console.log(`⚠️ Baidu fallback also failed: ${fallbackError.message}`);
+        }
+      }
+      
+      throw new Error(`Search failed: ${error.message}`);
+    }
+  }
+
+  /**
+   * Perform news search
+   * @param {string} query - Search query
+   * @param {Object} options - Search options
+   * @returns {Promise<Array>} News results
+   */
+  async newsSearch(query, options = {}) {
+    const { limit = 5, timeRange = 'week' } = options;
+    
+    try {
+      // Use custom search function if provided
+      if (this.options.searchFn) {
+        const searchResults = await this.options.searchFn(query, {
+          limit,
+          timeRange,
+          type: 'news',
+          ...options
+        });
+        
+        // Format results according to our standard
+        const results = (searchResults.results || []).slice(0, limit).map(result => ({
+          title: result.title || '',
+          url: result.url || '',
+          snippet: result.description || result.snippet || '',
+          source: result.source || 'custom',
+          date: result.publishedAt || result.date || new Date().toISOString()
+        }));
+
+        return {
+          query,
+          results,
+          totalResults: results.length,
+          timestamp: new Date().toISOString()
+        };
+      }
+      
+      // Default: Use DuckDuckGo
+      const searchResults = await DuckDuckGo.search(query, {
+        safeSearch: this.options.safeSearch,
+        news: true,
+        timeRange,
+        ...this.options
+      });
+
+      const results = searchResults.results.slice(0, limit).map(result => ({
+        title: result.title,
+        url: result.url,
+        snippet: result.description,
+        source: result.source,
+        date: result.publishedAt || new Date().toISOString()
+      }));
+
+      return {
+        query,
+        results,
+        totalResults: searchResults.results.length,
+        timestamp: new Date().toISOString()
+      };
+    } catch (error) {
+      console.log(`⚠️ DuckDuckGo news search failed: ${error.message}`);
+      
+      // Try Baidu as fallback for news
+      if (baiduSearchFn) {
+        console.log('🔄 Trying Baidu news as fallback...');
+        try {
+          const searchResults = await baiduSearchFn(query, {
+            limit,
+            timeRange,
+            type: 'news',
+            ...options
+          });
+          
+          const results = (searchResults.results || []).slice(0, limit).map(result => ({
+            title: result.title || '',
+            url: result.url || '',
+            snippet: result.description || result.snippet || '',
+            source: result.source || 'baidu-fallback',
+            date: result.publishedAt || result.date || new Date().toISOString()
+          }));
+
+          return {
+            query,
+            results,
+            totalResults: results.length,
+            timestamp: new Date().toISOString(),
+            note: 'Used Baidu as fallback due to DuckDuckGo failure'
+          };
+        } catch (fallbackError) {
+          console.log(`⚠️ Baidu news fallback also failed: ${fallbackError.message}`);
+        }
+      }
+      
+      throw new Error(`News search failed: ${error.message}`);
+    }
+  }
+
+  /**
+   * Get search suggestions (placeholder - not implemented in duck-duck-scrape)
+   * @param {string} query - Partial query
+   * @returns {Promise<Array>} Search suggestions
+   */
+  async getSuggestions(query) {
+    // duck-duck-scrape doesn't provide getSuggestions method
+    // Return empty suggestions for now
+    return {
+      query,
+      suggestions: [],
+      timestamp: new Date().toISOString()
+    };
+  }
+}
+
+module.exports = SearchEngine;

package/src/server.js

@@ -0,0 +1,156 @@
+const express = require('express');
+const cors = require('cors');
+const rateLimit = require('express-rate-limit');
+const SearchEngine = require('./search');
+
+function createServer(config) {
+  const app = express();
+  // Load custom search function if provided
+  let searchFn = null;
+  if (config.searchFnPath) {
+    try {
+      searchFn = require(config.searchFnPath);
+      console.log(`🔌 Loaded custom search function from ${config.searchFnPath}`);
+    } catch (error) {
+      console.error(`❌ Failed to load custom search function from ${config.searchFnPath}:`, error.message);
+    }
+  }
+  
+  const searchEngine = new SearchEngine({ searchFn });
+
+  // Middleware
+  app.use(cors());
+  app.use(express.json());
+  app.use(express.urlencoded({ extended: true }));
+
+  // Rate limiting
+  const limiter = rateLimit({
+    windowMs: config.rateLimit.windowMs,
+    max: config.rateLimit.max,
+    message: {
+      error: 'Too many requests',
+      message: 'Please try again later'
+    }
+  });
+  app.use('/search', limiter);
+
+  // Health check endpoint
+  app.get('/health', (req, res) => {
+    res.json({
+      status: 'healthy',
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime()
+    });
+  });
+
+  // Tool definition endpoint (for AI software integration)
+  app.get('/tool-definition', (req, res) => {
+    res.json({
+      type: 'function',
+      function: {
+        name: 'web_search',
+        description: 'Search the internet to get latest information. Useful for finding current events, facts, news, or any information that might have changed recently.',
+        parameters: {
+          type: 'object',
+          properties: {
+            query: {
+              type: 'string',
+              description: 'The search query to find information'
+            },
+            limit: {
+              type: 'integer',
+              description: 'Number of results to return (default: 5, max: 20)',
+              default: 5,
+              minimum: 1,
+              maximum: 20
+            },
+            type: {
+              type: 'string',
+              enum: ['web', 'news'],
+              description: 'Type of search: "web" for general web search, "news" for news articles',
+              default: 'web'
+            }
+          },
+          required: ['query']
+        }
+      }
+    });
+  });
+
+  // Main search endpoint
+  app.get('/search', async (req, res) => {
+    try {
+      const { query, limit = 5, type = 'web' } = req.query;
+
+      // Validate query
+      if (!query || typeof query !== 'string' || query.trim().length === 0) {
+        return res.status(400).json({
+          error: 'Invalid query',
+          message: 'Query parameter is required and must be a non-empty string'
+        });
+      }
+
+      // Validate limit
+      const searchLimit = Math.min(Math.max(parseInt(limit) || 5, 1), 20);
+
+      let results;
+      if (type === 'news') {
+        results = await searchEngine.newsSearch(query, { limit: searchLimit });
+      } else {
+        results = await searchEngine.webSearch(query, { limit: searchLimit });
+      }
+
+      res.json(results);
+    } catch (error) {
+      console.error('Search error:', error);
+      res.status(500).json({
+        error: 'Search failed',
+        message: error.message
+      });
+    }
+  });
+
+  // Search suggestions endpoint
+  app.get('/suggest', async (req, res) => {
+    try {
+      const { query } = req.query;
+
+      if (!query || typeof query !== 'string') {
+        return res.status(400).json({
+          error: 'Invalid query',
+          message: 'Query parameter is required'
+        });
+      }
+
+      const suggestions = await searchEngine.getSuggestions(query);
+      res.json(suggestions);
+    } catch (error) {
+      console.error('Suggestion error:', error);
+      res.status(500).json({
+        error: 'Failed to get suggestions',
+        message: error.message
+      });
+    }
+  });
+
+  // 404 handler
+  app.use((req, res) => {
+    res.status(404).json({
+      error: 'Not found',
+      message: `Endpoint ${req.path} does not exist`
+    });
+  });
+
+  // Error handler
+  app.use((err, req, res, next) => {
+    console.error('Server error:', err);
+    res.status(500).json({
+      error: 'Internal server error',
+      message: config.dev ? err.message : 'Something went wrong'
+    });
+  });
+
+  return app;
+}
+
+module.exports = { createServer };

package/test/test.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+const SearchEngine = require('../src/search');
+
+async function runTests() {
+  console.log('🧪 Running AI Web Search Tests\n');
+  
+  const searchEngine = new SearchEngine();
+  
+  // Test 1: Basic web search
+  console.log('1. Testing web search...');
+  try {
+    const webResults = await searchEngine.webSearch('人工智能最新发展', { limit: 3 });
+    console.log('✅ Web search successful');
+    console.log(`   Found ${webResults.results.length} results for "${webResults.query}"`);
+    if (webResults.results.length > 0) {
+      console.log(`   First result: ${webResults.results[0].title}`);
+      console.log(`   URL: ${webResults.results[0].url}`);
+    }
+    console.log('');
+  } catch (error) {
+    console.log('❌ Web search failed:', error.message);
+    console.log('');
+  }
+  
+  // Test 2: News search
+  console.log('2. Testing news search...');
+  try {
+    const newsResults = await searchEngine.newsSearch('科技新闻', { limit: 3 });
+    console.log('✅ News search successful');
+    console.log(`   Found ${newsResults.results.length} news results`);
+    if (newsResults.results.length > 0) {
+      console.log(`   Latest news: ${newsResults.results[0].title}`);
+    }
+    console.log('');
+  } catch (error) {
+    console.log('❌ News search failed:', error.message);
+    console.log('');
+  }
+  
+  // Test 3: Search suggestions
+  console.log('3. Testing search suggestions...');
+  try {
+    const suggestions = await searchEngine.getSuggestions('机器学');
+    console.log('✅ Suggestions successful');
+    console.log(`   Got ${suggestions.suggestions.length} suggestions`);
+    if (suggestions.suggestions.length > 0) {
+      console.log(`   First suggestion: ${suggestions.suggestions[0]}`);
+    }
+    console.log('');
+  } catch (error) {
+    console.log('❌ Suggestions failed:', error.message);
+    console.log('');
+  }
+  
+  console.log('🎉 All tests completed!');
+  console.log('\nNote: Some tests may fail due to network issues or DuckDuckGo rate limiting.');
+  console.log('If tests fail, try again in a few minutes.');
+}
+
+// Run tests
+runTests().catch(error => {
+  console.error('Test runner failed:', error);
+  process.exit(1);
+});