Firecrawl icon

Firecrawl

Scrape, crawl, map, search, and extract structured data from websites using Firecrawl API

Actions31

Browser → Create browser session

AI-generated

Overview

This node operation creates a browser session using the Firecrawl API. It allows users to configure session lifetime, inactivity timeout, and persistent storage profiles to maintain browser state across sessions. This is useful for automating web interactions that require session management, such as logging into websites, scraping data over multiple steps, or maintaining user state across multiple runs.

Use Case Examples

  1. Automate login and data extraction from a website by creating a browser session with a persistent profile to maintain cookies and local storage.
  2. Set a short TTL for quick tasks like single-page data scraping, or a longer TTL for complex workflows involving multiple steps and interactions.
  3. Use activity TTL to automatically close sessions after periods of inactivity, optimizing resource usage.

Properties

Name Meaning
TTL (Seconds) Total session lifetime in seconds (30-3600). The browser session will be automatically destroyed after this duration, regardless of activity. Use shorter values for quick tasks and longer values for complex multi-step automations.
Activity TTL (Seconds) Seconds of inactivity before the session is automatically destroyed (10-3600). If no code is executed or no interaction occurs within this window, the session ends early. Set higher for sessions where you may have long pauses between actions.
Profile Enable persistent storage across browser sessions. Use profiles to maintain cookies, localStorage, and other browser state between sessions. Sessions with the same profile name share storage, allowing you to stay logged in or preserve settings across multiple runs.
Use Custom Body Whether to use a custom body for the request.
Request Options Additional request options such as batching, SSL certificate validation, proxy settings, and timeout configuration.

Output

JSON

  • sessionId - Unique identifier for the created browser session.
  • status - Status of the session creation request.
  • profile
    • name - Name of the profile used for the session, if any.
    • saveChanges - Indicates whether changes to the browser state will be saved back to the profile.

Dependencies

  • Firecrawl API
  • An API key credential for Firecrawl API authentication

Troubleshooting

  • Ensure the Firecrawl API credentials are correctly configured and valid to avoid authentication errors.
  • Verify that TTL and activity TTL values are within the allowed range (TTL: 30-3600 seconds, Activity TTL: 10-3600 seconds) to prevent validation errors.
  • If using profiles, ensure the profile name is unique and properly formatted (1-128 characters).
  • Check network settings such as proxy configuration and SSL certificate validation if requests fail or time out.
  • If the session does not persist as expected, verify the 'Save Changes' setting in the profile configuration.

Links

Discussion