Playwright Selector Finder

Example Use Cases

• 1

  Locate and interact with page elements using natural language descriptions instead of crafting complex selectors.

• 2

  Perform navigation, form-filling, and element interactions programmatically via Playwright using accessibility snapshots.

• 3

  Extract structured data or run automated tests deterministically without relying on vision-based models.

Description

This package provides a Model Context Protocol (MCP) server and a SelectorFinder utility that maps natural language descriptions to robust Playwright selectors. It uses Playwright's accessibility tree (snapshot mode) for fast, deterministic, and LLM-friendly browser automation, with an optional vision mode for screenshot-based interactions. Typical use cases include navigation, form-filling, data extraction, and automated testing without relying on computer-vision models. It includes configurable retry logic, TypeScript support, and a small set of browser tools (click, type, drag, snapshot, etc.).