agentcore-browser

AgentCore Browser

Headless Chromium browser running inside the AgentCore container. Navigate to URLs, take screenshots, and interact with page elements.

Important

This skill requires enable_browser=true in CDK configuration. If the browser is not available, the tools will return a clear error message.

Usage

browser_navigate

Navigate to a URL and return the page title and text content.

node {baseDir}/navigate.js '{"url": "https://example.com"}'

• url (required): The URL to navigate to

Returns JSON: {"url": "...", "title": "...", "content": "..."}

Content is truncated to 8000 characters to keep responses manageable.

browser_screenshot

Take a screenshot of the current browser page and send it to the user.

node {baseDir}/screenshot.js '{"description": "Homepage after login"}'

• description (optional): Caption for the screenshot

Returns text with [SCREENSHOT:{s3key}] marker that the proxy converts to an image.

browser_interact

Interact with the current page — click elements, type text, wait for elements, or scroll.

node {baseDir}/interact.js '{"action": "click", "selector": "#submit-btn"}'
node {baseDir}/interact.js '{"action": "type", "selector": "#search", "text": "hello"}'
node {baseDir}/interact.js '{"action": "wait", "selector": ".results"}'
node {baseDir}/interact.js '{"action": "scroll"}'

• action (required): One of click, type, wait, scroll
• selector (optional): CSS selector for the target element (required for click, type, wait)
• text (optional): Text to type (required for type action)

Returns JSON: {"success": true, "message": "..."}

From Agent Chat

• "Go to example.com" -> browser_navigate with url
• "Take a screenshot" -> browser_screenshot
• "Click the login button" -> browser_interact with action=click
• "Type my email in the form" -> browser_interact with action=type
• "Scroll down" -> browser_interact with action=scroll
• "Wait for the results to load" -> browser_interact with action=wait

Security Notes

• Browser runs inside an isolated per-user microVM
• Screenshots are uploaded to the user's S3 namespace (no cross-user access)
• The browser session file is stored at /tmp/agentcore-browser-session.json
• Navigation timeout: 30s, interaction timeout: 10s, wait timeout: 15s