astrobrowse-authenticated-agentic-browser

AstroBrowse - Authenticated Agentic Browser

Freshness

Last updated: 2026-08-11.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

Give your AI agent access to the websites and accounts you choose, without ever handing over your passwords. AstroBrowse runs a real, logged-in web browser on your behalf so your agent can work inside the tools you already use: social media, CRMs, ERPs, dashboards, and any SaaS platform or website, including the many that have no API. Save a login once and your agent can resume that session to post content, pull reports, update records, fill forms, download files, and complete multi-step tasks, all in a fresh, single-use browser that is wiped clean when the job is done. If a site ever needs a human touch, like a sign-in confirmation or a quick verification step, AstroBrowse hands you a link to step in for a moment and then lets your agent carry on. You stay in control of which accounts are connected and what the agent is allowed to visit.

Product Instructions

AstroBrowse - Authenticated Agentic Browser

Operate a real, logged-in web browser on the user's behalf. The user saves their logins once; you resume those sessions to work inside their accounts without ever seeing a password. Every session is single-use and isolated, and is wiped when you close it.

Full setup guide (Tailscale network egress, enabling the tool, saving a login): https://www.agentpmt.com/docs/tool-specific/astrobrowse

Workflow

1. list_accounts to see the user's saved logins.
2. initialize_browser with a stable idempotency_key (required, so a retry never starts a second session) plus account_id to resume a saved login, or omit account_id for a general-browsing session when the user's policy allows it. Returns a browser_session_id.
3. Operate the page with run_steps, extract_page, screenshot, start_recording / stop_recording, upload_file, and list_downloads / download_file.
4. If a site needs a human (CAPTCHA, MFA, or an unusual login), call request_user_takeover then poll wait_for_takeover. The user steps in on the live session.
5. Always close_browser when finished.

get_policy tells you whether general browsing is allowed (saved_only | open | open_with_allowlist). Only the user can change the policy, from their dashboard; there is no agent action to change it.

Actions

• list_accounts — list saved logins. Call this first.
• get_policy — read the browsing policy. It is set only by the user from their dashboard.
• initialize_browser — required idempotency_key; optional account_id, initial_url, region. Omit account_id for a general-browsing session only when the user has enabled it.
• run_steps (browser_session_id, steps[]) — execute 1 to 20 browser steps in one request; an empty steps list is invalid. Supported step actions are goto, click, fill, press, select, wait_for_load_state, wait_for_selector, extract_text, extract_html, and screenshot. Each step accepts only the fields defined by the tool schema, such as selector, text, url, key, value, and timeout_ms (500 to 60000). Caller-supplied JavaScript and script fields are not supported. The 20-step allowance resets for each run_steps request; it is not a per-session quota. Screenshot steps save PNGs to File Manager and return artifact.file_id plus a fresh artifact.signed_url, never inline image base64.
• extract_page (browser_session_id, selector?, include_html?) — return visible text or capped HTML.
• screenshot (browser_session_id) — save a PNG to File Manager and return artifact.file_id plus a fresh seven-day artifact.signed_url. Raw image base64 is not returned inline.
• upload_file (browser_session_id, selector, file_ids[]) — attach File Manager files to a visible ``. Reveal the input with supported run_steps actions first.
• list_downloads / download_file (browser_session_id, download_name?) — list files the page downloaded and persist one to File Manager.
• start_recording (show_cursor?) / stop_recording — save an MP4 of the session to File Manager. Stop recording before closing.
• request_user_takeover (reason) / wait_for_takeover — hand the live session to the human, then poll for status.
• status — return sanitized live status without cookies or credentials.
• close_browser — release and wipe the session. Always call when done. Anonymous sessions are discarded because they have no saved login to persist.

Safety and execution rules

• Do not attempt to execute JavaScript, inject scripts, access browser internals, or bypass the supported action grammar.
• Each run_steps request must contain 1 to 20 steps. Split longer workflows across requests and re-check page state between requests.
• Prefer selectors tied to stable labels, roles, names, or IDs. Use extraction and screenshots to confirm state before consequential actions.
• Use human takeover for CAPTCHA, MFA, login confirmation, or any action that requires the user's judgment.
• Artifact actions (screenshot, download_file, stop_recording, upload_file) run inside a workflow with budget context.
• Credentials are never exposed to the agent.
• Sessions are single-use and isolated; closing wipes them.

Full setup and configuration guide: https://www.agentpmt.com/docs/tool-specific/astrobrowse

When To Use

• Use this skill for AstroBrowse - Authenticated Agentic Browser on AgentPMT.
• Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
• Search and activation keywords: astrobrowse authenticated agentic browser, astrobrowse authenticated agentic browser, post and schedule content across social media accounts, pull reports and update records in crms and erps, operate saas platforms and portals that have no api, fill and submit web forms on the user's behalf, close browser, browser session id.
• Supported action names: close_browser, download_file, extract_page, get_policy, initialize_browser, list_accounts, list_downloads, request_user_takeover, run_steps, screenshot, start_recording, status, stop_recording, upload_file, wait_for_takeover.

Use Cases

• Post and schedule content across social media accounts
• Pull reports and update records in CRMs and ERPs
• Operate SaaS platforms and portals that have no API
• Fill and submit web forms on the user's behalf
• Download invoices statements and files from web apps
• Log in to accounts without sharing passwords with the agent
• Automate multi-step workflows on logged-in websites
• Capture screenshots and screen recordings of web sessions
• Hand off to a human for sign-in or verification steps
• Extract data from pages behind a login

Related Product Skills

• File Management: ../file-management (ClawHub: file-management, page: https://clawhub.ai/agentpmt/file-management; skills.sh: npx skills add AgentPMT/agent-skills --skill file-management)

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 15. x402 availability: not enabled for this product.

• close_browser (action slug: close-browser): Release the session: it is wiped and destroyed. Always call this when finished. Price: 5 credits. Parameters: browser_session_id.
• download_file (action slug: download-file): Persist a file the browser downloaded into the File Manager (size-capped, requires workflow budget context). Pass download_name from list_downloads, or omit it to save the most recent download. Price: 5 credits. Parameters: browser_session_id, download_name.
• extract_page (action slug: extract-page): Extract visible text (or HTML) from the active page or a selector. Price: 5 credits. Parameters: browser_session_id, include_html, selector.
• get_policy (action slug: get-policy): Read the user's browsing policy (saved-only vs general browsing). The policy is set only by the human from their dashboard; there is no agent action to change it. Price: 5 credits. Parameters: none.
• initialize_browser (action slug: initialize-browser): Start a fresh, single-use, isolated browser session. Pass a stable idempotency_key (required) so a retry never starts a second session. Provide account_id to resume a saved login, or omit account_id for a general-browsing session (allowed only when the user has enabled general browsing). Call list_accounts first. Price: 5 credits. Parameters: account_id, idempotency_key, initial_url, region.
• list_accounts (action slug: list-accounts): List the user's saved AstroBrowse logins (accounts). Call this first to find a saved site before initialize_browser. Price: 5 credits. Parameters: none.
• list_downloads (action slug: list-downloads): List files the browser has downloaded in this session (name, size, type) so you can pick one to save with download_file. Price: 5 credits. Parameters: browser_session_id.
• request_user_takeover (action slug: request-user-takeover): Ask the human to take over the live browser (e.g. CAPTCHA, MFA, unusual login UI). Holds the session open past the idle timeout. Use ONLY when the agent cannot proceed automatically. Price: 5 credits. Parameters: browser_session_id, reason.
• run_steps (action slug: run-steps): Run bounded browser automation steps (goto/click/fill/press/select/wait/extract/screenshot) in an initialized session. Price: 5 credits. Parameters: browser_session_id, steps.
• screenshot (action slug: screenshot): Capture a PNG screenshot and save it to your File Manager (requires workflow budget context). The image is NOT returned inline; the response has artifact.file_id and a fresh artifact.signed_url for viewing or analysis. Price: 5 credits. Parameters: browser_session_id.
• start_recording (action slug: start-recording): Start an MP4 screen recording of the session. show_cursor controls whether the cursor appears in the video. Price: 5 credits. Parameters: browser_session_id, show_cursor.
• status (action slug: status): Return the session's sanitized live status (no cookies). Price: 5 credits. Parameters: browser_session_id.
• stop_recording (action slug: stop-recording): Stop the recording and save the MP4 to your File Manager (requires workflow budget context). The video is NOT returned inline; the response has artifact.file_id — fetch it from the File Manager to view the recording. Call before close_browser. Price: 5 credits. Parameters: browser_session_id.
• upload_file (action slug: upload-file): Attach File Manager files to a visible page . Reveal the input with run_steps first, then pass its selector and file_ids. Price: 5 credits. Parameters: browser_session_id, file_ids, selector.
• wait_for_takeover (action slug: wait-for-takeover): Poll the session status after request_user_takeover. Price: 5 credits. Parameters: browser_session_id.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

• Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "astrobrowse-authenticated-agentic-browser".
• Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "astrobrowse-authenticated-agentic-browser", or call this product with action: "get_instructions" when the product tool is already selected.
• Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "astrobrowse-authenticated-agentic-browser"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

{
  "action": "get_instructions",
  "tool_id": "astrobrowse-authenticated-agentic-browser"
}

Authenticated AgentPMT REST schema lookup body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "astrobrowse-authenticated-agentic-browser"
  }
}

Authenticated AgentPMT REST live examples body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "astrobrowse-authenticated-agentic-browser"
  }
}

Call This Tool

Product slug: astrobrowse-authenticated-agentic-browser

Marketplace page: https://www.agentpmt.com/marketplace/astrobrowse-authenticated-agentic-browser

• AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
• x402 route: not enabled for this product.
• AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

• What AgentPMT is: ../what-is-agentpmt
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

{
  "method": "tools/call",
  "params": {
    "name": "AstroBrowse---Authenticated-Agentic-Browser",
    "arguments": {
      "action": "close_browser",
      "browser_session_id": "example browser session id"
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

{
  "name": "astrobrowse-authenticated-agentic-browser",
  "parameters": {
    "action": "close_browser",
    "browser_session_id": "example browser session id"
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

• Treat the returned JSON as the source of truth for this tool call.
• If the response includes warnings or correction targets, apply them before retrying.
• If the response includes a passed or success-style boolean, use it as the workflow gate.
• If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
• If close_browser fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

• Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
• Keep tool inputs scoped to the minimum content needed for the task.
• Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/astrobrowse-authenticated-agentic-browser
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase