Official Verified

surfagent

Control a real Chrome browser via SurfAgent — navigate, click, type, screenshot, extract data, crawl sites, and automate web workflows. Uses your persistent Chrome profile with real cookies and sessions. Works through SurfAgent's MCP server or direct HTTP API.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/agentossoftware/surfagent

Download Source Code (.zip)

SurfAgent — Real Chrome Browser Control

Give your AI agent a real, persistent Chrome browser. No headless browsers, no cloud, no bot detection issues.

When to Use

You need to browse, scrape, or interact with a website
You need to fill forms, click buttons, or navigate pages
You need to extract structured data from web pages
You need to take screenshots of websites
You need persistent login sessions (already logged into sites)
You need to bypass bot detection (Cloudflare, hCaptcha, etc.)
You need to crawl/map a website

Prerequisites

SurfAgent installed and running — download from surfagent.app
MCP server connected — hermes mcp add surfagent --command npx --args -y surfagent-mcp
Or use the HTTP API directly at http://localhost:7201

Quick Reference — MCP Tools (24)

Tool	What it does
`browser_navigate`	Open a URL
`browser_back`	Go back in history
`browser_forward`	Go forward in history
`browser_click`	Click an element (selector, text, or coordinates)
`browser_type`	Type text into an element
`browser_fill_form`	Fill multiple form fields at once
`browser_select`	Select dropdown option
`browser_scroll`	Scroll page or to element
`browser_screenshot`	Capture page screenshot (PNG)
`browser_get_text`	Get visible text content
`browser_get_html`	Get page HTML
`browser_get_url`	Get current URL
`browser_get_title`	Get page title
`browser_find_elements`	Find elements by CSS selector
`browser_evaluate`	Run JavaScript in page
`browser_wait`	Wait for element to appear
`browser_cookies`	Get or set cookies
`browser_list_tabs`	List open tabs
`browser_new_tab`	Open new tab
`browser_switch_tab`	Switch to tab by id/title
`browser_close_tab`	Close a tab
`browser_extract`	Extract structured data (markdown, JSON, links)
`browser_crawl`	BFS crawl a domain
`browser_map`	Discover all URLs on a site

Procedure

Basic Navigation

Use browser_navigate to open a URL
Use browser_screenshot to see the page
Use browser_click or browser_type to interact
Use browser_get_text to read content

Data Extraction

Use browser_extract with a URL to get markdown + links
Add prompt and schema fields for LLM-powered structured extraction
Use browser_crawl for multi-page extraction
Use browser_map for quick URL discovery

Form Filling

Use browser_navigate to go to the form page
Use browser_fill_form with field label/name → value mappings
Or use browser_click + browser_type for individual fields
Use browser_select for dropdowns

Tab Management

Use browser_list_tabs to see what's open
Use browser_new_tab to open a new tab
Use browser_switch_tab to change focus
Use browser_close_tab when done — always clean up tabs

Read Full Documentation on GitHub

Metadata

Author@agentossoftware

Stars4473

Updated2026-05-01

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-agentossoftware-surfagent": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

surfagent-perception

Agent vision for web pages — scene summaries, attention-ranked elements, annotated screenshots, and state diffing via SurfAgent's perception engine.

agentossoftware 4473

surfagent-browser

Control a real Chrome browser from your AI agent — navigate, click, type, fill forms, extract content, manage tabs, and automate workflows via SurfAgent's REST API.

agentossoftware 4473

Agentos

Skill by agentossoftware

agentossoftware 4473

Agentos Sdk

Skill by agentossoftware

agentossoftware 4473

Agentos Mesh

Skill by agentossoftware

agentossoftware 4473