Browser Toolkit

import asyncio
from camel.agents import ChatAgent
from camel.models import ModelFactory
from camel.toolkits import HybridBrowserToolkit
from camel.types import ModelPlatformType, ModelType

async def main():
    # Initialize the toolkit
    toolkit = HybridBrowserToolkit(
        headless=False,  # Set True for headless mode
    )

    # Create a model and agent with browser tools
    model = ModelFactory.create(
        model_platform=ModelPlatformType.OPENAI,
        model_type=ModelType.GPT_4O,
    )

    agent = ChatAgent(
        model=model,
        tools=toolkit.get_tools(),
    )

    # Run a browser task
    response = await agent.astep(
        "Go to google.com and search for 'CAMEL AI framework'"
    )
    print(response.msgs[0].content)

    # Clean up
    await toolkit.browser_close()

asyncio.run(main())

result = await toolkit.browser_visit_page("https://example.com")
# Returns: {"snapshot": "...", "url": "...", "title": "..."}

await toolkit.browser_back()
await toolkit.browser_forward()

# Click by ref (from Set-of-Marks screenshot)
await toolkit.browser_click(ref="e15")

# Click by pixel coordinates (in full_visual_mode)
await toolkit.browser_click(x=350, y=200)

# Type into element by ref
await toolkit.browser_type(ref="e8", text="Hello World")

# Type by coordinates (in full_visual_mode)
await toolkit.browser_type(x=350, y=200, text="Hello World")

await toolkit.browser_scroll(direction="down", amount=500)
# direction: "up", "down", "left", "right"

result = await toolkit.browser_get_som_screenshot()
# Returns screenshot image with numbered element overlays

snapshot = await toolkit.browser_get_page_snapshot()
# Returns text representation of page elements

# Get info about all tabs
tabs = await toolkit.browser_get_tab_info()

# Switch to a specific tab
await toolkit.browser_switch_tab(tab_id="tab_123")

# Close a tab
await toolkit.browser_close_tab(tab_id="tab_123")

# View console logs
logs = await toolkit.browser_console_view()

# Execute JavaScript
result = await toolkit.browser_console_exec("document.title")

- combobox "Country" [ref=e12] [expanded]
- option "United States" [ref=e45]
- option "Canada" [ref=e46]
- option "United Kingdom" [ref=e47]
- option "Germany" [ref=e48]

import asyncio
from camel.agents import ChatAgent
from camel.models import ModelFactory
from camel.toolkits import HybridBrowserToolkit
from camel.types import ModelPlatformType, ModelType

async def search_and_extract():
    # Initialize toolkit with logging
    toolkit = HybridBrowserToolkit(
        headless=False,
        user_data_dir="./browser_data",
        stealth=True,
        viewport_limit=True,
        browser_log_to_file=True,
    )

    # Create model
    model = ModelFactory.create(
        model_platform=ModelPlatformType.OPENAI,
        model_type=ModelType.GPT_4O,
        model_config_dict={"temperature": 0.0},
    )

    # Create agent with browser tools
    agent = ChatAgent(
        model=model,
        tools=toolkit.get_tools(),
        max_iteration=15,
    )

    task = """
    1. Go to google.com
    2. Search for "CAMEL AI multi-agent framework"
    3. Click on the official GitHub repository
    4. Find and report the number of stars
    """

    try:
        response = await agent.astep(task)
        print(response.msgs[0].content)
    finally:
        await toolkit.browser_close()

asyncio.run(search_and_extract())