Python SDK

pip install grasp-sdk

# Create a container with a 30-second idle timeout
container = grasp.create(idle_timeout=30000)

# Create a container with a proxy
container = grasp.create(
    proxy={
        "enabled": True,
        "type": "residential",
        "country": "US"
    }
)

# Connect to an existing container
container = grasp.connect("container-123")

container.shutdown()

cdp_url = container.browser.ws_endpoint
print(f"Connect to: {cdp_url}")

from grasp import Grasp, GraspError

try:
    grasp = Grasp()
    container = grasp.create()
    # Use container
    container.shutdown()
except GraspError as error:
    print(f"An API error occurred: {error}")

from grasp import Grasp, GraspContainer
from typing import Optional

def create_browser_session(api_key: Optional[str] = None) -> GraspContainer:
    grasp = Grasp(api_key=api_key)
    container = grasp.create()
    return container

from grasp import Grasp
from playwright.sync_api import sync_playwright

# Initialize the Grasp client
grasp = Grasp()

# Create a new container
container = grasp.create()

# Connect Playwright to the cloud browser
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(container.browser.ws_endpoint)
    page = browser.new_page()
    page.goto("https://example.com")

    # Perform automation
    print(page.title())

    browser.close()

# Clean up
container.shutdown()

import asyncio
from grasp import AsyncGrasp
from playwright.async_api import async_playwright

async def main():
    # Initialize the async client
    async with AsyncGrasp() as grasp:
        # Create a new container
        container = await grasp.create()

        # Connect Playwright
        async with async_playwright() as p:
            browser = await p.chromium.connect_over_cdp(container.browser.ws_endpoint)
            page = await browser.new_page()
            await page.goto("https://example.com")

            print(await page.title())

            await browser.close()

        # Clean up
        await container.shutdown()

asyncio.run(main())