Repository navigation
Releases
Releases · Tthanh2k6/turbo-browser-mcp
v0.7.1
Fixes found while using the server on real sites (Gmail, LinkedIn job pages, an ATS form).
Refs
- A ref fails with a clear error after a cross-document navigation instead of resolving on the new page.
- A ref remembers a short text fingerprint, so a virtualized list that reuses the node for another row is refused instead of clicked.
- Form fields keep an identity fingerprint (tag, type, name, id, aria-label, placeholder, role, label text). A recycled input that now belongs to another field is refused. Values never count.
Snapshots
inspect_compactappliesqueryinsideselector.querymatches table/grid rows (role="row") by their whole text, so mail-list rows can be found.- With a popup or modal open, a
querystill searches the page behind it and marks those lines[behind popup]. - A field whose name or id is generated (UUID, long hex,
:r6:) is labelled by the question text next to it. - Links inside an editable area get their own text as the label.
Actions
checkon a visually hidden checkbox clicks its label or visible wrapper and verifies the state changed.possibleSubmitno longer fires for Gmail's background RPCs (presence, suggestions, people lookups) or its sync call. A real send is still reported.- Page-view and analytics beacons, ping requests and ad beacons are not
possibleSubmit.
Tabs and text
tabs_batchnavigateon another tab no longer makes it the default tab unlessactivate: true.extract_clean_text: on a smallmaxCharsthe URL/title header shrinks so most of the budget is content. The total still stays withinmaxChars.
v0.7.0
Most of this release comes from running the server against real sites (job boards, Reddit, dev.to, booking pages, a selenium.dev form) and fixing what broke. 677 tests, CI on Node 20 and 22.
New
- Several MCP servers on one Chrome. The CDP bridge (Chrome 144+, one "Allow remote debugging" click) now gives each connected client its own CDP sessions. Two agents can drive the same logged-in Chrome at once. A client's isolated contexts close when it disconnects, and tabs held by another client are listed as
isolatedContext:"other". - Host allowlist.
--allow-hosts/TURBO_BROWSER_ALLOW_HOSTS,--allow-origins, and--allow-strict, which also aborts sub-resource and iframe requests to other hosts (best effort, see the README). Off by default. - Secrets.
--secrets <file>(dotenv). A value of exactly$secret:NAMEis replaced at typing time; values are never logged or returned. - Content boundaries.
--content-boundarieswraps page text in<<page:nonce>>markers so a model can tell page content from instructions. About 21 tokens per result. - Bundled skill.
npx -y turbo-browser-mcp --print-skillprints a short SKILL.md for Claude Code and other agents. expect.textNew(also matches a new document title),snapshotQuery, batch stepsreload/back/forward, print-CSS PDFs.
Fixed or changed after real-site runs
- A tab paused in DevTools no longer hangs
tabs_batch; it is markedunresponsiveand calls to it fail fast. - Redirects to a login page and 401/403 login forms report
blocked:"authwall"; bot walls are reported inopen_many. - The bridge exits when Chrome stops remote debugging, and auto mode explains the headless fallback in
connectionNoteonce. - Web-component inputs and date pickers that clear a value on blur are retyped and reported.
- Clicks on disabled targets fail in about a second instead of timing out. Links and search forms no longer trip the submit guard. Booking buttons ("Book now", "Schedule meeting", "Đặt lịch") do.
- Placeholder options in selects count as empty,
collecttakes the href from the matched anchor and dedupes regardless of whitespace, truncated typing is reported, toasts show up in results.
Full list: v0.6.1...v0.7.0
v0.6.1
Fix: --version, --doctor and the MCP serverInfo now read the version from package.json. 0.6.0 still reported 0.5.0.
- The npm package ships
src/only (11 files, 99 kB). Benchmarks stay in the repo. - README reorganised: install from npm first, tools table near the top, one copy of each benchmark table, scope of the benchmarks stated,
observeAftermathdocumented.
v0.6.0
Changes driven by HN and dev.to feedback:
- smart_fill_form: keyboard fallback for portaled and windowed comboboxes (react-select, Radix, Headless UI); only reports success when the value commits (suggested by johnnylemonny, alexcodebytes, eye_java)
- Optional click aftermath report: navigation and mutating requests within ~1 s of a click (eye_java)
- Agent end-to-end benchmark harness vs browser-harness/browser-use, browse and agent-browser (snake_doc); results will be published once all trials finish
- README: known limits and roadmap
437 tests passing.