Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions mcp-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down