Merge branch 'main' of https://github.com/mendableai/firecrawl-mcp-server

Author: nickscamara

src/index.test.ts

@@ -139,6 +139,41 @@ describe('Firecrawl Tool Tests', () => {
     });
   });
 
+  // Test scrape with maxAge parameter
+  test('should handle scrape request with maxAge parameter', async () => {
+    const url = 'https://example.com';
+    const options = { formats: ['markdown'], maxAge: 3600000 };
+
+    const mockResponse: ScrapeResponse = {
+      success: true,
+      markdown: '# Test Content',
+      html: undefined,
+      rawHtml: undefined,
+      url: 'https://example.com',
+      actions: undefined as never,
+    };
+
+    mockClient.scrapeUrl.mockResolvedValueOnce(mockResponse);
+
+    const response = await requestHandler({
+      method: 'call_tool',
+      params: {
+        name: 'firecrawl_scrape',
+        arguments: { url, ...options },
+      },
+    });
+
+    expect(response).toEqual({
+      content: [{ type: 'text', text: '# Test Content' }],
+      isError: false,
+    });
+    expect(mockClient.scrapeUrl).toHaveBeenCalledWith(url, {
+      formats: ['markdown'],
+      maxAge: 3600000,
+      url,
+    });
+  });
+
   // Test batch scrape functionality
   test('should handle batch scrape request', async () => {
     const urls = ['https://example.com'];

src/index.ts

@@ -37,10 +37,12 @@ This is the most powerful, fastest and most reliable scraper tool, if available
   "name": "firecrawl_scrape",
   "arguments": {
     "url": "https://example.com",
-    "formats": ["markdown"]
+    "formats": ["markdown"],
+    "maxAge": 3600000
   }
 }
 \`\`\`
+**Performance:** Add maxAge parameter for 500% faster scrapes using cached data.
 **Returns:** Markdown, HTML, or other formats as specified.
 `,
   inputSchema: {
@@ -189,6 +191,10 @@ This is the most powerful, fastest and most reliable scraper tool, if available
         },
         description: 'Location settings for scraping',
       },
+      maxAge: {
+        type: 'number',
+        description: 'Maximum age in milliseconds for cached content. Use cached data if available and younger than maxAge, otherwise scrape fresh. Enables 500% faster scrapes for recently cached pages. Default: 0 (always scrape fresh)',
+      },
     },
     required: ['url'],
   },