mcpField
B
browser

browser

github.com/julianromliDevelopment213129 installsUpdated 6d ago
Repository

About browser

browser is a skill with minimal CDP tools for exploring websites collaboratively and scraping page content. It supports Chrome startup, navigation, JavaScript evaluation, screenshots, and interactive element selection.

Key features

  1. 01Start Chrome with a fresh or copied profile
  2. 02Navigate the current or a new tab
  3. 03Evaluate JavaScript in the active page
  4. 04Capture viewport screenshots
  5. 05Select page elements interactively

Use cases

  1. 01Explore a website in Chrome
  2. 02Inspect page content with JavaScript
  3. 03Capture a page viewport
  4. 04Select DOM elements during investigation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/julianromli/ai-skills --skill browser

After installing, type/browserin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

eval.js
nav.js
package-lock.json
package.json
pick.js
screenshot.js
start.js

Details

From the project README

Browser Tools

Minimal CDP tools for collaborative site exploration and scraping.

IMPORTANT: All scripts are located in ~/.factory/skills/browser/ and must be called with full paths.

Start Chrome

~/.factory/skills/browser/start.js              # Fresh profile
~/.factory/skills/browser/start.js --profile    # Copy your profile (cookies, logins)

Start Chrome on :9222 with remote debugging.

Navigate

~/.factory/skills/browser/nav.js https://example.com
~/.factory/skills/browser/nav.js https://example.com --new

Navigate current tab or open new tab.

Evaluate JavaScript

~/.factory/skills/browser/eval.js 'document.title'
~/.factory/skills/browser/eval.js 'document.querySelectorAll("a").length'

Execute JavaScript in active tab (async context).

IMPORTANT: The code must be a single expression or use IIFE for multiple statements:

  • Single expression: 'document.title'
  • Multiple statements: '(() => { const x = 1; return x + 1; })()'
  • Avoid newlines in the code string - keep it on one line

Screenshot

~/.factory/skills/browser/screenshot.js

Screenshot current viewport, returns temp file path.

Pick Elements

~/.factory/skills/browser/pick.js "Click the submit button"

Interactive element picker. Click to select, Cmd/Ctrl+Click for multi-select, Enter to finish.

Usage Notes

  • Start Chrome first before using other tools
  • The --profile flag syncs your actual Chrome profile so you're logged in everywhere
  • JavaScript evaluation runs in an async context in the page
  • Pick tool allows you to visually select DOM elements by clicking on them

Comments

Markdown supported