real-browser-control

real-browser-control is a skill for Claude Code, Codex from ofershap/real-browser-mcp. It costs 158 tokens per session (1,157 once invoked), scanned A, original, MIT.

A connection between an AI coding agent and the user's real Chrome profile through a local server and browser extension.

In plain words
What is it for?
It helps verify local or staging websites, inspect bugs already open in a tab, check authenticated admin pages, and test changes in the user's browser.
Why use it?
It gives the agent access to open tabs and existing logins, including single sign-on, two-factor authentication, and staging sessions that a new browser may not have.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ofershap/real-browser-mcp/real-browser-control
Any agent
npx skills add ofershap/real-browser-mcp --skill real-browser-control
Clone the repo
git clone --depth 1 https://github.com/ofershap/real-browser-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for real-browser-control

README.md
[![agentmods](https://agentmods.dev/badge/skills/ofershap/real-browser-mcp/real-browser-control.svg)](https://agentmods.dev/skills/ofershap/real-browser-mcp/real-browser-control)
Your own site
<a href="https://agentmods.dev/skills/ofershap/real-browser-mcp/real-browser-control"><img src="https://agentmods.dev/badge/skills/ofershap/real-browser-mcp/real-browser-control.svg" alt="Measured on agentmods" height="20"></a>
Per session 158 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,157 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00158 $0.01157
Opus 5 $0.00079 $0.00579
Sonnet 5 $0.00032 $0.00231
Haiku 4.5 $0.00016 $0.00116

Measured 6d ago against content hash 2c1e5c147ee2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

real-browser-control scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/real-browser-control/SKILL.md · 91 lines

How it starts

The opening of the file, as written. The whole thing — 91 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Real Browser MCP control

Drive the user's actual Chrome profile through Real Browser MCP. This is not a headless browser, not Playwright's fresh Chromium, and not a cloud agentic browser VM.

Why this exists

Most agent browser stacks give the agent a new browser. Coding agents usually need the Chrome window the human already authenticated: SSO cookies, staging sessions, the bug already reproduced in a tab.

Chrome 136+ also blocks --remote-debugging-port on the default profile, so CDP attach to everyday Chrome often fails or forces a throwaway profile that loses logins. Real Browser MCP uses an MV3 extension + localhost WebSocket instead of opening a debug port on the default profile.

When to use vs alternatives

Need Real Browser MCP Playwright / headless MCP Cloud agentic browser Chrome DevTools MCP (CDP)
Human's existing logins / SSO Yes Replay or inject state Separate login Hard on default profile after Chrome 136
Tab already open with the bug Yes New window Remote session Attach path dependent
CI / repeatable clean runs No Yes Sometimes Weak fit
Local coding-agent verify loop Yes Possible but cold start Not local IDE-native Debugging-oriented

If the user says "agentic browser" but means "use my Chrome that is already logged in," choose Real Browser MCP.

Prerequisites

  1. MCP server: npx -y real-browser-mcp
  2. Chrome extension installed; popup green = connected
  3. browser_tabs action list to confirm the bridge

Tools

Tool When to use
browser_navigate Open a URL in the active tab
browser_tabs List, create, focus, or close tabs
browser_snapshot Accessibility tree + refs (default first step)
browser_screenshot Visual proof; heavier than snapshot
browser_click / browser_click_text Act on ref or visible text
browser_type Fill inputs (contentEditable needs care)
browser_press_key Enter, Escape, shortcuts
browser_scroll / browser_wait Lazy feeds, SPAs, overlays
browser_text / browser_find Read content or locate elements
browser_console / browser_network Debug failures
browser_evaluate Last resort; breaks CSP sites and shows debugger banner
browser_handle_dialog Register before alert/confirm/prompt

Read the full file on GitHub · 91 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 91 lines · 158 tokens per session scan A 2c1e5c147ee2

Subscribe to this mod's changes

real-browser-control is a skill published in the GitHub repository ofershap/real-browser-mcp (50 stars, last pushed 6d ago), licensed MIT. It adds 158 tokens to every session and 1,157 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

browseweave

Use when installing, repairing, verifying, diagnosing, or safely operating the BrowseWeave systemd-based Linux developer preview with Chrome, Zen, or Firefox and a local MCP client. Do not use for store publication or bypassing site protections.

xenitV1/browseweave · 52 tokens

aipex-browser

AI-powered browser automation using the AIPex Chrome Extension via MCP bridge. Use this skill when the agent needs to control a Chrome browser — navigating pages, clicking elements, filling forms, capturing screenshots, managing tabs, or downloading content — by connecting to the AIPex MCP bridge.

AIPexStudio/AIPex · 61 tokens

Agent Browser Automation

Fast Rust-based headless browser automation CLI with Node.js fallback for AI agents, featuring navigation, clicking, typing, snapshots, and structured commands optimized for agent workflows.

PramodDutta/qaskills · 37 tokens

owb

Open Web Bridge (OWB) — drive the user's own real browser with the owb command. Read pages behind their existing logins, gather and cross-check information, fill forms, walk multi-step flows, debug their site, audit responsive/accessibility behavior, and capture or reverse-engineer network traffic. Use this whenever…

woniu9524/open-web-bridge · 143 tokens

Browser-Use Automation

CLI tool for persistent browser automation with multi-session support, featuring Chromium/Real/Remote browser modes, cookie management, JavaScript execution, and long-running automation workflows.

PramodDutta/qaskills · 38 tokens

browser-relay

Control the Chrome the user already has open and logged in through the Browser Relay CLI, without launching a separate automation browser or taking over the foreground tab. Use when an agent needs to work with existing sessions, cookies, extensions, SSO or intranet pages, or a browser on another machine. Prefer the…

reliefeai/browser-relay · 86 tokens