Playwright MCP

Amp VS Code 확장 설정 화면을 통해 또는 settings.json 파일을 업데이트하여 추가합니다:

"amp.mcpServers": {
  "playwright": {
    "command": "npx",
    "args": [
      "@playwright/mcp@latest"
    ]
  }
}

Amp CLI 설정:

아래 amp mcp add 명령을 통해 추가합니다.

amp mcp add playwright -- npx @playwright/mcp@latest

Antigravity 설정을 통해 또는 구성 파일을 업데이트하여 추가합니다:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Claude Code CLI를 사용하여 Playwright MCP 서버를 추가합니다:

claude mcp add playwright npx @playwright/mcp@latest

MCP 설치 가이드를 따르고 위의 표준 구성을 사용합니다.

MCP 서버 구성 섹션의 지침을 따릅니다.

예: 로컬 설정

cline_mcp_settings.json 파일에 다음을 추가합니다:

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ],
      "disabled": false
    }
  }
}

Codex CLI를 사용하여 Playwright MCP 서버를 추가합니다:

codex mcp add playwright npx "@playwright/mcp@latest"

또는 구성 파일 ~/.codex/config.toml을(를) 만들거나 편집하고 다음을 추가합니다:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

자세한 내용은 Codex MCP 문서를 참조하세요.

Copilot CLI를 사용하여 대화형으로 Playwright MCP 서버를 추가합니다:

/mcp add

또는 구성 파일 ~/.copilot/mcp-config.json을(를) 만들거나 편집하고 다음을 추가합니다:

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

자세한 내용은 Copilot CLI 문서를 참조하세요.

버튼을 클릭하여 설치:

또는 수동으로 설치:

Cursor Settings -> MCP -> Add new MCP Server로 이동합니다. 원하는 이름을 지정하고 command 유형과 npx @playwright/mcp@latest 명령을 사용합니다. Edit을(를) 클릭하여 구성을 확인하거나 인수와 같은 명령을 추가할 수도 있습니다.

Factory CLI를 사용하여 Playwright MCP 서버를 추가합니다:

droid mcp add playwright "npx @playwright/mcp@latest"

또는 Factory droid 내에서 /mcp을(를) 입력하여 MCP 서버 관리를 위한 대화형 UI를 엽니다.

자세한 내용은 Factory MCP 문서를 참조하세요.

MCP 설치 가이드를 따르고 위의 표준 구성을 사용합니다.

버튼을 클릭하여 설치:

또는 수동으로 설치:

Advanced settings -> Extensions -> Add custom extension로 이동합니다. 원하는 이름을 지정하고 STDIO 유형을 사용하며 command을(를) npx @playwright/mcp(으)로 설정합니다. "확장 프로그램 추가"를 클릭합니다.

Grok CLI를 사용하여 Playwright MCP 서버를 추가합니다:

grok mcp add playwright -- npx @playwright/mcp@latest

또는 구성 파일 ~/.grok/config.toml을(를) 만들거나 편집하고 다음을 추가합니다:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

자세한 내용은 Grok MCP 문서를 참조하세요.

Junie CLI에서 Playwright MCP 서버를 추가하려면:

1. /mcp 입력
2. Ctrl+A을(를) 눌러 새 MCP 서버 추가
3. 목록에서 Playwright 선택

또는 .junie/mcp/mcp.json에 추가:

{
  "mcpServers": {
    "Playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ]
    }
  }
}

자세한 내용은 Junie MCP 구성 문서를 참조하세요.

MCP 서버 문서를 따릅니다. 예를 들어 .kiro/settings/mcp.json에서:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

버튼을 클릭하여 설치:

또는 수동으로 설치:

오른쪽 사이드바의 Program -> Install -> Edit mcp.json로 이동합니다. 위의 표준 구성을 사용합니다.

MCP 서버 문서를 따릅니다. 예를 들어 ~/.config/opencode/opencode.json에서:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright": {
      "type": "local",
      "command": [
        "npx",
        "@playwright/mcp@latest"
      ],
      "enabled": true
    }
  }
}

VSCode 또는 IntelliJ에서 Qodo Gen 채팅 패널 열기 → 추가 도구 연결 → + 새 MCP 추가 → 위의 표준 구성을 붙여넣습니다.

저장을 클릭합니다.

버튼을 클릭하여 설치:

또는 수동으로 설치:

MCP 설치 가이드를 따르고 위의 표준 구성을 사용합니다. VS Code CLI를 사용하여 Playwright MCP 서버를 설치할 수도 있습니다:

# For VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

설치 후 VS Code에서 GitHub Copilot 에이전트와 함께 Playwright MCP 서버를 사용할 수 있습니다.

Settings -> AI -> Manage MCP Servers -> + Add로 이동하여 MCP 서버 추가합니다. 위의 표준 구성을 사용합니다.

또는 Warp 프롬프트에서 슬래시 명령 /add-mcp을(를) 사용하고 위의 표준 구성을 붙여넣습니다:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Windsurf MCP 문서를 따릅니다. 위의 표준 구성을 사용합니다.

{
  /**
   * The browser to use.
   */
  browser?: {
    /**
     * The type of browser to use.
     */
    browserName?: 'chromium' | 'firefox' | 'webkit';

    /**
     * Keep the browser profile in memory, do not save it to disk.
     */
    isolated?: boolean;

    /**
     * Path to a user data directory for browser profile persistence.
     * Temporary directory is created by default.
     */
    userDataDir?: string;

    /**
     * Launch options passed to
     * @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context
     *
     * This is useful for settings options like `channel`, `headless`, `executablePath`, etc.
     */
    launchOptions?: playwright.LaunchOptions;

    /**
     * Context options for the browser context.
     *
     * This is useful for settings options like `viewport`.
     */
    contextOptions?: playwright.BrowserContextOptions;

    /**
     * Chrome DevTools Protocol endpoint to connect to an existing browser instance in case of Chromium family browsers.
     */
    cdpEndpoint?: string;

    /**
     * CDP headers to send with the connect request.
     */
    cdpHeaders?: Record<string, string>;

    /**
     * Timeout in milliseconds for connecting to CDP endpoint. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
     */
    cdpTimeout?: number;

    /**
     * Remote endpoint to connect to an existing Playwright server. May be a
     * WebSocket URL string, or a [ConnectOptions] object that mirrors the
     * `connectOptions` shape used by the test runner. When passed as an object,
     * `exposeNetwork`, `headers`, `slowMo`, and `timeout` are forwarded to the
     * underlying connect call.
     */
    remoteEndpoint?: string | playwright.ConnectOptions & { endpoint: string };

    /**
     * Paths to TypeScript files to add as initialization scripts for Playwright page.
     */
    initPage?: string[];

    /**
     * Paths to JavaScript files to add as initialization scripts.
     * The scripts will be evaluated in every page before any of the page's scripts.
     */
    initScript?: string[];
  },

  /**
   * Connect to a running browser instance (Edge/Chrome only). If specified, `browser`
   * config is ignored.
   * Requires the "Playwright Extension" to be installed.
   */
  extension?: boolean;

  server?: {
    /**
     * The port to listen on for SSE or MCP transport.
     */
    port?: number;

    /**
     * The host to bind the server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.
     */
    host?: string;

    /**
     * The hosts this server is allowed to serve from. Defaults to the host server is bound to.
     * This is not for CORS, but rather for the DNS rebinding protection.
     */
    allowedHosts?: string[];
  },

  /**
   * List of enabled tool capabilities. Possible values:
   *   - 'core': Core browser automation features.
   *   - 'pdf': PDF generation and manipulation.
   *   - 'vision': Coordinate-based interactions.
   *   - 'devtools': Developer tools features.
   */
  capabilities?: ToolCapability[];

  /**
   * Whether to save the Playwright session into the output directory.
   */
  saveSession?: boolean;

  /**
   * Reuse the same browser context between all connected HTTP clients.
   */
  sharedBrowserContext?: boolean;

  /**
   * Secrets are used to replace matching plain text in the tool responses to prevent the LLM
   * from accidentally getting sensitive data. It is a convenience and not a security feature,
   * make sure to always examine information coming in and from the tool on the client.
   */
  secrets?: Record<string, string>;

  /**
   * The directory to save output files.
   */
  outputDir?: string;

  /**
   * Threshold for evicting old output files, in bytes.
   */
  outputMaxSize?: number;

  console?: {
    /**
     * The level of console messages to return. Each level includes the messages of more severe levels. Defaults to "info".
     */
    level?: 'error' | 'warning' | 'info' | 'debug';
  },

  network?: {
    /**
     * List of origins to allow the browser to request. Default is to allow all. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    allowedOrigins?: string[];

    /**
     * List of origins to block the browser to request. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    blockedOrigins?: string[];
  };

  /**
   * Specify the attribute to use for test ids, defaults to "data-testid".
   */
  testIdAttribute?: string;

  timeouts?: {
    /*
     * Configures default action timeout: https://playwright.dev/docs/api/class-page#page-set-default-timeout. Defaults to 5000ms.
     */
    action?: number;

    /*
     * Configures default navigation timeout: https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout. Defaults to 60000ms.
     */
    navigation?: number;

    /**
     * Configures default expect timeout: https://playwright.dev/docs/test-timeouts#expect-timeout. Defaults to 5000ms.
     */
    expect?: number;
  };

  /**
   * Whether to send image responses to the client. Can be "allow", "omit", or "auto". Defaults to "auto", which sends images if the client can display them.
   */
  imageResponses?: 'allow' | 'omit';

  snapshot?: {
    /**
     * When taking snapshots for responses, specifies the mode to use.
     */
    mode?: 'full' | 'none';
  };

  /**
   * allowUnrestrictedFileAccess acts as a guardrail to prevent the LLM from accidentally
   * wandering outside its intended workspace. It is a convenience defense to catch unintended
   * file access, not a secure boundary; a deliberate attempt to reach other directories can be
   * easily worked around, so always rely on client-level permissions for true security.
   */
  allowUnrestrictedFileAccess?: boolean;

  /**
   * Specify the language to use for code generation.
   */
  codegen?: 'typescript' | 'none';
}

참고: Docker 구현은 현재 헤드리스 chromium만 지원합니다.

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}

또는 MCP 클라이언트가 컨테이너를 생성하도록 하는 대신 장기 실행 서비스로 컨테이너를 실행하려면 다음을 사용하세요.

docker run -d -i --rm --init --pull=always \
  --entrypoint node \
  --name playwright \
  -p 8931:8931 \
  mcr.microsoft.com/playwright/mcp \
  /app/cli.js --headless --browser chromium --no-sandbox --port 8931 --host 0.0.0.0

서버는 호스트 포트 8931에서 수신 대기하며 모든 MCP 클라이언트에서 연결할 수 있습니다.

Docker 이미지를 직접 빌드할 수 있습니다.

docker build -t mcr.microsoft.com/playwright/mcp .

import http from 'http';

import { createConnection } from '@playwright/mcp';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

http.createServer(async (req, res) => {
  // ...

  // Creates a headless Playwright MCP server with SSE transport
  const connection = await createConnection({ browser: { launchOptions: { headless: true } } });
  const transport = new SSEServerTransport('/messages', res);
  await connection.connect(transport);

  // ...
});

• 제목: 클릭
• 설명: 웹 페이지에서 클릭을 수행합니다
• 매개변수:
  • element (문자열, 선택 사항): 요소와 상호 작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
  • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • doubleClick (불리언, 선택 사항): 단일 클릭 대신 더블 클릭을 수행할지 여부
  • button (문자열, 선택 사항): 클릭할 버튼, 기본값은 왼쪽
  • modifiers (배열, 선택 사항): 누를 보조 키
• 읽기 전용: false

• browser_close
  • 제목: 브라우저 닫기
  • 설명: 페이지를 닫습니다
  • 매개변수: 없음
  • 읽기 전용: false

• browser_console_messages
  • 제목: 콘솔 메시지 가져오기
  • 설명: 모든 콘솔 메시지를 반환합니다
  • 매개변수:
    • level (문자열): 반환할 콘솔 메시지의 레벨입니다. 각 레벨에는 더 심각한 레벨의 메시지가 포함됩니다. 기본값은 "info"입니다.
    • all (불리언, 선택 사항): 마지막 탐색 이후뿐만 아니라 세션 시작 이후의 모든 콘솔 메시지를 반환합니다. 기본값은 false입니다.
    • filename (문자열, 선택 사항): 콘솔 메시지를 저장할 파일 이름입니다. 제공되지 않으면 메시지가 텍스트로 반환됩니다.
  • 읽기 전용: true

• browser_drag
  • 제목: 마우스 드래그
  • 설명: 두 요소 간에 드래그 앤 드롭을 수행합니다
  • 매개변수:
    • startElement (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 소스 요소 설명
    • startTarget (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • endElement (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 대상 요소 설명
    • endTarget (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • 읽기 전용: false

• browser_drop
  • 제목: 요소에 파일 또는 데이터 드롭
  • 설명: 페이지 외부에서 드래그한 것처럼 요소에 파일 또는 MIME 유형 데이터를 드롭합니다. "paths" 또는 "data" 중 하나 이상을 제공해야 합니다.
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • paths (배열, 선택 사항): 요소에 드롭할 파일의 절대 경로입니다.
    • data (객체, 선택 사항): MIME 유형을 문자열 값에 매핑한 드롭할 데이터입니다 (예: {"text/plain": "hello", "text/uri-list": "https://example.com"}).
  • 읽기 전용: false

• browser_evaluate
  • 제목: JavaScript 평가
  • 설명: 페이지 또는 요소에서 JavaScript 표현식을 평가합니다
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열, 선택 사항): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • function (문자열): () => { /* code / } 또는 요소가 제공된 경우 (element) => { / code */ }
    • filename (문자열, 선택 사항): 결과를 저장할 파일 이름입니다. 제공되지 않으면 결과가 텍스트로 반환됩니다.
  • 읽기 전용: false

• browser_file_upload
  • 제목: 파일 업로드
  • 설명: 하나 이상의 파일을 업로드합니다
  • 매개변수:
    • paths (배열, 선택 사항): 업로드할 파일의 절대 경로입니다. 단일 파일 또는 여러 파일이 될 수 있습니다. 생략하면 파일 선택기가 취소됩니다.
  • 읽기 전용: false

• browser_fill_form
  • 제목: 양식 채우기
  • 설명: 여러 양식 필드를 채웁니다
  • 매개변수:
    • fields (배열): 채울 필드
  • 읽기 전용: false

• browser_find
  • 제목: 페이지 스냅샷에서 찾기
  • 설명: 현재 페이지의 접근성 스냅샷에서 텍스트 또는 정규 표현식을 검색합니다. 일치하는 스냅샷 노드를 주변 컨텍스트 몇 줄(검색 스니펫과 유사)과 함께 반환하며, 각각은 트리 루트로부터의 경로 아래에 표시됩니다. 이는 요소와 해당 참조를 찾기만 하면 될 때 전체 스냅샷을 캡처하는 것보다 저렴합니다.
  • 매개변수:
    • text (문자열, 선택 사항): 페이지 스냅샷에서 검색할 일반 텍스트입니다 (대소문자 구분 없는 부분 문자열 일치). 텍스트 또는 정규 표현식 중 하나만 제공해야 합니다.
    • regex (문자열, 선택 사항): 페이지 스냅샷에서 검색할 정규 표현식입니다. 기본적으로 대소문자를 구분합니다. 플래그를 추가하려면 패턴을 슬래시로 묶으십시오 (예: 대소문자 구분 없는 경우 "/error/i"). 텍스트 또는 정규 표현식 중 하나만 제공해야 합니다.
  • 읽기 전용: true

• browser_handle_dialog
  • 제목: 대화 상자 처리
  • 설명: 대화 상자를 처리합니다
  • 매개변수:
    • accept (불리언): 대화 상자를 수락할지 여부입니다.
    • promptText (문자열, 선택 사항): 프롬프트 대화 상자인 경우 프롬프트 텍스트입니다.
  • 읽기 전용: false

• browser_hover
  • 제목: 마우스 호버
  • 설명: 페이지의 요소 위에 마우스를 올립니다
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • 읽기 전용: false

• browser_navigate
  • 제목: URL로 이동
  • 설명: URL로 이동합니다
  • 매개변수:
    • url (문자열): 이동할 URL
  • 읽기 전용: false

• browser_navigate_back
  • 제목: 뒤로 가기
  • 설명: 히스토리에서 이전 페이지로 돌아갑니다
  • 매개변수: 없음
  • 읽기 전용: false

• browser_network_request
  • 제목: 네트워크 요청 세부 정보 표시
  • 설명: 단일 네트워크 요청의 전체 세부 정보(헤더 및 본문)를 반환하거나, part이 설정된 경우 단일 부분을 반환합니다. browser_network_requests의 번호를 사용하십시오.
  • 매개변수:
    • index (정수): browser_network_requests에 의해 출력된 요청의 1 기반 인덱스입니다.
    • part (문자열, 선택 사항): 요청의 이 부분만 반환합니다. 전체 세부 정보를 반환하려면 생략하십시오.
    • filename (문자열, 선택 사항): 결과를 저장할 파일 이름입니다. 제공되지 않으면 출력이 텍스트로 반환됩니다.
  • 읽기 전용: true

• browser_network_requests
  • 제목: 네트워크 요청 목록
  • 설명: 페이지 로드 이후의 네트워크 요청 번호 목록을 반환합니다. 전체 세부 정보를 얻으려면 번호와 함께 browser_network_request를 사용하십시오.
  • 매개변수:
    • static (불리언): 이미지, 글꼴, 스크립트 등과 같은 성공적인 정적 리소스를 포함할지 여부입니다. 기본값은 false입니다.
    • filter (문자열, 선택 사항): URL이 이 정규 표현식과 일치하는 요청만 반환합니다 (예: "/api/.*user").
    • filename (문자열, 선택 사항): 네트워크 요청을 저장할 파일 이름입니다. 제공되지 않으면 요청이 텍스트로 반환됩니다.
  • 읽기 전용: true

• browser_press_key
  • 제목: 키 누르기
  • 설명: 키보드의 키를 누릅니다
  • 매개변수:
    • key (문자열): 누를 키의 이름 또는 생성할 문자 (예: ArrowLeft 또는 a)
  • 읽기 전용: false

• browser_resize
  • 제목: 브라우저 창 크기 조정
  • 설명: 브라우저 창 크기를 조정합니다
  • 매개변수:
    • width (숫자): 브라우저 창의 너비
    • height (숫자): 브라우저 창의 높이
  • 읽기 전용: false

• browser_run_code_unsafe
  • 제목: Playwright 코드 실행 (안전하지 않음)
  • 설명: Playwright 코드 스니펫을 실행합니다. 안전하지 않음: Playwright 서버 프로세스에서 임의의 JavaScript를 실행하며 RCE와 동등합니다.
  • 매개변수:
    • code (문자열, 선택 사항): 실행할 Playwright 코드가 포함된 JavaScript 함수입니다. 페이지 상호 작용에 사용할 수 있는 단일 인수 page와 함께 호출됩니다. 예: async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (문자열, 선택 사항): 지정된 파일에서 코드를 로드합니다. 코드와 파일 이름이 모두 제공되면 코드는 무시됩니다.
  • 읽기 전용: false

• browser_select_option
  • 제목: 옵션 선택
  • 설명: 드롭다운에서 옵션을 선택합니다
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • values (배열): 드롭다운에서 선택할 값의 배열입니다. 단일 값 또는 여러 값이 될 수 있습니다.
  • 읽기 전용: false

• browser_snapshot
  • 제목: 페이지 스냅샷
  • 설명: 현재 페이지의 접근성 스냅샷을 캡처합니다. 스크린샷보다 낫습니다.
  • 매개변수:
    • target (문자열, 선택 사항): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • filename (문자열, 선택 사항): 응답으로 반환하는 대신 스냅샷을 마크다운 파일에 저장합니다.
    • depth (숫자, 선택 사항): 스냅샷 트리의 깊이를 제한합니다.
    • boxes (불리언, 선택 사항): 스냅샷에 각 요소의 경계 상자를 [box=x,y,width,height]로 포함합니다. 좌표는 뷰포트 기준이며 CSS 픽셀 단위입니다 (Element.getBoundingClientRect).
  • 읽기 전용: true

• browser_take_screenshot
  • 제목: 스크린샷 찍기
  • 설명: 현재 페이지의 스크린샷을 찍습니다. 스크린샷을 기반으로 작업을 수행할 수 없으므로 작업에는 browser_snapshot을 사용하십시오.
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열, 선택 사항): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • type (문자열): 스크린샷의 이미지 형식입니다. 기본값은 png입니다.
    • filename (문자열, 선택 사항): 스크린샷을 저장할 파일 이름입니다. 지정하지 않으면 기본값은 page-{timestamp}.{png|jpeg}입니다. 출력 디렉터리 내에 유지하려면 상대 파일 이름을 선호하십시오.
    • fullPage (불리언, 선택 사항): true인 경우 현재 보이는 뷰포트 대신 스크롤 가능한 전체 페이지의 스크린샷을 찍습니다. 요소 스크린샷과 함께 사용할 수 없습니다.
    • scale (문자열): 이미지 해상도 배율입니다. "css"는 CSS 픽셀 크기의 스크린샷을 생성합니다 (더 작고 기기 간 일관됨). "device"는 기기 픽셀을 사용하는 고해상도 스크린샷을 생성합니다 (더 크고 기기 픽셀 비율을 고려함). 기본값은 css입니다.
  • 읽기 전용: true

• browser_type
  • 제목: 텍스트 입력
  • 설명: 편집 가능한 요소에 텍스트를 입력합니다
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • text (문자열): 요소에 입력할 텍스트
    • submit (불리언, 선택 사항): 입력된 텍스트를 제출할지 여부입니다 (이후 Enter 키 누름).
    • slowly (불리언, 선택 사항): 한 번에 한 문자씩 입력할지 여부입니다. 페이지에서 키 핸들러를 트리거하는 데 유용합니다. 기본적으로 전체 텍스트가 한 번에 채워집니다.
  • 읽기 전용: false

• browser_wait_for
  • 제목: 대기
  • 설명: 텍스트가 나타나거나 사라질 때까지 또는 지정된 시간이 경과할 때까지 대기합니다.
  • 매개변수:
    • time (숫자, 선택 사항): 대기할 시간(초)
    • text (문자열, 선택 사항): 나타날 때까지 대기할 텍스트
    • textGone (문자열, 선택 사항): 사라질 때까지 대기할 텍스트
  • 읽기 전용: false

• browser_tabs
  • 제목: 탭 관리
  • 설명: 브라우저 탭을 나열, 생성, 닫기 또는 선택합니다.
  • 매개변수:
    • action (문자열): 수행할 작업
    • index (숫자, 선택 사항): 탭 인덱스, 닫기/선택에 사용됩니다. 닫기 시 생략하면 현재 탭이 닫힙니다.
    • url (문자열, 선택 사항): 새 탭에서 이동할 URL, 새 탭 생성 시 사용됩니다.
  • 읽기 전용: false

• browser_get_config
  • 제목: 구성 가져오기
  • 설명: CLI 옵션, 환경 변수 및 구성 파일을 병합한 최종 해석된 구성을 가져옵니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_network_state_set
  • 제목: 네트워크 상태 설정
  • 설명: 브라우저 네트워크 상태를 온라인 또는 오프라인으로 설정합니다. 오프라인 시 모든 네트워크 요청이 실패합니다.
  • 매개변수:
    • state (문자열): 오프라인 모드를 시뮬레이션하려면 "offline", 네트워크 연결을 복원하려면 "online"으로 설정합니다.
  • 읽기 전용: false

• browser_route
  • 제목: 네트워크 요청 모의 처리
  • 설명: URL 패턴과 일치하는 네트워크 요청을 모의 처리하도록 경로를 설정합니다.
  • 매개변수:
    • pattern (문자열): 일치시킬 URL 패턴 (예: "/api/users", "/*.{png,jpg}")
    • status (숫자, 선택 사항): 반환할 HTTP 상태 코드 (기본값: 200)
    • body (문자열, 선택 사항): 응답 본문 (텍스트 또는 JSON 문자열)
    • contentType (문자열, 선택 사항): Content-Type 헤더 (예: "application/json", "text/html")
    • headers (배열, 선택 사항): "이름: 값" 형식으로 추가할 헤더
    • removeHeaders (문자열, 선택 사항): 요청에서 제거할 헤더 이름의 쉼표로 구분된 목록
  • 읽기 전용: false

• browser_route_list
  • 제목: 네트워크 경로 나열
  • 설명: 모든 활성 네트워크 경로를 나열합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_unroute
  • 제목: 네트워크 경로 제거
  • 설명: 패턴과 일치하는 네트워크 경로를 제거합니다 (패턴이 지정되지 않은 경우 모든 경로 제거).
  • 매개변수:
    • pattern (문자열, 선택 사항): 경로를 제거할 URL 패턴 (모든 경로를 제거하려면 생략)
  • 읽기 전용: false

• browser_cookie_clear
  • 제목: 쿠키 지우기
  • 설명: 모든 쿠키를 지웁니다.
  • 매개변수: 없음
  • 읽기 전용: false

• browser_cookie_delete
  • 제목: 쿠키 삭제
  • 설명: 특정 쿠키를 삭제합니다.
  • 매개변수:
    • name (문자열): 삭제할 쿠키 이름
  • 읽기 전용: false

• browser_cookie_get
  • 제목: 쿠키 가져오기
  • 설명: 이름으로 특정 쿠키를 가져옵니다.
  • 매개변수:
    • name (문자열): 가져올 쿠키 이름
  • 읽기 전용: true

• browser_cookie_list
  • 제목: 쿠키 나열
  • 설명: 모든 쿠키를 나열합니다 (선택적으로 도메인/경로로 필터링).
  • 매개변수:
    • domain (문자열, 선택 사항): 도메인으로 쿠키 필터링
    • path (문자열, 선택 사항): 경로로 쿠키 필터링
  • 읽기 전용: true

• browser_cookie_set
  • 제목: 쿠키 설정
  • 설명: 선택적 플래그(domain, path, expires, httpOnly, secure, sameSite)와 함께 쿠키를 설정합니다.
  • 매개변수:
    • name (문자열): 쿠키 이름
    • value (문자열): 쿠키 값
    • domain (문자열, 선택 사항): 쿠키 도메인
    • path (문자열, 선택 사항): 쿠키 경로
    • expires (숫자, 선택 사항): Unix 타임스탬프로 나타낸 쿠키 만료 시간
    • httpOnly (부울, 선택 사항): 쿠키의 HTTP 전용 여부
    • secure (부울, 선택 사항): 쿠키의 보안 여부
    • sameSite (문자열, 선택 사항): 쿠키 SameSite 속성
  • 읽기 전용: false

• browser_localstorage_clear
  • 제목: localStorage 지우기
  • 설명: 모든 localStorage를 지웁니다.
  • 매개변수: 없음
  • 읽기 전용: false

• browser_localstorage_delete
  • 제목: localStorage 항목 삭제
  • 설명: localStorage 항목을 삭제합니다.
  • 매개변수:
    • key (문자열): 삭제할 키
  • 읽기 전용: false

• browser_localstorage_get
  • 제목: localStorage 항목 가져오기
  • 설명: 키로 localStorage 항목을 가져옵니다.
  • 매개변수:
    • key (문자열): 가져올 키
  • 읽기 전용: true

• browser_localstorage_list
  • 제목: localStorage 나열
  • 설명: 모든 localStorage 키-값 쌍을 나열합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_localstorage_set
  • 제목: localStorage 항목 설정
  • 설명: localStorage 항목을 설정합니다.
  • 매개변수:
    • key (문자열): 설정할 키
    • value (문자열): 설정할 값
  • 읽기 전용: false

• browser_sessionstorage_clear
  • 제목: sessionStorage 지우기
  • 설명: 모든 sessionStorage를 지웁니다.
  • 매개변수: 없음
  • 읽기 전용: false

• browser_sessionstorage_delete
  • 제목: sessionStorage 항목 삭제
  • 설명: sessionStorage 항목을 삭제합니다.
  • 매개변수:
    • key (문자열): 삭제할 키
  • 읽기 전용: false

• browser_sessionstorage_get
  • 제목: sessionStorage 항목 가져오기
  • 설명: 키로 sessionStorage 항목을 가져옵니다.
  • 매개변수:
    • key (문자열): 가져올 키
  • 읽기 전용: true

• browser_sessionstorage_list
  • 제목: sessionStorage 나열
  • 설명: 모든 sessionStorage 키-값 쌍을 나열합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_sessionstorage_set
  • 제목: sessionStorage 항목 설정
  • 설명: sessionStorage 항목을 설정합니다.
  • 매개변수:
    • key (문자열): 설정할 키
    • value (문자열): 설정할 값
  • 읽기 전용: false

• browser_set_storage_state
  • 제목: 저장소 상태 복원
  • 설명: 파일에서 저장소 상태(쿠키, 로컬 저장소)를 복원합니다. 복원 전에 기존 쿠키와 로컬 저장소를 지웁니다.
  • 매개변수:
    • filename (문자열): 복원할 저장소 상태 파일의 경로
  • 읽기 전용: false

• browser_storage_state
  • 제목: 저장소 상태 저장
  • 설명: 나중에 재사용할 수 있도록 저장소 상태(쿠키, 로컬 저장소)를 파일에 저장합니다.
  • 매개변수:
    • filename (문자열, 선택 사항): 저장소 상태를 저장할 파일 이름. 지정하지 않으면 기본값은 storage-state-{timestamp}.json입니다.
  • 읽기 전용: true

• browser_annotate
  • 제목: 현재 페이지에 주석 달기
  • 설명: 현재 페이지에 대해 주석 모드로 Playwright Dashboard를 열고 사용자가 주석을 그릴 때까지 기다립니다. 주석이 달린 스크린샷, ARIA 스냅샷 및 주석 목록을 반환합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_hide_highlight
  • 제목: 요소 강조 표시 숨기기
  • 설명: 이전에 요소에 추가된 강조 표시 오버레이를 제거합니다.
  • 매개변수:
    • element (문자열, 선택 사항): 강조 표시를 추가할 때 사용된 사람이 읽을 수 있는 요소 설명; browser_highlight에 전달된 값과 일치해야 합니다.
    • target (문자열, 선택 사항): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • 읽기 전용: true

• browser_highlight
  • 제목: 요소 강조 표시
  • 설명: 페이지의 요소 주위에 지속적인 강조 표시 오버레이를 표시합니다.
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • style (문자열, 선택 사항): 강조 표시 오버레이에 적용되는 추가 인라인 CSS (예: "outline: 2px dashed red").
  • 읽기 전용: true

• browser_resume
  • 제목: 일시 중지된 스크립트 실행 재개
  • 설명: 일시 중지된 후 스크립트 실행을 재개합니다. step이 true로 설정된 상태로 호출되면 다음 작업 전에 실행이 다시 일시 중지됩니다.
  • 매개변수:
    • step (부울, 선택 사항): true인 경우 다음 작업 전에 실행이 다시 일시 중지되어 단계별 디버깅이 가능합니다.
    • location (문자열, 선택 사항): 특정 :에서 실행을 일시 중지합니다 (예: "example.spec.ts:42").
  • 읽기 전용: false

• browser_start_tracing
  • 제목: 추적 시작
  • 설명: 추적 기록을 시작합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_start_video
  • 제목: 비디오 시작
  • 설명: 비디오 녹화를 시작합니다.
  • 매개변수:
    • filename (문자열, 선택 사항): 비디오를 저장할 파일 이름.
    • size (객체, 선택 사항): 비디오 크기
  • 읽기 전용: true

• browser_stop_tracing
  • 제목: 추적 중지
  • 설명: 추적 기록을 중지합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_stop_video
  • 제목: 비디오 중지
  • 설명: 비디오 녹화를 중지합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_video_chapter
  • 제목: 비디오 챕터
  • 설명: 비디오 녹화에 챕터 마커를 추가합니다. 흐린 배경의 전체 화면 챕터 카드를 표시합니다.
  • 매개변수:
    • title (문자열): 챕터 제목
    • description (문자열, 선택 사항): 챕터 설명
    • duration (숫자, 선택 사항): 챕터 카드를 표시할 시간(밀리초)
  • 읽기 전용: true

• browser_video_hide_actions
  • 제목: 작업 오버레이 숨기기
  • 설명: 페이지에서 수행된 작업에 대한 주석 달기를 중지합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_video_show_actions
  • 제목: 작업 오버레이 표시
  • 설명: 작업 이름을 지정하고 대상 요소를 강조 표시하는 설명선으로 페이지에서 수행되는 후속 작업에 주석을 답니다. 비디오 녹화 또는 화면 캐스팅 시 유용합니다.
  • 매개변수:
    • duration (숫자, 선택 사항): 각 작업 주석이 화면에 유지되는 시간(밀리초). 기본값은 500입니다.
    • position (문자열, 선택 사항): 페이지를 기준으로 작업 제목을 배치할 위치. 기본값은 top-right입니다.
    • cursor (문자열, 선택 사항): 포인터 작업을 위한 커서 장식. "pointer"(기본값)는 이전 작업 지점에서 다음 작업 지점으로 마우스 포인터를 애니메이션으로 표시합니다. "none"은 커서 장식을 비활성화합니다.
  • 읽기 전용: true

• browser_mouse_click_xy
  • 제목: 클릭
  • 설명: 지정된 위치에서 마우스 버튼 클릭
  • 매개변수:
    • x (숫자): X 좌표
    • y (숫자): Y 좌표
    • button (문자열, 선택 사항): 클릭할 버튼, 기본값은 왼쪽
    • clickCount (숫자, 선택 사항): 클릭 횟수, 기본값은 1
    • delay (숫자, 선택 사항): 마우스 누름과 뗌 사이의 대기 시간(밀리초), 기본값은 0
  • 읽기 전용: false

• browser_mouse_down
  • 제목: 마우스 누름
  • 설명: 마우스 버튼 누름
  • 매개변수:
    • button (문자열, 선택 사항): 누를 버튼, 기본값은 왼쪽
  • 읽기 전용: false

• browser_mouse_drag_xy
  • 제목: 마우스 드래그
  • 설명: 왼쪽 마우스 버튼을 지정된 위치로 드래그
  • 매개변수:
    • startX (숫자): 시작 X 좌표
    • startY (숫자): 시작 Y 좌표
    • endX (숫자): 끝 X 좌표
    • endY (숫자): 끝 Y 좌표
  • 읽기 전용: false

• browser_mouse_move_xy
  • 제목: 마우스 이동
  • 설명: 마우스를 지정된 위치로 이동
  • 매개변수:
    • x (숫자): X 좌표
    • y (숫자): Y 좌표
  • 읽기 전용: false

• browser_mouse_up
  • 제목: 마우스 뗌
  • 설명: 마우스 버튼 뗌
  • 매개변수:
    • button (문자열, 선택 사항): 뗄 버튼, 기본값은 왼쪽
  • 읽기 전용: false

• browser_mouse_wheel
  • 제목: 마우스 휠 스크롤
  • 설명: 마우스 휠 스크롤
  • 매개변수:
    • deltaX (숫자): X 변화량
    • deltaY (숫자): Y 변화량
  • 읽기 전용: false

• browser_pdf_save
  • 제목: PDF로 저장
  • 설명: 페이지를 PDF로 저장
  • 매개변수:
    • filename (문자열, 선택 사항): PDF를 저장할 파일 이름. 지정하지 않으면 기본값은 page-{timestamp}.pdf입니다. 출력 디렉터리 내에 유지하려면 상대 파일 이름을 사용하는 것이 좋습니다.
  • 읽기 전용: true

• browser_generate_locator
  • 제목: 요소 로케이터 생성
  • 설명: 테스트에 사용할 주어진 요소에 대한 로케이터 생성
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • 읽기 전용: true

• browser_verify_element_visible
  • 제목: 요소 표시 확인
  • 설명: 페이지에 요소가 표시되는지 확인
  • 매개변수:
    • role (문자열): 요소의 ROLE. 스냅샷에서 다음과 같이 찾을 수 있습니다: - {ROLE} "Accessible Name":
    • accessibleName (문자열): 요소의 ACCESSIBLE_NAME. 스냅샷에서 다음과 같이 찾을 수 있습니다: - role "{ACCESSIBLE_NAME}"
  • 읽기 전용: false

• browser_verify_list_visible
  • 제목: 목록 표시 확인
  • 설명: 페이지에 목록이 표시되는지 확인
  • 매개변수:
    • element (문자열): 사람이 읽을 수 있는 목록 설명
    • target (문자열): 목록을 가리키는 정확한 대상 요소 참조
    • items (배열): 확인할 항목
  • 읽기 전용: false

• browser_verify_text_visible
  • 제목: 텍스트 표시 확인
  • 설명: 페이지에 텍스트가 표시되는지 확인. 가능하면 browser_verify_element_visible을 사용하는 것이 좋습니다.
  • 매개변수:
    • text (문자열): 확인할 TEXT. 스냅샷에서 다음과 같이 찾을 수 있습니다: - role "Accessible Name": {TEXT} 또는 다음과 같이: - text: {TEXT}
  • 읽기 전용: false

• browser_verify_value
  • 제목: 값 확인
  • 설명: 요소 값 확인
  • 매개변수:
    • type (문자열): 요소의 유형
    • element (문자열): 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조
    • value (문자열): 확인할 값. 체크박스의 경우 "true" 또는 "false"를 사용합니다.
  • 읽기 전용: false