Implement maxAge fast scraping parameter (#73)

* Implement maxAge fast scraping parameter

- Add maxAge parameter to SCRAPE_TOOL inputSchema with proper description
- Update tool description to highlight 500% performance improvement
- Add test coverage for maxAge parameter functionality
- Parameter enables cached scraping for faster response times

Fixes #69

Co-Authored-By: Nick <nicolascamara29@gmail.com>

* Update package-lock.json after npm install

Co-Authored-By: Nick <nicolascamara29@gmail.com>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Nick <nicolascamara29@gmail.com>

Author: devin-ai-integration[bot]

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

@@ -36,10 +36,12 @@ Scrape content from a single URL with advanced options.
   "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: {
@@ -188,6 +190,10 @@ Scrape content from a single URL with advanced options.
         },
         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'],
   },