Browserless Plugin for Claude Code
A Claude Code plugin that gives Claude direct access to the Browserless.io REST APIs: scrape webpages, take screenshots, generate PDFs, search the web, map site structures, and run custom browser automation, all from natural language.
Installation
Install from inside Claude Code:
/plugin marketplace add browserless/claude-plugin
/plugin install browserless@browserless
To pull future updates:
/plugin marketplace update browserless
Manual install (local development)
Clone the repo and point Claude Code at the plugin directory:
git clone https://github.com/browserless/claude-plugin.git
cd claude-plugin
claude --plugin-dir .
Setup
1. Get a Browserless API token
Sign up for free at browserless.io and grab your API token.
2. Authenticate
Run the auth skill inside Claude Code:
/browserless:auth
This will prompt you for your token and preferred API region (SFO, LON, or a custom URL), then save the credentials to ~/.browserless/.env.
Alternatively, set the environment variable directly:
export BROWSERLESS_TOKEN=your-token-here
3. Start using skills
Once authenticated, all skills are available as slash commands:
/browserless:smart-scrape https://example.com
/browserless:screenshot https://example.com
/browserless:pdf https://example.com
/browserless:search what is browserless
/browserless:map https://example.com
/browserless:function click the login button on https://example.com
/browserless:download download the CSV export from https://example.com/reports
/browserless:export save https://example.com with all assets for offline viewing
/browserless:performance run a lighthouse audit on https://example.com
/browserless:crawl crawl https://example.com up to 3 levels deep
Skills
| Skill | Command | Description | Example Prompt |
|---|
| Auth | /browserless:auth | Configure API token and region. Subcommands: status, clear, region. | |
| Smart Scrape | /browserless:smart-scrape | Scrape webpages with cascading strategies (HTTP fetch, proxy, headless browser, captcha solving). Returns markdown, HTML, screenshots, PDFs, or links. | summarize the main content of https://news.ycombinator.com |
| Screenshot | /browserless:screenshot | Capture screenshots of webpages. Supports full-page, element-specific, viewport sizing, image formats (PNG/JPEG/WebP), and proxy/geo-targeting. | take a screenshot of https://inet-ip.info/ using a French proxy, wait 5 seconds before taking it |
| PDF | /browserless:pdf | Generate PDFs from webpages or HTML. Supports paper formats, margins, headers/footers, landscape, background graphics, and tagged/accessible PDFs. | save https://en.wikipedia.org/wiki/Headless_browser as a landscape A4 PDF |
| Search | /browserless:search | Search the web and optionally scrape result pages. Supports web, news, and image sources with time-based filtering and content categories. | find recent AI news en español from the last week |
| Map | /browserless:map | Discover and list all URLs on a website. Crawls sitemaps, pages, and subdomains with relevance-based search filtering. | save a list of all URLs on https://browserless.io in json format |
| Function | /browserless:function | Execute custom Puppeteer JavaScript in a cloud browser. Run arbitrary automation scripts, interact with page elements, fill forms, and return structured data. | load the ./scripts/sample-script.js file and run it using /function |
| Download | /browserless:download | Run custom Puppeteer code and capture files downloaded by Chrome during execution. Extract CSVs, PDFs, images, or any downloadable file from a website. | download the CSV export from https://example.com/reports |
| Export | /browserless:export | Export a webpage in its native format, optionally bundling all resources (CSS, JS, images) into a ZIP archive for offline use. | save https://example.com with all assets as a ZIP |
| Performance | /browserless:performance | Run a Lighthouse audit on a webpage. Get scores for performance, accessibility, best practices, SEO, and PWA. | audit the performance and accessibility of https://example.com |
| Crawl | /browserless:crawl | Crawl an entire website starting from a seed URL, following links to configurable depth while scraping all discovered pages. | crawl https://docs.browserless.io up to 3 levels deep |
Auth Management
| Command | Description |
|---|
/browserless:auth | Interactive setup — set token and region |
/browserless:auth status | Check if authentication is configured |
/browserless:auth clear | Remove saved credentials |
/browserless:auth region | Change API region without re-entering token |
