mirrors / browser-use--browser-harness

项目文件夹

T

sauravpanda c2167e544e Add browser-harness validated domain skills for batch 7

Glassdoor (Cloudflare managed challenge; browser only; __NEXT_DATA__ + DOM fallbacks),
Medium (?format=json strips XSSI prefix; GraphQL /_/graphql no auth; RSS 10-item cap),
SoundCloud (oEmbed no-auth; __sc_hydration apiClient.id as client_id; API v2 with pagination),
Genius (OS token in UA bypasses 403; internal /api/songs no auth; strip first lyrics div header),
Dev.to (public REST API; burst limit 6 req then 429/1s; listings empty without auth).

2026-04-18 04:31:04 -07:00

docs

[codex] Refresh remote debugging screenshot (#30 )

2026-04-17 21:55:58 -07:00

domain-skills

Add browser-harness validated domain skills for batch 7

2026-04-18 04:31:04 -07:00

interaction-skills

Simplify helper surface (#23 )

2026-04-17 21:37:58 -07:00

.env.example

add remote browser support (Browser Use cloud) + multi-daemon + rename to bu (#1 )

2026-04-17 00:28:02 -07:00

.gitignore

Clean up install bootstrap flow (#25 )

2026-04-17 21:34:26 -07:00

admin.py

Simplify helper surface (#23 )

2026-04-17 21:37:58 -07:00

daemon.py

Simplify helper surface (#23 )

2026-04-17 21:37:58 -07:00

helpers.py

[codex] Add domain skill name helper (#42 )

2026-04-17 23:49:05 -07:00

install.md

Remove default ensure_real_tab from docs (#36 )

2026-04-17 22:46:33 -07:00

pyproject.toml

[codex] Rename CLI to browser-harness run (#35 )

2026-04-17 22:33:05 -07:00

README.md

Add more spacing between README sections (#44 )

2026-04-18 00:32:48 -07:00

run.py

[codex] Rename CLI to browser-harness run (#35 )

2026-04-17 22:33:05 -07:00

SKILL.md

[codex] Refine domain skill guidance (#41 )

2026-04-17 23:27:35 -07:00

README.md

Browser Harness

The simplest, thinnest, and most powerful harness to control your real browser with your agent.

Setup prompt

Set up https://github.com/browser-use/browser-harness for me.

Read `install.md` first to install and connect this repo to my real browser. Then read `SKILL.md` for normal usage. Always read `helpers.py` because that is where the functions are. When you open a setup or verification tab, activate it so I can see the active browser tab. After it is installed, if I am already logged in to GitHub, star this repository as a small verification task; if I am not logged in, just go to browser-use.com.

When this page appears tick the checkbox so the agent can connect to the real browser.

Example task

Star this repository.

See domain-skills/ for examples on other websites.

Code Structure

install.md explains first-time install and browser bootstrap.
SKILL.md explains day-to-day browser harness usage.
run.py (~13 lines) executes plain Python with helpers preloaded.
helpers.py (~192 lines) holds the starting tool calls to interact with the browser and can be modified by the agent.
admin.py (~139 lines) holds daemon bootstrap and optional remote-browser helpers.
daemon.py (~220 lines) keeps the CDP websocket and socket bridge alive.

Optional: Remote browsers

Useful for sub-agents or deployment.

Get a Browser Use API key: cloud.browser-use.com/new-api-key
The agent can also sign up by itself by fetching docs.browser-use.com/llms.txt, which contains the setup flow and challenge context for getting a Browser Use API key.