browser

Browser

Use the installed arks CLI or ArkSpace MCP tools. Prefer the web Skill when Search or Fetch can produce the evidence without browser state.

Readiness

1. Run arks --version. If unavailable, explain that ArkSpace CLI is required and ask before changing the user's environment.
2. Run arks doctor --json when Firecrawl readiness is unknown. If credentials are missing, direct the human to run arks setup in a trusted local terminal. Never ask for an API key in conversation or place one in a command argument.
3. Ask before changing configuration or the user's environment. Explain that an open Firecrawl browser session accrues credits until it is closed or expires.

Session lifecycle

Open only the exact initial HTTP(S) URL needed:

{
  "protocolVersion": 1,
  "capability": "browser.open",
  "input": {
    "url": "https://example.com",
    "ttlSeconds": 600,
    "activityTtlSeconds": 300,
    "timeoutMs": 30000
  }
}

Keep the returned data.sessionId. It is an opaque handle bound to the API key that created the session. Never substitute another account or Provider. ArkSpace intentionally does not return CDP or live-view authority URLs.

Use browser.snapshot before acting. Prefer interactiveOnly: true. The snapshot returns bounded @eN references for the current page state.

Actions and confirmation

browser.interact performs exactly one structured action:

• navigate with an exact HTTP(S) URL;
• click with a current @eN reference;
• fill with a current @eN reference and text;
• press with an allowed key;
• scroll with direction and bounded pixels;
• scrape to read current page content.

Before each action, state the target and intended effect. Obtain explicit user approval before setting "confirmed": true. A click or key press can submit a form, purchase an item, publish content, change account state, or trigger another irreversible effect. Do not infer approval from an earlier request when the concrete target or effect has changed.