firecrawl-mcp 3.19.0 → 3.20.0

package/README.md

@@ -18,7 +18,6 @@ A Model Context Protocol (MCP) server that brings [Firecrawl](https://github.com
 - Scrape any URL into clean, structured data
 - Interact with pages — click, navigate, and operate
 - Deep research with autonomous agent
-- Cloud browser sessions with agent-browser automation
 - Automatic retries and rate limiting
 - Cloud and self-hosted support
 - SSE support
@@ -328,7 +327,6 @@ Use this guide to select the right tool for your task:
 - **If you need complex research across multiple unknown sources:** use **agent**
 - **If you want to analyze a whole site or section:** use **crawl** (with limits!)
 - **If you need interactive browser automation** (click, type, navigate): use **scrape** + **interact**
-- **If you need a raw CDP browser session** (advanced): use **browser** (deprecated)
 
 ### Quick Reference Table
 
@@ -341,7 +339,6 @@ Use this guide to select the right tool for your task:
 | crawl        | Multi-page extraction (with limits)            | markdown/html[]                |
 | search       | Web search for info                            | results[]                      |
 | agent        | Complex multi-source research                  | JSON (structured data)         |
-| browser      | Interactive multi-step automation (deprecated) | Session with live browser      |
 
 ### Format Selection Guide
 
@@ -886,6 +883,8 @@ Create and manage recurring page monitors. Monitors run scheduled scrapes or cra
 
 Use `page` or `pages` plus `goal`. The MCP server builds the monitor request with a 30-minute schedule and the API enables meaningful-change judging automatically.
 
+Meaningful-change judging runs automatically when `goal` is set. Page webhooks expose `isMeaningful` and `judgment` on `monitor.page` events.
+
 Write goals as concise 2-3 sentence monitor instructions. Say what should trigger an alert, preserve any scope the user gave, and include intent-specific exclusions only when obvious from the request. Generic noise such as whitespace, formatting-only changes, request IDs, tracking params, generic metadata, and unrelated page chrome is already handled by the judge, so do not repeat it in every goal. If the user is vague, keep the goal broad; if they ask for broad monitoring or "any change", preserve that. If the user says they do not care about something, include that explicitly.
 
 ```json
@@ -938,111 +937,6 @@ Pass `body` when you need crawl targets, JSON change tracking, custom retention,
 - `firecrawl_monitor_checks`: list checks, optionally filtered by status.
 - `firecrawl_monitor_check`: get page-level results, including `diff`, `snapshot`, `judgment.meaningful`, and `judgment.meaningfulChanges`.
 
-### 12. Browser Create (`firecrawl_browser_create`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead. Interact lets you scrape a page and then click, fill forms, and navigate without managing sessions manually.
-
-Create a cloud browser session for interactive automation.
-
-**Arguments:**
-
-- `ttl`: Total session lifetime in seconds (30-3600, optional)
-- `activityTtl`: Idle timeout in seconds (10-3600, optional)
-- `streamWebView`: Whether to enable live view streaming (optional)
-- `profile`: Save and reuse browser state across sessions (optional)
-  - `name`: Profile name (sessions with the same name share state)
-  - `saveChanges`: Whether to save changes back to the profile (default: true)
-
-**Usage Example:**
-
-```json
-{
-  "name": "firecrawl_browser_create",
-  "arguments": {
-    "ttl": 600,
-    "profile": { "name": "my-profile", "saveChanges": true }
-  }
-}
-```
-
-**Returns:**
-
-- Session ID, CDP URL, and live view URL
-
-### 13. Browser Execute (`firecrawl_browser_execute`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
-
-Execute code in a browser session. Supports agent-browser commands (bash), Python, or JavaScript.
-
-**Recommended: Use bash with agent-browser commands** (pre-installed in every sandbox):
-
-```json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "agent-browser open https://example.com",
-    "language": "bash"
-  }
-}
-```
-
-**Common agent-browser commands:**
-
-| Command                         | Description                            |
-| ------------------------------- | -------------------------------------- |
-| `agent-browser open <url>`      | Navigate to URL                        |
-| `agent-browser snapshot`        | Accessibility tree with clickable refs |
-| `agent-browser click @e5`       | Click element by ref from snapshot     |
-| `agent-browser type @e3 "text"` | Type into element                      |
-| `agent-browser get title`       | Get page title                         |
-| `agent-browser screenshot`      | Take screenshot                        |
-| `agent-browser --help`          | Full command reference                 |
-
-**For Playwright scripting, use Python:**
-
-```json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "await page.goto('https://example.com')\ntitle = await page.title()\nprint(title)",
-    "language": "python"
-  }
-}
-```
-
-### 14. Browser List (`firecrawl_browser_list`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
-
-List browser sessions, optionally filtered by status.
-
-```json
-{
-  "name": "firecrawl_browser_list",
-  "arguments": {
-    "status": "active"
-  }
-}
-```
-
-### 15. Browser Delete (`firecrawl_browser_delete`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
-
-Destroy a browser session.
-
-```json
-{
-  "name": "firecrawl_browser_delete",
-  "arguments": {
-    "sessionId": "session-id-here"
-  }
-}
-```
-
 ## Logging System
 
 The server includes comprehensive logging:

package/dist/index.js

@@ -1203,204 +1203,6 @@ Check the status of an agent job and retrieve results when complete. Use this to
         return asText(res);
     },
 });
-// Browser session tools (deprecated — prefer firecrawl_scrape + firecrawl_interact)
-server.addTool({
-    name: 'firecrawl_browser_create',
-    annotations: {
-        title: 'Create browser session',
-        readOnlyHint: false,
-        openWorldHint: false,
-        destructiveHint: false,
-    },
-    description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.** Interact lets you scrape a page and then click, fill forms, and navigate without managing sessions manually.
-
-Create a browser session for code execution via CDP (Chrome DevTools Protocol).
-
-**Arguments:**
-- ttl: Total session lifetime in seconds (30-3600, optional)
-- activityTtl: Idle timeout in seconds (10-3600, optional)
-- streamWebView: Whether to enable live view streaming (optional)
-- profile: Save and reuse browser state (cookies, localStorage) across sessions (optional)
-  - name: Profile name (sessions with the same name share state)
-  - saveChanges: Whether to save changes back to the profile (default: true)
-
-**Usage Example:**
-\`\`\`json
-{
-  "name": "firecrawl_browser_create",
-  "arguments": {
-    "profile": { "name": "my-profile", "saveChanges": true }
-  }
-}
-\`\`\`
-**Returns:** Session ID, CDP URL, and live view URL.
-`,
-    parameters: z.object({
-        ttl: z.number().min(30).max(3600).optional(),
-        activityTtl: z.number().min(10).max(3600).optional(),
-        streamWebView: z.boolean().optional(),
-        profile: z
-            .object({
-            name: z.string().min(1).max(128),
-            saveChanges: z.boolean().default(true),
-        })
-            .optional(),
-    }),
-    execute: async (args, { session, log }) => {
-        const client = getClient(session);
-        const a = args;
-        const cleaned = removeEmptyTopLevel(a);
-        log.info('Creating browser session');
-        const res = await client.browser(cleaned);
-        return asText(res);
-    },
-});
-if (!SAFE_MODE) {
-    server.addTool({
-        name: 'firecrawl_browser_execute',
-        annotations: {
-            title: 'Run code in browser session',
-            readOnlyHint: false,
-            openWorldHint: false,
-            destructiveHint: true,
-        },
-        description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.** Interact lets you scrape a page and then click, fill forms, and navigate without managing sessions manually.
-
-Execute code in a browser session. Supports agent-browser commands (bash), Python, or JavaScript.
-**Requires:** An active browser session (create one with firecrawl_browser_create first).
-
-**Arguments:**
-- sessionId: The browser session ID (required)
-- code: The code to execute (required)
-- language: "bash", "python", or "node" (optional, defaults to "bash")
-
-**Recommended: Use bash with agent-browser commands** (pre-installed in every sandbox):
-\`\`\`json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "agent-browser open https://example.com",
-    "language": "bash"
-  }
-}
-\`\`\`
-
-**Common agent-browser commands:**
-- \`agent-browser open <url>\` — Navigate to URL
-- \`agent-browser snapshot\` — Get accessibility tree with clickable refs (for AI)
-- \`agent-browser snapshot -i -c\` — Interactive elements only, compact
-- \`agent-browser click @e5\` — Click element by ref from snapshot
-- \`agent-browser type @e3 "text"\` — Type into element
-- \`agent-browser fill @e3 "text"\` — Clear and fill element
-- \`agent-browser get text @e1\` — Get text content
-- \`agent-browser get title\` — Get page title
-- \`agent-browser get url\` — Get current URL
-- \`agent-browser screenshot [path]\` — Take screenshot
-- \`agent-browser scroll down\` — Scroll page
-- \`agent-browser wait 2000\` — Wait 2 seconds
-- \`agent-browser --help\` — Full command reference
-
-**For Playwright scripting, use Python** (has proper async/await support):
-\`\`\`json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "await page.goto('https://example.com')\\ntitle = await page.title()\\nprint(title)",
-    "language": "python"
-  }
-}
-\`\`\`
-
-**Note:** Prefer bash (agent-browser) or Python.
-**Returns:** Execution result including stdout, stderr, and exit code.
-`,
-        parameters: z.object({
-            sessionId: z.string(),
-            code: z.string(),
-            language: z.enum(['bash', 'python', 'node']).optional(),
-        }),
-        execute: async (args, { session, log }) => {
-            const client = getClient(session);
-            const { sessionId, code, language } = args;
-            log.info('Executing code in browser session', { sessionId });
-            const res = await client.browserExecute(sessionId, { code, language });
-            return asText(res);
-        },
-    });
-}
-server.addTool({
-    name: 'firecrawl_browser_delete',
-    annotations: {
-        title: 'Delete browser session',
-        readOnlyHint: false,
-        openWorldHint: false,
-        destructiveHint: true,
-    },
-    description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.**
-
-Destroy a browser session.
-
-**Usage Example:**
-\`\`\`json
-{
-  "name": "firecrawl_browser_delete",
-  "arguments": {
-    "sessionId": "session-id-here"
-  }
-}
-\`\`\`
-**Returns:** Success confirmation.
-`,
-    parameters: z.object({
-        sessionId: z.string(),
-    }),
-    execute: async (args, { session, log }) => {
-        const client = getClient(session);
-        const { sessionId } = args;
-        log.info('Deleting browser session', { sessionId });
-        const res = await client.deleteBrowser(sessionId);
-        return asText(res);
-    },
-});
-server.addTool({
-    name: 'firecrawl_browser_list',
-    annotations: {
-        title: 'List browser sessions',
-        readOnlyHint: true,
-        openWorldHint: false,
-    },
-    description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.**
-
-List browser sessions, optionally filtered by status.
-
-**Usage Example:**
-\`\`\`json
-{
-  "name": "firecrawl_browser_list",
-  "arguments": {
-    "status": "active"
-  }
-}
-\`\`\`
-**Returns:** Array of browser sessions.
-`,
-    parameters: z.object({
-        status: z.enum(['active', 'destroyed']).optional(),
-    }),
-    execute: async (args, { session, log }) => {
-        const client = getClient(session);
-        const { status } = args;
-        log.info('Listing browser sessions', { status });
-        const res = await client.listBrowsers({ status });
-        return asText(res);
-    },
-});
 // Interact tools (scrape-bound browser sessions)
 server.addTool({
     name: 'firecrawl_interact',

package/dist/monitor.js

@@ -127,6 +127,8 @@ Create a Firecrawl monitor — a recurring scrape or crawl that diffs each resul
 
 Prefer the simple path: pass \`page\` or \`pages\` plus \`goal\`. The tool will create a scrape monitor with a 30-minute schedule and meaningful-change judging enabled by the API. Use \`body\` only for advanced requests such as crawl targets, JSON change tracking, custom retention, or manual \`judgeEnabled\` control.
 
+Meaningful-change judge: set \`goal\` to a plain-language description of what the user actually cares about. \`judgeEnabled\` defaults to true when \`goal\` is set, so providing \`goal\` is enough. Page webhooks expose \`isMeaningful\` and \`judgment\` on \`monitor.page\` events.
+
 Simple fields:
 - \`page\`: one page URL to monitor.
 - \`pages\`: multiple page URLs to monitor.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-mcp",
-  "version": "3.19.0",
+  "version": "3.20.0",
   "description": "MCP server for Firecrawl — search, scrape, and interact with the web. Supports both cloud and self-hosted instances. Features include web search, scraping, page interaction, batch processing, and LLM-powered content analysis.",
   "type": "module",
   "mcpName": "io.github.firecrawl/firecrawl-mcp-server",