smart-image-scraper-mcp 2.7.0 → 2.8.1

package/README.md

@@ -7,7 +7,7 @@
 
 ## ✨ 核心特性
 
-### 🚀 高性能架构 (v2.7.0)
+### 🚀 高性能架构 (v2.8.0)
 - **多请求并行**：同时处理 5 个 MCP 请求
 - **并行翻页搜索**：同时获取多页结果，速度提升 5x
 - **HTTP 连接池**：Keep-Alive 复用 TCP 连接
@@ -86,6 +86,8 @@ npm install
 - "下载 20 张高清风景壁纸"
 - "找一些人物头像图片"
 
+> ⚠️ **重要限制**：同一会话中连续调用不要超过 5 次！需要多种类型图片时，使用批量查询（逗号分隔关键词）。
+
 ## Tool Schema
 
 ### smart_scraper
@@ -281,6 +283,7 @@ npm test
 
 | 版本 | 日期 | 主要更新 |
 |------|------|----------|
+| 2.8.0 | 2026-02 | 添加熔断机制：30秒全局超时、快速失败返回、降低搜索超时至8秒 |
 | 2.7.0 | 2026-02 | 新增质量控制：quality 参数（fast/balanced/high）、minFileSize 文件大小过滤 |
 | 2.4.0 | 2026-02 | 修复所有分析问题：超时策略统一、缓存键一致、版本号动态读取 |
 | 2.3.0 | 2026-02 | 性能优化：HTTP 连接池、并行翻页搜索、内存泄漏修复 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-image-scraper-mcp",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "description": "全网智能图片抓取 MCP 服务器 - 支持 Bing/Google 图片搜索、验证和下载",
   "main": "src/index.js",
   "type": "module",

package/src/index.js

@@ -65,6 +65,10 @@ const SMART_SCRAPER_TOOL = {
 - 正方形: square_1080(1080x1080), square_512(512x512)
 - 社交媒体: instagram(1080x1080), twitter(1200x675), facebook(1200x630)
 
+【⚠️ 重要限制】
+- 同一会话中连续调用此工具不要超过5次！超过后可能无响应
+- 当用户需要多种类型图片时，必须使用批量查询（逗号分隔），而不是多次调用
+
 【调用示例】
 1. 搜索5张猫的图片: {"query":"可爱的猫","mode":"link","count":5}
 2. 下载10张高清风景图: {"query":"风景","mode":"download","count":10,"size":"large"}

package/src/providers/bingScraper.js

@@ -49,11 +49,10 @@ export class BingScraper extends BaseScraper {
     try {
       const response = await withRetry(
         () => httpClient.get(searchUrl, { 
-          timeout: 15000,  // 增加超时
-          // 每个请求使用独立的 AbortController
-          signal: AbortSignal.timeout(15000),
+          timeout: 8000,  // 8秒超时，快速失败
+          signal: AbortSignal.timeout(8000),
         }),
-        { maxRetries: 2, retryCondition: isRetryableError }
+        { maxRetries: 1, retryCondition: isRetryableError } // 只重试1次
       );
       
       if (response.status !== 200) {

package/src/providers/googleScraper.js

@@ -48,8 +48,8 @@ export class GoogleScraper extends BaseScraper {
     try {
       const response = await withRetry(
         () => httpClient.get(searchUrl, {
-          timeout: 15000,
-          signal: AbortSignal.timeout(15000),
+          timeout: 8000,  // 8秒超时，快速失败
+          signal: AbortSignal.timeout(8000),
           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',
@@ -57,7 +57,7 @@ export class GoogleScraper extends BaseScraper {
             'Referer': 'https://www.google.com/',
           },
         }),
-        { maxRetries: 2, retryCondition: isRetryableError }
+        { maxRetries: 1, retryCondition: isRetryableError } // 只重试1次
       );
       
       if (response.status !== 200) {

package/src/services/orchestrator.js

@@ -310,10 +310,19 @@ export class Orchestrator {
   async execute(params) {
     metrics.recordRequest();
     const requestId = `req_${Date.now()}_${Math.random().toString(36).substr(2, 6)}`;
+    const GLOBAL_TIMEOUT = 30000; // 30秒全局超时
     
     try {
       logger.info(`[Orchestrator] Starting request: ${requestId}`);
-      const result = await this._executeInternal(params);
+      
+      // 添加全局超时熔断机制
+      const result = await Promise.race([
+        this._executeInternal(params),
+        new Promise((_, reject) => 
+          setTimeout(() => reject(new Error('REQUEST_TIMEOUT: 请求超时(30秒)，请稍后重试')), GLOBAL_TIMEOUT)
+        )
+      ]);
+      
       result.requestId = requestId;
       logger.info(`[Orchestrator] Completed request: ${requestId}`);
       return result;