Save login credentials to the system keychain (macOS/Windows/Linux).

Credentials are stored locally and NEVER sent to any server. Use site as a short identifier, e.g. "indiehackers", "twitter", "gmail".

Set up Chrome or Edge for agent use (macOS and Windows).

Run this ONCE (with your browser closed). It:

1. Creates a dedicated agent profile at ~/.webspeed/chrome-debug/ (macOS) or %LOCALAPPDATA%\WebSpeedAgent\chrome-debug\ (Windows) — a non-default user data directory, which is required by Chrome before it will open the remote debugging port.

2. Copies your existing Chrome cookies into that profile so you are already logged into all your sites when the agent opens the browser.

3. macOS: installs ~/bin/chrome-agent and adds a shell alias in ~/.zshrc. Windows: writes chrome-agent.bat to your Desktop.

After setup:

• macOS: type 'chrome-agent' in Terminal to open Chrome

• Windows: double-click chrome-agent.bat on your Desktop

• Tell the agent: open_browser(browser="chrome", cdp_url="http://localhost:9222")

• The agent opens a new tab in your real Chrome with all your logins active

Re-run setup_browser() any time you want to sync fresh cookies from your main Chrome profile into the agent profile (close Chrome first).

Args: browser: "chrome" (default) or "edge".

Open a browser for automation.

browser — which browser to use: "chrome" (default), "firefox", or "edge".

── Chrome default behaviour ────────────────────────────────────────────────── For Chrome, CDP is tried automatically first. If the user has run 'chrome-agent' (which opens Chrome with --remote-debugging-port=9222), the agent connects to that existing window and opens a new tab — the user's real Chrome with all their logins, cookies, and extensions.

If Chrome is not running with the debug port, a helpful message is returned explaining how to start it.

── Firefox ─────────────────────────────────────────────────────────────────── Imports cookies from the user's Firefox profile (read-only) into a fresh Playwright session. Pass profile_path="auto" to detect the profile.

── Manual overrides ────────────────────────────────────────────────────────── cdp_url: connect to a specific debug URL (e.g. non-default port). profile_path: use an explicit profile directory (Chrome/Firefox/Edge). session_name: persist cookies across fresh Playwright sessions.

Args: browser: "chrome" (default), "firefox", or "edge". session_name: Cookie-persist name for standard/fresh mode. headless: Hide the window in standard/profile mode (default False). cdp_url: Override the CDP URL (default for Chrome: http://localhost:9222). profile_path: Launch with an existing browser profile ("auto" or full path).

Navigate to a URL and return the page title and final URL.

Always call this before interacting with a new page.

Args: url: The URL to navigate to. expect_url_contains: Optional substring the final URL should contain. If the page redirected elsewhere (common on SPAs), a 'spa_redirect' warning is included in the result so the agent knows to adjust its approach.

Fill a login form and submit it.

Credentials: provide either site (to load from keychain) OR username + password directly.

Selectors: if omitted, common patterns are tried automatically (input[type=email], input[name=username], etc.).

Use navigate() to go to the login page first.

Extract structured data from the current page via the Web Speed API.

Returns type-aware structured JSON: article → title, author, sections, links product → name, price, availability, specs listing → items with title, url, price, snippet other → headings, navigation, forms, text_blocks

Costs 1 Web Speed credit. Requires WEBSPEED_API_KEY.

Click an element by CSS selector.

Args: selector: CSS selector for the element to click. wait_for_navigation: Wait for a page load after clicking (default True). Set to False for clicks that trigger in-page UI changes like modals, dropdowns, or expanding sections. wait_for: CSS selector to wait for AFTER clicking — use this when the click opens a modal or triggers async UI rendering. The tool waits up to 5 s for the element to appear before returning. wait_ms: Extra milliseconds to wait after the click before reading the page. Useful for SPAs where JS hydration takes a moment (e.g. 500–2000).

Type a value into a form field.

Standard mode (use_keyboard=False, default): sets the field value directly. Works for plain <input> and <textarea> elements.

Keyboard mode (use_keyboard=True): simulates real keystrokes (keydown → keypress → input → keyup per character). Use this for:

• contenteditable divs (X/Twitter post box, Notion, Slack, etc.)

• React / Vue inputs that ignore programmatic .value changes

• Sites that check for "trusted" input events to prevent botting

For X (Twitter): click the "What's happening?" box first, then call fill_field with use_keyboard=True. This fires the React-compatible events that enable the Post button.

Args: selector: CSS selector for the input or contenteditable element. value: Text to type. Never include \n — it will be stripped. A trailing \n is treated as Tab (advance to next field). press_tab: Press Tab after filling to move focus to the next field. use_keyboard: Simulate real keystrokes instead of direct fill. delay_ms: Milliseconds between keystrokes in keyboard mode. 0 = fast (default). Use 30–80 for sites that check typing cadence.

Type text into a Google Workspace editor (Docs or Slides) reliably.

Google Docs/Slides render on , so fill_field/click can't place text and execCommand is deprecated/flaky. This tool dismisses blocking side panels, focuses the editor, and types with real keystrokes (the events the canvas editor actually listens for), then verifies.

Docs: types at the current cursor (auto-removes the Gemini overlay and focuses the hidden input iframe). Slides: pass placeholder=N to pick the text box (0 = first, usually the title). Removes the onboarding modal, double-clicks the placeholder to enter edit mode, then types. Use workspace_new_slide() to add slides.

Newlines in text are sent as real Enter presses.

Args: text: Text to type. target: 'auto' (detect from URL), or force 'docs' / 'slides'. verify: Read the text back to confirm it landed (Docs only, best-effort). placeholder: Slides only — which text placeholder to edit (0-based, in document order; 0 is typically the title).

Add a new slide in Google Slides (equivalent to Ctrl+M).

Drops the pointer-events lock first so the toolbar is clickable, clicks the 'New slide' button, and settles. Then call workspace_write(target='slides', placeholder=N) to fill the new slide.

Submit a form by clicking a submit button or pressing Enter.

Args: selector: CSS selector of the submit button or form. If omitted, presses Enter on the focused element.

Return the current page URL, title, and visible text snippet.

Useful for orientation — call this to confirm where the browser is.

Wait for an element to reach a given state on the page.

Useful after an action that triggers async loading, modal opening, or element removal. Returns ok once the condition is met.

Args: selector: CSS selector for the element to watch. timeout_ms: Maximum time to wait in milliseconds (default 10 000). state: One of: 'visible' — element exists and is visible (default) 'hidden' — element exists but is hidden, or does not exist 'attached' — element is in the DOM (may be hidden) 'detached' — element has been removed from the DOM

Wait for the page URL to contain a given substring.

Use this after clicking a SPA navigation link where the URL changes client-side without a full page reload. Returns once the URL matches or the timeout expires.

Args: url_contains: Substring the URL must contain (e.g. '/dashboard', '?tab=posts'). timeout_ms: Maximum time to wait in milliseconds (default 10 000).

Run JavaScript in the page context and return the result.

Use this to handle situations standard selectors can't reach:

• Shadow DOM: document.querySelector('my-el').shadowRoot.querySelector('input')

• Iframes: document.querySelector('iframe').contentDocument.querySelector('p')

• Hidden data: window.INITIAL_DATA or JSON.parse(document.getElementById('NEXT_DATA').textContent)

• Visibility checks: document.querySelector('.modal')?.getBoundingClientRect()

• Triggering events: document.querySelector('input').dispatchEvent(new Event('focus'))

Args: js: JavaScript expression to evaluate. The return value is JSON-serialised and included in the response. Keep expressions simple — complex logic is better split across multiple calls.

Close the tab and disconnect from the browser.

In CDP mode (connected to your existing Chrome): closes the tab the agent opened and disconnects. Chrome itself stays running with all your other tabs.

In standard mode: saves the session (if named) and closes the browser.

Check your Web Speed API credit balance and account status.