Skip to content

CortexPrism/cortex-plugin-playwright

Repository files navigation

CortexPrism Playwright Browser Agent

Give Cortex agents a real Chromium browser via Playwright — navigate, click, type, screenshot, and extract structured data from web pages. The #1 most-demanded MCP capability, now available as a native Cortex plugin.

Installation

cortex plugin install cortex-plugin-playwright

Or install from local development:

git clone https://github.com/CortexPrism/cortex-plugin-playwright.git
cd cortex-plugin-playwright
cortex plugin install .

Configuration

Configure in the Cortex UI under Plugins → Playwright → Settings:

General

Setting Type Default Description
headless boolean true Run browser without a visible window
viewportWidth number 1280 Default viewport width in pixels
viewportHeight number 720 Default viewport height in pixels
defaultTimeoutMs number 30000 Default timeout for operations in milliseconds

Playwright Runtime

For full browser automation (click, type, evaluate, real screenshots), install Playwright:

npx playwright install chromium
npx playwright install-deps

Without Playwright installed, browser_navigate and browser_extract fall back to HTTP fetch with regex-based extraction.

Tools

browser_navigate

Navigate the browser to a URL. Returns page title and text content.

{ "url": "https://example.com", "waitUntil": "networkidle" }

browser_click

Click on an element matching a CSS selector.

{ "selector": "#submit-button", "timeout": 5000 }

browser_type

Type text into an input element.

{ "selector": "#search-input", "text": "cortex prism plugins" }

browser_screenshot

Take a screenshot of a web page by URL.

{ "url": "https://example.com", "fullPage": true }

browser_extract

Extract structured data from a web page using CSS selectors.

{ "url": "https://example.com", "selector": "a.title", "attribute": "href", "multiple": true }

browser_evaluate

Execute JavaScript in the browser context. Requires Playwright CLI installed.

{ "script": "document.querySelectorAll('h2').length" }

browser_close

Close the browser instance and release resources.

{}

Usage Example

> Navigate to the CortexPrism marketplace page and extract all plugin names

1. browser_navigate → { url: "https://cortexprism.io/marketplace" }
2. browser_extract → { url: "https://cortexprism.io/marketplace", selector: ".plugin-card h3", multiple: true }
→ Returns array of all plugin names

Capabilities

Capability Purpose
network:fetch Fetch web pages via HTTPS
shell:run Execute Playwright CLI for full browser interaction
fs:read Read local files if needed for browser automation

Development

# Run tests
deno task test

# Format and lint
deno fmt && deno lint

# Test locally
cortex plugin install .
cortex plugin call cortex-plugin-playwright browser_navigate '{"url":"https://example.com"}'

License

MIT

About

Give agents a real Chromium browser via Playwright \u2014 navigate, click, type, screenshot, and extract structured data from web pages

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors