What is browser-control?

This Claude skill enables comprehensive browser automation and control via Playwright scripts, specifically optimized for authenticated web interactions. It allows the agent to navigate complex, JavaScript-heavy websites, bypass common scraping hurdles through real browser profiles, and perform tasks like logging into accounts, extracting real-time data, and capturing safe-to-read screenshots for visual analysis.

When should I use browser-control?

browser-control is useful in the following scenarios: • Travel Research & Loyalty Management: Automate the process of checking Marriott Bonvoy points availability or Alaska Airlines mileage plans by logging into secure user accounts. • Dynamic Content Scraping: Extract data from JavaScript-heavy forums and social platforms like FlyerTalk, Reddit, or TripAdvisor that require active session management and complex navigation. • Real-time Price Monitoring: Look up live hotel and flight prices directly from provider websites to find the best deals without relying on delayed third-party APIs. • Visual Web Auditing: Capture high-resolution, auto-resized screenshots of complex web layouts (including lazy-loaded sites like Airbnb) for visual verification and UI analysis. • Automated Form Interaction: Perform multi-step searches and form submissions on travel booking portals to retrieve specific availability and pricing data.

name	browser-control
description	Full browser control for authenticated web interactions using Playwright scripts
allowed-tools	Bash, Read
version	0.1.0

Browser Control Skill

Full browser automation for travel research requiring authentication or complex interactions.

When to Activate

Use this skill when you need to:

Access authenticated pages (Marriott, Alaska Airlines accounts)
Check real-time availability and prices
Scrape forum threads (FlyerTalk, Reddit)
Interact with JavaScript-heavy travel sites
Fill forms or perform searches on websites

Architecture

Script-based approach - No MCP overhead. Scripts load only when needed.

Prerequisites

Geoffrey Chrome Profile must be running with remote debugging:
```
./scripts/launch-chrome.sh
```
Profile must have logins saved for:
- Marriott Bonvoy
- Alaska Airlines Mileage Plan
- FlyerTalk
- TripAdvisor
- Reddit

Available Scripts

All scripts are in ./scripts/ and use Playwright connecting via CDP.

Script	Purpose	Usage
`launch-chrome.sh`	Start Geoffrey Chrome profile	`./scripts/launch-chrome.sh`
`navigate.js`	Navigate to URL and get page content	`bun scripts/navigate.js <url>`
`screenshot.js`	Take screenshot of page	`bun scripts/screenshot.js <url> [output] [--full]`
`extract.js`	Extract text/data from page	`bun scripts/extract.js <url> <selector> [--all]`
`interact.js`	Click, type, select on page	`bun scripts/interact.js <url> <action> <selector> [value]`
`search.js`	Search travel sites	`bun scripts/search.js <site> <query>`

Usage Examples

Check Marriott Points Availability

# Navigate to Marriott search
bun scripts/navigate.js "https://www.marriott.com/search/default.mi"

# Or use the search script
bun scripts/search.js marriott "Westin Rusutsu February 2026"

Get FlyerTalk Thread Content

bun scripts/extract.js "https://www.flyertalk.com/forum/thread-url" ".post-content"

Screenshot Hotel Page

bun scripts/screenshot.js "https://www.marriott.com/hotels/travel/ctswi-the-westin-rusutsu-resort/" rusutsu.png

Screenshot Protection & Lazy-Loading

Auto-Resize Protection (ALL screenshots):

Post-capture resize using Sharp to max 7500px per dimension
Maintains aspect ratio, prevents Claude Code API crashes
Every screenshot guaranteed safeToRead: true

Lazy-Loading Limitation (AirBnB, dynamic sites):

Sites with lazy-loading show grey placeholders in fullPage mode
Images only load when scrolled into viewport
Solution: Use viewport screenshots (no --full flag) or screenshot-current.js

# For lazy-loading sites, screenshot current viewport
bun scripts/screenshot-current.js /tmp/output.png

# Or navigate + viewport screenshot
bun scripts/screenshot.js "https://airbnb.com/..." /tmp/output.png

Example output:

{
  "success": true,
  "url": "https://example.com",
  "title": "Example Page",
  "screenshot": "/tmp/screenshot.png",
  "dimensions": { "width": 1920, "height": 1080 },
  "originalDimensions": { "width": 1920, "height": 1080 },
  "scaled": false,
  "safeToRead": true,
  "timestamp": "2025-11-28T..."
}

Connection Details

Scripts connect to Chrome via Chrome DevTools Protocol (CDP):

URL: http://127.0.0.1:9222
Profile: ~/.chrome-geoffrey

Error Handling

If scripts fail to connect:

Ensure Chrome is running with ./scripts/launch-chrome.sh
Check port 9222 is not in use: lsof -i :9222
Kill existing Chrome debugger: pkill -f "remote-debugging-port"

Output Format

All scripts return JSON:

{
  "success": true,
  "url": "https://example.com",
  "title": "Page Title",
  "content": "Extracted content or action result",
  "timestamp": "2025-11-22T..."
}

Limitations

Requires Geoffrey Chrome profile to be running
Cannot bypass CAPTCHAs (uses real browser fingerprint to avoid most)
Heavy sites may be slow
Some sites block automation despite real browser

Future Enhancements

Add cookie/session export for headless runs
1Password CLI integration for credential rotation
Parallel page operations
Browser-Use (Python) for complex visual tasks

browser-control

When & Why to Use This Skill

Use Cases