Browser Cdp
Apps & Automationbrowser-cdpBrowser Cdp is an Agent Skill for apps & automation published in the adolfousier/opencrabs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Native CDP browser automation reference. Headless/headed Chrome control, screenshots, JS evaluation. (/browser-cdp, browser automation, cdp, scraping)
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/adolfousier/opencrabs/blob/HEAD/src/docs/reference/templates/skills/browser-cdp/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/browser-cdp, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Native Browser Automation (CDP)
Built-in browser control via Chrome DevTools Protocol — no Node.js, no Playwright, pure Rust.
Tools
| Tool | Required | Optional | What |
|---|---|---|---|
browser_navigate | url | headless | Navigate to URL |
browser_click | selector | — | Click element by CSS selector |
browser_type | text | selector | Type text into input |
browser_screenshot | — | selector | Screenshot (returns file path) |
browser_eval | script | — | Execute JavaScript |
browser_content | — | selector, text_only | Extract text/HTML |
browser_wait | — | selector, timeout_secs, delay_secs | Wait for element or delay |
browser_find | pattern | mode, limit | Find elements on page |
Headless vs Headed
- Headless (default): No visible window. Fast, low resources.
- Headed: Visible Chrome window. Pass
headless: falsetobrowser_navigate.
Usage Tips
- Compose workflows: navigate → wait → click → type → screenshot
- Screenshots return file paths. Use
<<IMG:path>>to send to channels. - JavaScript evaluation for complex DOM manipulation and SPAs.
- No credentials stored. Navigate to login page and use click/type for auth (with user approval).
- Requires Chrome/Chromium installed. Feature-gated:
browserflag.
Chrome Launch Failures
- SingletonLock exists:
rm -f ~/.opencrabs/chrome-profile/SingletonLock ~/.opencrabs/chrome-profile/SingletonCookie ~/.opencrabs/chrome-profile/SingletonSocketthen retry. - DevTools data dir conflict:
pkill -f chromethen retry. - Channel closed: Kill Chrome, delete lock files, retry.