Playwright MCP Actor

Under maintenance

Pricing

from $3.00 / 1,000 results

Try for free

Go to Apify Store

Playwright MCP Actor

Under maintenance

Try for free

The Playwright MCP Actor integrates the robust browser automation capabilities of Playwright with the Model Context Protocol (MCP), enabling AI agents and language models to perform web scraping, testing, and automation tasks through a standardized interface.

Pricing

from $3.00 / 1,000 results

Rating

0.0

(0)

Developer

anuj upadhyay

Maintained by Community

Actor stats

Bookmarked

Total users

Monthly active users

3 hours ago

Last modified

Categories

Automation

Developer tools

You can access the Playwright MCP Actor programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "H4FSVs83sqPIgfB1a"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aluminum_jam~playwright-mcp-actor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aluminum_jam-playwright-mcp-actor",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/aluminum_jam~playwright-mcp-actor/runs": {
      "post": {
        "operationId": "runs-sync-aluminum_jam-playwright-mcp-actor",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/aluminum_jam~playwright-mcp-actor/run-sync": {
      "post": {
        "operationId": "run-sync-aluminum_jam-playwright-mcp-actor",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "actions"
        ],
        "properties": {
          "browser_type": {
            "title": "Browser Type",
            "enum": [
              "chromium",
              "firefox",
              "webkit"
            ],
            "type": "string",
            "description": "Browser to use for automation (chromium, firefox, or webkit)",
            "default": "chromium"
          },
          "headless": {
            "title": "Headless Mode",
            "type": "boolean",
            "description": "Run browser in headless mode (without UI)",
            "default": true
          },
          "proxy": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Configure proxy settings for requests",
            "properties": {
              "use_apify_proxy": {
                "type": "boolean",
                "title": "Use Apify Proxy",
                "description": "Use Apify's proxy service for requests"
              },
              "apify_proxy_groups": {
                "type": "array",
                "title": "Apify Proxy Groups",
                "description": "Proxy groups to use (e.g., RESIDENTIAL, SHADER, BUYPROXIES94952)",
                "items": {
                  "type": "string"
                }
              },
              "custom_proxy_url": {
                "type": "string",
                "title": "Custom Proxy URL",
                "description": "Custom proxy server URL (e.g., http://proxy.example.com:8080)"
              }
            }
          },
          "stealth_mode": {
            "title": "Stealth Mode",
            "type": "boolean",
            "description": "Enable anti-detection features to avoid bot detection",
            "default": false
          },
          "template": {
            "title": "Pre-built Template",
            "enum": [
              "",
              "amazon_product_search",
              "google_search",
              "linkedin_profile",
              "twitter_scrape",
              "google_maps_business"
            ],
            "type": "string",
            "description": "Use a pre-built template (amazon_product_search, google_search, linkedin_profile, twitter_scrape, google_maps_business)"
          },
          "template_params": {
            "title": "Template Parameters",
            "type": "object",
            "description": "Parameters for the selected template (e.g., search_query, max_results)"
          },
          "export_format": {
            "title": "Export Format",
            "enum": [
              "json",
              "csv",
              "excel"
            ],
            "type": "string",
            "description": "Format to export extracted data (json, csv, or excel)",
            "default": "json"
          },
          "actions": {
            "title": "Automation Actions",
            "type": "array",
            "description": "Array of browser automation actions to execute sequentially",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "title": "Action Type",
                  "description": "Type of action: navigate, click, fill, select, screenshot, extract_text, etc."
                },
                "selector": {
                  "type": "string",
                  "title": "Element Selector",
                  "description": "CSS selector, XPath, or text to identify the element"
                },
                "value": {
                  "type": "string",
                  "title": "Value",
                  "description": "Value for the action (URL for navigate, text for fill, etc.)"
                },
                "selector_type": {
                  "type": "string",
                  "title": "Selector Type",
                  "description": "Type of selector: css, xpath, text, role, or auto"
                },
                "timeout": {
                  "type": "integer",
                  "title": "Timeout (ms)",
                  "description": "Maximum time to wait for action completion in milliseconds"
                }
              },
              "required": [
                "type"
              ]
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Playwright MCP Actor OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Playwright MCP Actor from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Playwright MCP Actor API in Python

Playwright MCP Actor API in JavaScript

Playwright MCP Actor API through CLI

Playwright MCP Actor API

Playwright MCP Server

jiri.spilka/playwright-mcp-server

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright

Jiří Spilka

122

Playwright Mcp

nebulous_gauge/playwright-mcp

Dilip S Chakravarthi

Web Search MCP Server

abotapi/ai-search-mcp-server

An Apify MCP Server that provides real-time web search capabilities for AI agents via the Model Context Protocol (MCP).

AbotAPI

Firecrawl MCP Server

agentify/firecrawl-mcp-server

A Model Context Protocol (MCP) server implementation that integrates with Firecrawl MCP for web scraping capabilities

agentify

307

Puppeteer MCP

meysamazing/puppeteer-mcp

AI-powered browser automation via Model Context Protocol. Enable Claude, ChatGPT, and other AI assistants to control browsers, scrape data, and automate web tasks through natural language.

Meysam

Time MCP Server

agentify/time-mcp-server

An MCP server implementing the Model Context Protocol (MCP) for time-related operations.

agentify

Browserbase MCP Server

agentify/browserbase-mcp-server

A Model Context Protocol (MCP) server that provides browser automation capabilities using Browserbase.

agentify

5.0

TextFormatter MCP Server

agentify/textformatter-mcp-server

A Model Context Protocol (MCP) server providing advanced text transformation, formatting, and analysis tools for AI workflows and automation.

agentify

Tester MCP Client

jiri.spilka/tester-mcp-client

A model context protocol (MCP) client that connects to any MCP server using Streamable HTTP and displays the conversation in a chat-like UI. It is a standalone Actor server designed for testing MCP servers over Stremable HTTP.

Jiří Spilka

1.1K

5.0

Mcp Validator

rocketagro/mcp-validator

**MCP Validator** is a professional validation and compliance testing tool for [Model Context Protocol (MCP)](https://modelcontextprotocol.io) servers. It ensures your MCP server’s **tools, resources, prompts, and templates** are correct, compliant, and production-ready.