Browser Actions

• Load dynamic content: Trigger lazy-loaded data, infinite scrolls, and pagination
• Submit forms: Enter search terms, apply filters, or configure settings
• Navigate pages: Click buttons, open dropdowns, and interact with UI elements
• Capture state: Take screenshots, collect cookies, or record network traffic

​

Two modes

1. Instructions Mode
2. LLM Mode

​

Instructions Mode

• Predictable, repeatable automation
• Cost-sensitive applications (lower pricing)
• Static pages with consistent selectors
• Fast execution without LLM overhead

1. Define actions in the browser_actions as array of actions
2. Specify selectors, delays, and sequences
3. Nimble executes steps exactly as configured

​

LLM Mode

• Zero-setup automation
• Pages that change frequently
• Complex interaction sequences
• Intelligent decision-making

1. Define actions in the browser_actions as a natural language prompt (e.g., “scroll until all items load, open filters, click ‘On Sale’”)
2. Nimble’s AI agent takes control of the browser in real-time
3. AI adapts to page variations and figures out the optimal sequence

​

Quick comparison

​

Choosing the right mode

• You need low-cost, predictable automation
• Page structure is stable and selectors don’t change often
• You want full control over every action
• Performance is critical

• You want zero-setup, hands-free automation
• Pages change frequently and maintaining selectors is challenging
• You need intelligent handling of dynamic elements
• Higher cost is acceptable for reduced maintenance

​

Usage examples

​

Instructions Mode

from nimble import Nimble

nimble = Nimble(api_key="YOUR-API-KEY")

result = nimble.extract({
    "url": "https://www.example.com",
    "render": True,
    "browser_actions": [
        {
            "wait_and_type": {
                "selector": "input[type='search']",
                "value": "laptop"
            }
        },
        {
            "wait_and_click": {
                "selector": "button[type='submit']"
            }
        }
    ]
})

print(result)

​

LLM Mode

from nimble import Nimble

nimble = Nimble(api_key="YOUR-API-KEY")

result = nimble.extract({
    "url": "https://www.example.com",
    "render": True,
    "browser_actions_prompt": "Search for 'laptop' and apply filters for 'On Sale' items"
})

print(result)

​

Next steps