diff --git a/mcp-server.mdx b/mcp-server.mdx index 60bf0a91..6d50caf5 100644 --- a/mcp-server.mdx +++ b/mcp-server.mdx @@ -778,6 +778,51 @@ List browser sessions, optionally filtered by status. **Returns:** Array of browser sessions. +### 13. Interact with Scraped Page (`firecrawl_interact`) + +Interact with a previously scraped page in a live browser session. Scrape a page first with `firecrawl_scrape`, then use the returned `scrapeId` (from the scrape response metadata) to click buttons, fill forms, extract dynamic content, or navigate deeper. The response includes a `liveViewUrl` and `interactiveLiveViewUrl` you can open in your browser to watch or control the session in real time. + +```json +{ + "name": "firecrawl_interact", + "arguments": { + "scrapeId": "scrape-id-from-previous-scrape", + "prompt": "Click the Sign In button" + } +} +``` + +#### Interact Tool Options: + +- `scrapeId`: The scrape job ID from a previous `firecrawl_scrape` call (required) +- `prompt`: Natural language instruction describing the action to take (provide `prompt` or `code`) +- `code`: Code to execute in the browser session (provide `code` or `prompt`) +- `language`: `bash`, `python`, or `node` (optional, defaults to `node`, only used with `code`) +- `timeout`: Execution timeout in seconds, 1–300 (optional, defaults to 30) + +**Best for:** Multi-step workflows on a single page — searching a site, clicking through results, filling forms, extracting data that requires interaction. + +**Returns:** Interaction result including `liveViewUrl` and `interactiveLiveViewUrl`. + +### 14. Stop Interact Session (`firecrawl_interact_stop`) + +Stop an interact session for a scraped page. Call this when you are done interacting to free resources. + +```json +{ + "name": "firecrawl_interact_stop", + "arguments": { + "scrapeId": "scrape-id-from-previous-scrape" + } +} +``` + +#### Interact Stop Options: + +- `scrapeId`: The scrape ID for the session to stop (required) + +**Returns:** Confirmation that the session has been stopped. + ## Logging System The server includes comprehensive logging: