💬 Commit message: Update 2026-02-11 18:57:11, 3 files, 84 lines

📁 Files changed: 3
📝 Lines changed: 84

  • README.md
  • package-lock.json
  • package.json
This commit is contained in:
Adam Ladachowski
2026-02-11 18:57:11 +01:00
parent d9f88a37c9
commit 9942f7495c
3 changed files with 22 additions and 62 deletions
+19 -59
View File
@@ -5,54 +5,9 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/node/v/@saiden/browse.svg)](https://nodejs.org)
#### Headless browser automation for Claude Code using Playwright WebKit.
## Claude Code Plugin (Recommended)
Headless browser automation via MCP using Playwright WebKit.
Install as a Claude Code plugin for the best integration:
```bash
# Add the saiden marketplace (one-time)
claude plugin marketplace add https://github.com/saiden-dev/claude-plugins
# Install the plugin
claude plugin install browse@saiden
# Update to latest version
claude plugin marketplace update saiden && claude plugin update browse@saiden
```
**Prerequisites:** Node.js 18+, Playwright WebKit (`npx playwright install webkit`)
### Plugin Features
**Slash Commands:**
| Command | Description |
|---------|-------------|
| `/browse:start` | Start an interactive browsing session |
| `/browse:goto <url>` | Navigate to URL and describe findings |
| `/browse:screenshot` | Take a screenshot of the current page |
| `/browse:scrape <url>` | Scrape content from a webpage |
| `/browse:analyze` | Analyze current page content and structure |
| `/browse:extract [selector]` | Extract structured data from page |
| `/browse:fill [data]` | Help fill out forms |
| `/browse:compare [action]` | Compare page states before/after action |
| `/browse:save` | Save current session state to file |
| `/browse:restore` | Restore a previously saved session |
| `/browse:end` | End the browsing session and close browser |
**MCP Resources (@ mentions):**
| Resource | Description |
|----------|-------------|
| `@browse:browser://state` | Browser state (URL, title, launched) |
| `@browse:browser://html` | Page HTML (truncated to 10KB) |
| `@browse:browser://html/full` | Complete page HTML |
| `@browse:browser://screenshot` | Page screenshot as base64 PNG |
---
## Installation (npm)
## Installation
```bash
npm install @saiden/browse
@@ -90,29 +45,35 @@ browse -p -c "button.submit" https://example.com
browse -p --preview-delay 3000 -c ".nav-link" https://example.com
```
## MCP Server (Standalone)
## MCP Server
Use with any MCP-compatible client:
```bash
# Run the MCP server
browse-mcp
```
Add to Claude Code's MCP config (`~/.claude/settings.json`):
Add to your MCP client config (e.g., `~/.claude/settings.json` or project `.mcp.json`):
```json
{
"mcpServers": {
"browser": {
"command": "browse-mcp"
"browse": {
"command": "npx",
"args": ["browse-mcp"]
}
}
}
```
Or run directly:
```bash
browse-mcp
```
### MCP Tools Reference
**Browser Lifecycle:**
| Tool | Description |
|------|-------------|
| `launch` | Launch browser with options (headed, fullscreen, preview, viewport) |
| `close` | Close the browser and end session |
**Navigation & Interaction:**
| Tool | Description |
|------|-------------|
@@ -126,7 +87,6 @@ Add to Claude Code's MCP config (`~/.claude/settings.json`):
| `upload` | Upload files to a file input |
| `back`, `forward`, `reload` | Browser navigation |
| `wait` | Wait for a specified time |
| `close` | Close the browser and end session |
**Debugging & Inspection:**
| Tool | Description |
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "@saiden/browse",
"version": "0.2.13",
"version": "0.2.14",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@saiden/browse",
"version": "0.2.13",
"version": "0.2.14",
"license": "MIT",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.26.0",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@saiden/browse",
"version": "0.2.13",
"version": "0.2.14",
"description": "Headless browser automation for Claude Code using Playwright WebKit",
"type": "module",
"main": "dist/index.js",