tsaol/awesome-claude/browser-use-agentcore

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:StartBrowserSession",
        "bedrock-agentcore:StopBrowserSession",
        "bedrock-agentcore:GetBrowserSession"
      ],
      "Resource": "*"
    }
  ]
}

pip install bedrock-agentcore playwright boto3 nest-asyncio

# Test a URL
python scripts/browser_test.py https://example.com
 
# Test with screenshot
python scripts/browser_test.py https://example.com --screenshot screenshot.png
 
# Test with API health check
python scripts/browser_test.py https://example.com --check-api
 
# Full test with JSON output
python scripts/browser_test.py https://example.com -s screenshot.png -a --json

from browser_test import test_url
# test_url is a synchronous function
results = test_url(
    url="https://example.com",
    screenshot_path="screenshot.png",
    check_api=True
)
print(f"Status: {results['status']}")
print(f"Title: {results['title']}")
print(f"Errors: {results['errors']}")

from bedrock_agentcore.tools.browser_client import BrowserClient
from playwright.async_api import async_playwright
async def custom_test():
    client = BrowserClient(region="us-west-2")
    session = await client.start_browser_session(
        session_name="my-test",
        timeout=300,
        viewport={"width": 1920, "height": 1080}
    )
    ws_url, headers = await client.generate_ws_headers()
    async with async_playwright() as p:
        browser = await p.chromium.connect_over_cdp(ws_url, headers=headers)
        page = browser.contexts[0].pages[0]
        # Your custom test logic
        await page.goto("https://example.com")
        await page.click("button#submit")
        await page.wait_for_selector(".result")
        content = await page.content()
        await browser.close()
    await client.stop_browser_session()
    return content

🚀 Starting browser session in us-west-2...
✅ Browser session started: sess-abc123
🔗 Connecting to remote browser...
🌐 Navigating to https://example.com...
📄 Page title: Example Domain
📊 HTTP status: 200
📸 Screenshot saved: screenshot.png
 
==================================================
📋 Test Results
==================================================
URL: https://example.com
Status: 200
Title: Example Domain
Errors: 0
 
✅ All checks passed!

{
  "url": "https://example.com",
  "status": 200,
  "title": "Example Domain",
  "errors": [],
  "api_check": {
    "url": "https://example.com/api/health",
    "status": 200,
    "body": "{\"status\":\"healthy\"}"
  },
  "screenshot": "screenshot.png"
}

session = await client.start_browser_session(
    session_name="long-test",
    timeout=600  # 10 minutes
)