# Send Browser Js to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "browser-js", "name": "Browser Js", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/shaihazher/browser-js", "canonicalUrl": "https://clawhub.ai/shaihazher/browser-js", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/browser-js", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=browser-js", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "_meta.json", "scripts/browser.js", "scripts/package-lock.json", "scripts/package.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "browser-js", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T02:39:04.244Z", "expiresAt": "2026-05-08T02:39:04.244Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=browser-js", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=browser-js", "contentDisposition": "attachment; filename=\"browser-js-1.5.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "browser-js" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/browser-js" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/browser-js", "downloadUrl": "https://openagent3.xyz/downloads/browser-js", "agentUrl": "https://openagent3.xyz/skills/browser-js/agent", "manifestUrl": "https://openagent3.xyz/skills/browser-js/agent.json", "briefUrl": "https://openagent3.xyz/skills/browser-js/agent.md" } } ``` ## Documentation ### browser-js Lightweight CLI that talks to Chrome via CDP (Chrome DevTools Protocol). Returns minimal, indexed output that agents can act on immediately — no accessibility tree parsing, no ref hunting. ### Setup # Install dependency (one-time, in the skill scripts/ dir) cd scripts && npm install # Ensure browser is running with CDP enabled. # With OpenClaw: # browser start profile=openclaw # Or manually: # google-chrome --remote-debugging-port=18800 --user-data-dir=~/.browser-data The tool connects to http://127.0.0.1:18800 by default. Override with CDP_URL env var. ### Alias setup (optional) mkdir -p ~/.local/bin cat > ~/.local/bin/bjs << 'WRAPPER' #!/bin/bash exec node /path/to/scripts/browser.js "$@" WRAPPER chmod +x ~/.local/bin/bjs ### Commands bjs tabs List open tabs bjs open Navigate to URL bjs tab Switch to tab bjs newtab [url] Open new tab bjs close [index] Close tab bjs elements [selector] List interactive elements (indexed) bjs click Click element by index bjs type Type into element bjs upload [selector] Upload file to input (bypasses OS dialog) bjs text [selector] Extract visible page text bjs html Get element HTML bjs eval Run JavaScript in page bjs screenshot [path] Save screenshot bjs scroll [px] bjs url Current URL bjs back / forward / refresh bjs wait Coordinate commands (cross-origin iframes, captchas, overlays): bjs click-xy Click at page coordinates via CDP Input bjs click-xy --double Double-click at coordinates bjs click-xy --right Right-click at coordinates bjs hover-xy Hover at page coordinates bjs drag-xy Drag between coordinates bjs iframe-rect Get iframe bounding box (for click-xy targeting) ### How it works elements scans the page for all interactive elements (links, buttons, inputs, selects, etc.) — including those inside shadow DOM (web components). This means sites like Reddit, GitHub, and other modern SPAs that use shadow DOM are fully supported. The scan recursively pierces all shadow roots. Returns a compact numbered list: [0] (link) Hacker News → https://news.ycombinator.com/news [1] (link) new → https://news.ycombinator.com/newest [2] (input:text) q [3] (button) Submit Then click 3 or type 2 search query — immediately actionable, no interpretation needed. Auto-indexing: click and type auto-index elements if not already indexed. You can skip calling elements first and go straight to click/type after open. Call elements explicitly when you need to see what's on the page. After navigation or AJAX changes: Elements get re-indexed automatically on next click/type if stamps are stale. For manual re-index, call elements again. Real mouse events: click uses CDP Input.dispatchMouseEvent (mousePressed + mouseReleased) instead of JS .click(). This triggers React/Vue/Angular synthetic event handlers that ignore plain .click() calls. Works reliably on SPAs like Instagram, GitHub, LinkedIn. ### File uploads upload uses CDP's DOM.setFileInputFiles to inject files directly into hidden elements — no OS file picker dialog. Works with Instagram, Twitter, any site with file uploads. bjs upload ~/photos/image.jpg # auto-finds input[type=file] bjs upload ~/docs/resume.pdf "input.file-drop" # specific selector ### Token efficiency ApproachTokens per interactionNotesbjs~50-200Indexed list, 1-line responsesbrowser tool (snapshot)~2,000-5,000Full accessibility treebrowser tool + thinking~3,000-8,000Plus reasoning to find refs Over a 10-step flow: ~1,500 tokens (bjs) vs ~30,000-80,000 (browser tool). ### Typical flow bjs open https://example.com # Navigate bjs elements # See what's clickable bjs click 5 # Click element [5] bjs type 12 "hello world" # Type into element [12] bjs text # Read page content bjs screenshot /tmp/result.png # Verify visually ### Shadow DOM support bjs automatically pierces shadow DOM boundaries. Sites built with web components (Reddit, GitHub, etc.) work out of the box — elements, click, type, and text all recurse into shadow roots. No special flags needed. ### Coordinate commands (iframes, captchas, overlays) When you can't use click by index — e.g. the target is inside a cross-origin iframe (captcha checkbox, payment form, OAuth widget) — use coordinate-based commands that dispatch real CDP Input events at the OS level. These bypass all DOM boundaries. Workflow for clicking inside an iframe: bjs iframe-rect 'iframe[title*="hCaptcha"]' # Get bounding box # Output: x=95 y=440 w=302 h=76 center=(246, 478) bjs click-xy 125 458 # Click checkbox position iframe-rect returns the iframe's position on the page. Add offsets to target specific elements inside it (e.g. a checkbox is typically near the left side). Other uses: hover-xy — trigger hover menus, tooltips that need mouse position drag-xy — slider controls, drag-and-drop, canvas interactions click-xy --double — double-click to select text, expand items click-xy --right — context menus When to use coordinate commands vs click: click — always preferred when the element shows up in elements click-xy — only when the target is inside a cross-origin iframe or otherwise unreachable by DOM indexing ### Tips elements with a CSS selector narrows scope: bjs elements ".modal" eval runs arbitrary JS and returns the result — use for custom extraction text caps at 8KB — enough for most pages, won't blow up context html caps at 10KB — for inspecting specific elements Pipe through grep to filter: bjs elements | grep -i "submit\\|login" ## Trust - Source: tencent - Verification: Indexed source record - Publisher: shaihazher - Version: 1.5.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-01T02:39:04.244Z - Expires at: 2026-05-08T02:39:04.244Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/browser-js) - [Send to Agent page](https://openagent3.xyz/skills/browser-js/agent) - [JSON manifest](https://openagent3.xyz/skills/browser-js/agent.json) - [Markdown brief](https://openagent3.xyz/skills/browser-js/agent.md) - [Download page](https://openagent3.xyz/downloads/browser-js)