surfagentGitHub

the browser tool for AI agents

Connect any AI agent to Chrome. Get structured page data in milliseconds. No screenshots. No guessing.

No APIs needed. Navigate X, LinkedIn, any site — just like a real user.

$npm install -g surfagent

Then run surfagent start

Built for agents, not humans

>_

Research & Data Collection

Let your agent browse the web, extract structured data from any page, and compile results — no screenshots or guessing.

>>

Form Filling & Submissions

Agents can fill out forms, login flows, and multi-step wizards using real CDP keystrokes that work with any framework.

[]

E-Commerce & Price Monitoring

Navigate product pages, compare prices, track inventory. SPA-aware navigation handles dynamic sites like a real user.

~/

Testing & QA Automation

Point your agent at any web app. Page recon returns every selector and element — perfect for automated test generation.

{}

Dashboard & Report Scraping

Access authenticated dashboards behind logins. Cross-origin iframe support means embedded widgets are reachable too.

=>

Autonomous Web Workflows

Chain the recon → act → read loop to build agents that navigate complex multi-page workflows end to end.

How agents use it

1

Recon

Map the page. Get every selector, form, and element.

2

Act

Click, fill, scroll, navigate — using exact selectors.

3

Read

Check what happened. Verify, then recon again.

Works with Claude Code, Codex CLI, OpenCode, Gemini CLI, and more.