OpenParable
Skip to content
← Back to skills

Browser Cdp

Apps & Automation
browser-cdp

Browser 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)

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

ToolRequiredOptionalWhat
browser_navigateurlheadlessNavigate to URL
browser_clickselector—Click element by CSS selector
browser_typetextselectorType text into input
browser_screenshot—selectorScreenshot (returns file path)
browser_evalscript—Execute JavaScript
browser_content—selector, text_onlyExtract text/HTML
browser_wait—selector, timeout_secs, delay_secsWait for element or delay
browser_findpatternmode, limitFind elements on page

Headless vs Headed

  • Headless (default): No visible window. Fast, low resources.
  • Headed: Visible Chrome window. Pass headless: false to browser_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: browser flag.

Chrome Launch Failures

  1. SingletonLock exists: rm -f ~/.opencrabs/chrome-profile/SingletonLock ~/.opencrabs/chrome-profile/SingletonCookie ~/.opencrabs/chrome-profile/SingletonSocket then retry.
  2. DevTools data dir conflict: pkill -f chrome then retry.
  3. Channel closed: Kill Chrome, delete lock files, retry.