firecrawl-mcp 3.10.3 → 3.14.0

package/README.md

@@ -8,15 +8,16 @@
 
 # Firecrawl MCP Server
 
-A Model Context Protocol (MCP) server implementation that integrates with [Firecrawl](https://github.com/firecrawl/firecrawl) for web scraping capabilities.
+A Model Context Protocol (MCP) server implementation that integrates with [Firecrawl](https://github.com/firecrawl/firecrawl) for searching, scraping, and interacting with the web.
 
 > Big thanks to [@vrknetha](https://github.com/vrknetha), [@knacklabs](https://www.knacklabs.ai) for the initial implementation!
 
 ## Features
 
-- Web scraping, crawling, and discovery
-- Search and content extraction
-- Deep research and batch scraping
+- Search the web and get full page content
+- 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
@@ -317,19 +318,21 @@ Use this guide to select the right tool for your task:
 - **If you want to search the web for info:** use **search**
 - **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 **browser**
+- **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
 
 | Tool         | Best for                            | Returns                    |
 | ------------ | ----------------------------------- | -------------------------- |
 | scrape       | Single page content                 | JSON (preferred) or markdown |
+| interact     | Interact with a scraped page        | Execution result           |
 | batch_scrape | Multiple known URLs                 | JSON (preferred) or markdown[] |
 | map          | Discovering URLs on a site          | URL[]                      |
 | 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    | Session with live browser  |
+| browser      | Interactive multi-step automation (deprecated) | Session with live browser  |
 
 ### Format Selection Guide
 
@@ -816,16 +819,11 @@ Check the status of an agent job and retrieve results when complete. Use this to
 - `completed`: Research finished - response includes the extracted data
 - `failed`: An error occurred
 
-### 11. Browser Create (`firecrawl_browser_create`)
+### 11. Browser Create (`firecrawl_browser_create`) — Deprecated
 
-Create a cloud browser session for interactive automation.
-
-**Best for:**
+> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead. Interact lets you scrape a page and then click, fill forms, and navigate without managing sessions manually.
 
-- Multi-step browser automation (navigate, click, fill forms, extract data)
-- Interactive workflows that require maintaining state across actions
-- Testing and debugging web pages in a live browser
-- Saving and reusing browser state with profiles
+Create a cloud browser session for interactive automation.
 
 **Arguments:**
 
@@ -852,7 +850,9 @@ Create a cloud browser session for interactive automation.
 
 - Session ID, CDP URL, and live view URL
 
-### 12. Browser Execute (`firecrawl_browser_execute`)
+### 12. 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.
 
@@ -894,7 +894,9 @@ Execute code in a browser session. Supports agent-browser commands (bash), Pytho
 }
 ```
 
-### 13. Browser List (`firecrawl_browser_list`)
+### 13. Browser List (`firecrawl_browser_list`) — Deprecated
+
+> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
 
 List browser sessions, optionally filtered by status.
 
@@ -907,7 +909,9 @@ List browser sessions, optionally filtered by status.
 }
 ```
 
-### 14. Browser Delete (`firecrawl_browser_delete`)
+### 14. Browser Delete (`firecrawl_browser_delete`) — Deprecated
+
+> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
 
 Destroy a browser session.