Playwright MCP

Amp VS Code uzantısı ayarlar ekranından veya settings.json dosyanızı güncelleyerek ekleyin:

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

Amp CLI Kurulumu:

Aşağıdaki amp mcp add komutuyla ekleyin

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

Antigravity ayarlarından veya yapılandırma dosyanızı güncelleyerek ekleyin:

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

Playwright MCP sunucusunu eklemek için Claude Code CLI'yı kullanın:

claude mcp add playwright npx @playwright/mcp@latest

MCP kurulum kılavuzunu izleyin, yukarıdaki standart yapılandırmayı kullanın.

MCP Sunucularını Yapılandırma bölümündeki talimatları izleyin

Örnek: Yerel Kurulum

cline_mcp_settings.json dosyanıza aşağıdakileri ekleyin:

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

Playwright MCP sunucusunu eklemek için Codex CLI'yı kullanın:

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

Alternatif olarak, ~/.codex/config.toml yapılandırma dosyasını oluşturun veya düzenleyin ve şunu ekleyin:

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

Daha fazla bilgi için Codex MCP belgelerine bakın.

Playwright MCP sunucusunu etkileşimli olarak eklemek için Copilot CLI'yı kullanın:

/mcp add

Alternatif olarak, ~/.copilot/mcp-config.json yapılandırma dosyasını oluşturun veya düzenleyin ve şunu ekleyin:

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

Daha fazla bilgi için Copilot CLI belgelerine bakın.

Kurulum için düğmeye tıklayın:

Veya manuel olarak kurun:

Cursor Settings -> MCP -> Add new MCP Server bölümüne gidin. İstediğiniz gibi adlandırın, command türünü npx @playwright/mcp@latest komutuyla kullanın. Ayrıca Edit seçeneğine tıklayarak yapılandırmayı doğrulayabilir veya komut gibi bağımsız değişkenler ekleyebilirsiniz.

Playwright MCP sunucusunu eklemek için Factory CLI'yı kullanın:

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

Alternatif olarak, MCP sunucularını yönetmek için etkileşimli bir arayüz açmak üzere Factory droid içinde /mcp yazın.

Daha fazla bilgi için Factory MCP belgelerine bakın.

MCP kurulum kılavuzunu izleyin, yukarıdaki standart yapılandırmayı kullanın.

Kurulum için düğmeye tıklayın:

Veya manuel olarak kurun:

Advanced settings -> Extensions -> Add custom extension bölümüne gidin. İstediğiniz gibi adlandırın, STDIO türünü kullanın ve command değerini npx @playwright/mcp olarak ayarlayın. "Add Extension" seçeneğine tıklayın.

Playwright MCP sunucusunu eklemek için Grok CLI'yı kullanın:

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

Alternatif olarak, ~/.grok/config.toml yapılandırma dosyasını oluşturun veya düzenleyin ve şunu ekleyin:

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

Daha fazla bilgi için Grok MCP belgelerine bakın.

Junie CLI'da Playwright MCP sunucusunu eklemek için:

1. /mcp yazın
2. Yeni bir MCP sunucusu eklemek için Ctrl+A tuşuna basın
3. Listeden Playwright seçeneğini seçin

Alternatif olarak, .junie/mcp/mcp.json dosyasına ekleyin:

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

Daha fazla bilgi için Junie MCP yapılandırma belgelerine bakın.

MCP Sunucuları belgelerini izleyin. Örneğin .kiro/settings/mcp.json içinde:

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

Kurulum için düğmeye tıklayın:

Veya manuel olarak kurun:

Sağ kenar çubuğundaki Program bölümüne gidin -> Install -> Edit mcp.json. Yukarıdaki standart yapılandırmayı kullanın.

MCP Sunucuları belgelerini izleyin. Örneğin ~/.config/opencode/opencode.json içinde:

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

VSCode veya IntelliJ'de Qodo Gen sohbet panelini açın → Connect more tools → + Add new MCP → Yukarıdaki standart yapılandırmayı yapıştırın.

Save seçeneğine tıklayın.

Kurulum için düğmeye tıklayın:

Veya manuel olarak kurun:

MCP kurulum kılavuzunu izleyin, yukarıdaki standart yapılandırmayı kullanın. Ayrıca Playwright MCP sunucusunu VS Code CLI kullanarak da kurabilirsiniz:

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

Kurulumdan sonra Playwright MCP sunucusu, VS Code'da GitHub Copilot aracınızla kullanılabilir olacaktır.

MCP Sunucusu eklemek için Settings -> AI -> Manage MCP Servers -> + Add bölümüne gidin. Yukarıdaki standart yapılandırmayı kullanın.

Alternatif olarak, Warp isteminde /add-mcp eğik çizgi komutunu kullanın ve yukarıdaki standart yapılandırmayı yapıştırın:

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

Windsurf MCP belgelerini izleyin. Yukarıdaki standart yapılandırmayı kullanın.

{
  /**
   * 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;

  /**
   * Whether to collect and expose the tools that a page registers through the
   * experimental WebMCP API. Enabled by default.
   */
  webmcp?: 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 for automatically named output files, for example a screenshot taken without an
   * explicit file name. Files with an explicit name are resolved against the workspace root instead
   * and are not affected by this option.
   */
  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;

    /**
     * How long to wait after each action for triggered work (navigations, requests) to settle before responding. Defaults to 500ms.
     */
    settle?: number;

    /**
     * Close the browser after this many milliseconds without a tool call, and relaunch it on the next one.
     * Defaults to one hour for headless browsers Playwright launched, and to no timeout for headed or attached ones. Pass 0 to disable.
     * The CLI shuts the whole session down instead of relaunching.
     */
    idle?: number;
  };

  /**
   * Whether to send image responses to the client. Can be "allow", "omit", or "only". Defaults to "allow".
   * With "only", a response that carries an image consists of the image parts alone, without the text part.
   */
  imageResponses?: 'allow' | 'omit' | 'only';

  /**
   * How file paths are rendered in tool results. Can be "relative" to the workspace root or "absolute". Defaults to "relative".
   */
  filePaths?: 'relative' | 'absolute';

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

    /**
     * Whether to include each element's bounding box as [box=x,y,width,height] in snapshots.
     * Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect).
     */
    boxes?: boolean;
  };

  /**
   * 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' | 'python' | 'java' | 'csharp' | 'none';
}

NOT: Docker uygulaması şu anda yalnızca başsız chromium'u desteklemektedir.

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

Veya MCP istemcisinin onu başlatmasına izin vermek yerine konteyneri uzun ömürlü bir hizmet olarak çalıştırmayı tercih ederseniz, şunu kullanın:

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

Sunucu, ana bilgisayar portu 8931 üzerinde dinler ve herhangi bir MCP istemcisi tarafından erişilebilir.

Docker imajını kendiniz de oluşturabilirsiniz.

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);

  // ...
});

• browser_click
  • Başlık: Tıkla
  • Açıklama: Bir web sayfasında tıklama gerçekleştirir
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • doubleClick (boolean, isteğe bağlı): Tek tıklama yerine çift tıklama yapılıp yapılmayacağı
    • button (string, isteğe bağlı): Tıklanacak düğme, varsayılan olarak sol
    • modifiers (array, isteğe bağlı): Basılacak değiştirici tuşlar
  • Salt okunur: false

• browser_close
  • Başlık: Tarayıcıyı kapat
  • Açıklama: Sayfayı kapatır
  • Parametreler: Yok
  • Salt okunur: false

• browser_console_messages
  • Başlık: Konsol mesajlarını al
  • Açıklama: Tüm konsol mesajlarını döndürür
  • Parametreler:
    • level (string): Döndürülecek konsol mesajlarının düzeyi. Her düzey, daha şiddetli düzeylerin mesajlarını içerir. Varsayılan "info"dur.
    • all (boolean, isteğe bağlı): Yalnızca son gezinmeden bu yana değil, oturumun başlangıcından bu yana tüm konsol mesajlarını döndürür. Varsayılan false'tur.
    • filename (string, isteğe bağlı): Konsol mesajlarının kaydedileceği dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Sağlanmazsa, mesajlar metin olarak döndürülür.
  • Salt okunur: true

• browser_drag
  • Başlık: Fareyi sürükle
  • Açıklama: İki öğe arasında sürükle ve bırak gerçekleştirir
  • Parametreler:
    • startElement (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir kaynak öğe açıklaması
    • startTarget (string): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • endElement (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir hedef öğe açıklaması
    • endTarget (string): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: false

• browser_drop
  • Başlık: Dosyaları veya verileri bir öğeye bırak
  • Açıklama: Sayfa dışından sürüklenmiş gibi dosyaları veya MIME türünde verileri bir öğeye bırakır. "paths" veya "data" alanlarından en az biri sağlanmalıdır.
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • paths (array, isteğe bağlı): Öğeye bırakılacak dosyaların mutlak yolları.
    • data (object, isteğe bağlı): Bırakılacak veriler, MIME türünün dize değerine eşlendiği bir harita olarak (ör. {"text/plain": "hello", "text/uri-list": "https://example.com"}).
  • Salt okunur: false

• browser_emulate_media
  • Başlık: Medya özelliklerini öykün
  • Açıklama: Sayfa için CSS medya özelliklerini öykünür, örneğin açık ve koyu renk düzeni arasında geçiş yapar. Atlanan parametreler değiştirilmeden bırakılır; null bir geçersiz kılmayı temizler.
  • Parametreler:
    • colorScheme (isteğe bağlı): prefers-color-scheme medya özelliğini öykünür
    • reducedMotion (isteğe bağlı): prefers-reduced-motion medya özelliğini öykünür
    • forcedColors (isteğe bağlı): forced-colors medya özelliğini öykünür
    • contrast (isteğe bağlı): prefers-contrast medya özelliğini öykünür
    • media (isteğe bağlı): Sayfanın CSS medya türünü değiştirir
  • Salt okunur: false

• browser_evaluate
  • Başlık: JavaScript'i değerlendir
  • Açıklama: Sayfada veya öğede JavaScript ifadesini değerlendirir
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string, isteğe bağlı): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • function (string): () => { /* kod / } veya öğe sağlandığında (element) => { / kod */ }
    • filename (string, isteğe bağlı): Sonucun kaydedileceği dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Sağlanmazsa, sonuç metin olarak döndürülür.
  • Salt okunur: false

• browser_file_upload
  • Başlık: Dosyaları yükle
  • Açıklama: Bir veya birden fazla dosyayı yükler
  • Parametreler:
    • paths (array, isteğe bağlı): Yüklenecek dosyaların mutlak yolları. Tek dosya veya birden fazla dosya olabilir. Atlanırsa, dosya seçici iptal edilir.
  • Salt okunur: false

• browser_fill_form
  • Başlık: Formu doldur
  • Açıklama: Birden fazla form alanını doldurur
  • Parametreler:
    • fields (array): Doldurulacak alanlar
  • Salt okunur: false

• browser_find
  • Başlık: Sayfa anlık görüntüsünde bul
  • Açıklama: Geçerli sayfanın erişilebilirlik anlık görüntüsünde metin veya normal ifade arar. Her biri ağacın kökünden kendi yolu altında gösterilen, birkaç satır çevreleyen bağlamla (arama parçacıkları gibi) eşleşen anlık görüntü düğümlerini döndürür; bu, yalnızca bir öğeyi ve referansını bulmanız gerektiğinde tüm anlık görüntüyü yakalamaktan daha ucuzdur.
  • Parametreler:
    • text (string, isteğe bağlı): Sayfa anlık görüntüsünde aranacak düz metin (büyük/küçük harf duyarsız alt dize eşleşmesi). Yalnızca metin veya normal ifade sağlayın, ikisini birden değil.
    • regex (string, isteğe bağlı): Sayfa anlık görüntüsünde aranacak normal ifade. Eşleştirme varsayılan olarak büyük/küçük harf duyarlıdır; bayrak eklemek için deseni eğik çizgilere sarın, ör. büyük/küçük harf duyarsız için "/error/i". Yalnızca metin veya normal ifade sağlayın, ikisini birden değil.
    • filename (string, isteğe bağlı): Sonuçları yanıtta döndürmek yerine bir dosyaya kaydedin. Göreli dosya adları çalışma alanı köküne göre çözümlenir.
  • Salt okunur: true

• browser_handle_dialog
  • Başlık: Bir iletişim kutusunu işle
  • Açıklama: Bir iletişim kutusunu işler
  • Parametreler:
    • accept (boolean): İletişim kutusunun kabul edilip edilmeyeceği.
    • promptText (string, isteğe bağlı): Bir istem iletişim kutusu durumunda istemin metni.
  • Salt okunur: false

• browser_hover
  • Başlık: Fareyi üzerine getir
  • Açıklama: Sayfadaki öğenin üzerine gelir
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: false

• browser_navigate
  • Başlık: Bir URL'ye git
  • Açıklama: Bir URL'ye gider
  • Parametreler:
    • url (string): Gidilecek URL
  • Salt okunur: false

• browser_navigate_back
  • Başlık: Geri git
  • Açıklama: Geçmişteki önceki sayfaya geri döner
  • Parametreler: Yok
  • Salt okunur: false

• browser_network_request
  • Başlık: Ağ isteği ayrıntılarını göster
  • Açıklama: Tek bir ağ isteğinin tam ayrıntılarını (başlıklar ve gövde) veya part ayarlanmışsa tek bir bölümünü döndürür. browser_network_requests'ten gelen numarayı kullanın.
  • Parametreler:
    • index (integer): browser_network_requests tarafından yazdırıldığı gibi isteğin 1 tabanlı dizini.
    • part (string, isteğe bağlı): İsteğin yalnızca bu bölümünü döndürür. Tam ayrıntıları döndürmek için atlayın.
    • filename (string, isteğe bağlı): Sonucun kaydedileceği dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Sağlanmazsa, çıktı metin olarak döndürülür.
  • Salt okunur: true

• browser_network_requests
  • Başlık: Ağ isteklerini listele
  • Açıklama: Sayfayı yükledikten sonraki ağ isteklerinin numaralı bir listesini döndürür. Tam ayrıntıları almak için numarayla browser_network_request kullanın.
  • Parametreler:
    • static (boolean): Görüntüler, yazı tipleri, komut dosyaları vb. gibi başarılı statik kaynakların dahil edilip edilmeyeceği. Varsayılan false'tur.
    • filter (string, isteğe bağlı): Yalnızca URL'si bu normal ifadeyle eşleşen istekleri döndürür (ör. "/api/.*user").
    • filename (string, isteğe bağlı): Ağ isteklerinin kaydedileceği dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Sağlanmazsa, istekler metin olarak döndürülür.
  • Salt okunur: true

• browser_press_key
  • Başlık: Bir tuşa bas
  • Açıklama: Klavyede bir tuşa basar
  • Parametreler:
    • key (string): Basılacak tuşun adı veya oluşturulacak bir karakter, örneğin ArrowLeft veya a
  • Salt okunur: false

• browser_resize
  • Başlık: Tarayıcı penceresini yeniden boyutlandır
  • Açıklama: Tarayıcı penceresini yeniden boyutlandırır
  • Parametreler:
    • width (number): Tarayıcı penceresinin genişliği
    • height (number): Tarayıcı penceresinin yüksekliği
  • Salt okunur: false

• browser_run_code_unsafe
  • Başlık: Playwright kodunu çalıştır (güvenli değil)
  • Açıklama: Bir Playwright kod parçacığını çalıştırır. Güvenli değil: Playwright sunucu sürecinde rastgele JavaScript yürütür ve RCE'ye eşdeğerdir.
  • Parametreler:
    • code (string, isteğe bağlı): Yürütülecek Playwright kodunu içeren bir JavaScript işlevi. Tek bir bağımsız değişken olan page ile çağrılır; herhangi bir sayfa etkileşimi için kullanabilirsiniz. Örneğin: async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (string, isteğe bağlı): Kodu belirtilen dosyadan yükleyin. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Hem kod hem de dosya adı sağlanırsa, kod yok sayılır.
  • Salt okunur: false

• browser_select_option
  • Başlık: Seçenek seç
  • Açıklama: Açılır listede bir seçenek seçer
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • values (array): Açılır listede seçilecek değerler dizisi. Tek bir değer veya birden fazla değer olabilir.
  • Salt okunur: false

• browser_snapshot
  • Başlık: Sayfa anlık görüntüsü
  • Açıklama: Geçerli sayfanın erişilebilirlik anlık görüntüsünü alır; bu, ekran görüntüsünden daha iyidir
  • Parametreler:
    • target (string, isteğe bağlı): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • filename (string, isteğe bağlı): Anlık görüntüyü yanıtta döndürmek yerine bir dosyaya kaydeder. Göreli dosya adları çalışma alanı köküne göre çözümlenir.
    • depth (number, isteğe bağlı): Anlık görüntü ağacının derinliğini sınırlar
    • boxes (boolean, isteğe bağlı): Her öğenin sınırlayıcı kutusunu anlık görüntüde [box=x,y,width,height] olarak ekler. Koordinatlar görünüm alanına göredir, CSS piksel cinsindendir (Element.getBoundingClientRect)
  • Salt okunur: true

• browser_take_screenshot
  • Başlık: Ekran görüntüsü al
  • Açıklama: Geçerli sayfanın ekran görüntüsünü alır. Ekran görüntüsüne dayalı eylemler gerçekleştiremezsiniz; eylemler için browser_snapshot kullanın.
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string, isteğe bağlı): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • type (string, isteğe bağlı): Ekran görüntüsü için görüntü biçimi. Ayarlanmazsa, dosya adı uzantısından çıkarılır, aksi takdirde png.
    • filename (string, isteğe bağlı): Ekran görüntüsünü kaydetmek için dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Belirtilmezse, ekran görüntüsü çıktı dizinine page-{timestamp}.{png|jpeg|webp} olarak kaydedilir.
    • fullPage (boolean, isteğe bağlı): true olduğunda, geçerli görünür görünüm alanı yerine tam kaydırılabilir sayfanın ekran görüntüsünü alır. Öğe ekran görüntüleriyle kullanılamaz.
    • scale (string): Görüntü çözünürlük ölçeği. "css", CSS piksel cinsinden boyutlandırılmış bir ekran görüntüsü üretir (daha küçük, cihazlar arasında tutarlı). "device", cihaz piksel oranını hesaba katan yüksek çözünürlüklü bir ekran görüntüsü üretir (daha büyük). Varsayılan css'dir.
  • Salt okunur: true

• browser_type
  • Başlık: Metin yaz
  • Açıklama: Düzenlenebilir öğeye metin yazar
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
    • text (string): Öğeye yazılacak metin
    • submit (boolean, isteğe bağlı): Girilen metnin gönderilip gönderilmeyeceği (sonrasında Enter'a basılır)
    • slowly (boolean, isteğe bağlı): Metnin her seferinde bir karakter yazılıp yazılmayacağı. Sayfadaki tuş işleyicilerini tetiklemek için kullanışlıdır. Varsayılan olarak tüm metin bir kerede doldurulur.
  • Salt okunur: false

• browser_wait_for
  • Başlık: Bekle
  • Açıklama: Metnin görünmesini veya kaybolmasını ya da belirli bir sürenin geçmesini bekler
  • Parametreler:
    • time (number, isteğe bağlı): Beklenecek süre saniye cinsinden, en fazla 30
    • text (string, isteğe bağlı): Beklenecek metin
    • textGone (string, isteğe bağlı): Kaybolması beklenen metin
  • Salt okunur: false

• browser_tabs
  • Başlık: Sekmeleri yönet
  • Açıklama: Tarayıcı sekmesini listeler, oluşturur, kapatır veya seçer.
  • Parametreler:
    • action (string): Gerçekleştirilecek işlem
    • index (number, isteğe bağlı): Sekme dizini, kapatma/seçme için kullanılır. Kapatma için atlanırsa, geçerli sekme kapatılır.
    • url (string, isteğe bağlı): Yeni sekmede gezinilecek URL, yeni için kullanılır.
  • Salt okunur: false

• browser_get_config
  • Başlık: Yapılandırmayı al
  • Açıklama: CLI seçeneklerini, ortam değişkenlerini ve yapılandırma dosyasını birleştirdikten sonra nihai çözümlenmiş yapılandırmayı alır.
  • Parametreler: Yok
  • Salt okunur: true

• browser_network_state_set
  • Başlık: Ağ durumunu ayarla
  • Açıklama: Tarayıcı ağ durumunu çevrimiçi veya çevrimdışı olarak ayarlar. Çevrimdışıyken, tüm ağ istekleri başarısız olur.
  • Parametreler:
    • state (string): Çevrimdışı modu simüle etmek için "offline", ağ bağlantısını geri yüklemek için "online" olarak ayarlayın
  • Salt okunur: false

• browser_route
  • Başlık: Ağ isteklerini simüle et
  • Açıklama: Bir URL deseniyle eşleşen ağ isteklerini simüle etmek için bir rota ayarlar
  • Parametreler:
    • pattern (string): Eşleştirilecek URL deseni (ör. "/api/users", "/*.{png,jpg}")
    • status (number, isteğe bağlı): Döndürülecek HTTP durum kodu (varsayılan: 200)
    • body (string, isteğe bağlı): Yanıt gövdesi (metin veya JSON dizesi)
    • contentType (string, isteğe bağlı): Content-Type başlığı (ör. "application/json", "text/html")
    • headers (array, isteğe bağlı): "Ad: Değer" biçiminde eklenecek başlıklar
    • removeHeaders (string, isteğe bağlı): İstekten kaldırılacak virgülle ayrılmış başlık adları listesi
  • Salt okunur: false

• browser_route_list
  • Başlık: Ağ rotalarını listele
  • Açıklama: Tüm etkin ağ rotalarını listeler
  • Parametreler: Yok
  • Salt okunur: true

• browser_unroute
  • Başlık: Ağ rotalarını kaldır
  • Açıklama: Bir desenle eşleşen ağ rotalarını kaldırır (desen belirtilmezse tüm rotaları)
  • Parametreler:
    • pattern (string, isteğe bağlı): Kaldırılacak URL deseni (tüm rotaları kaldırmak için atlayın)
  • Salt okunur: false

• browser_cookie_clear
  • Başlık: Çerezleri temizle
  • Açıklama: Tüm çerezleri temizler
  • Parametreler: Yok
  • Salt okunur: false

• browser_cookie_delete
  • Başlık: Çerezi sil
  • Açıklama: Belirli bir çerezi siler
  • Parametreler:
    • name (string): Silinecek çerez adı
  • Salt okunur: false

• browser_cookie_get
  • Başlık: Çerezi al
  • Açıklama: Ada göre belirli bir çerezi alır
  • Parametreler:
    • name (string): Alınacak çerez adı
  • Salt okunur: true

• browser_cookie_list
  • Başlık: Çerezleri listele
  • Açıklama: Tüm çerezleri listeler (isteğe bağlı olarak alan adı/yola göre filtrelenir)
  • Parametreler:
    • domain (string, isteğe bağlı): Çerezleri alan adına göre filtreler
    • path (string, isteğe bağlı): Çerezleri yola göre filtreler
  • Salt okunur: true

• browser_cookie_set
  • Başlık: Çerez ayarla
  • Açıklama: İsteğe bağlı bayraklarla bir çerez ayarlar (domain, path, expires, httpOnly, secure, sameSite)
  • Parametreler:
    • name (string): Çerez adı
    • value (string): Çerez değeri
    • domain (string, isteğe bağlı): Çerez alan adı
    • path (string, isteğe bağlı): Çerez yolu
    • expires (number, isteğe bağlı): Unix zaman damgası olarak çerez sona erme süresi
    • httpOnly (boolean, isteğe bağlı): Çerezin yalnızca HTTP olup olmadığı
    • secure (boolean, isteğe bağlı): Çerezin güvenli olup olmadığı
    • sameSite (string, isteğe bağlı): Çerez SameSite özniteliği
  • Salt okunur: false

• browser_localstorage_clear
  • Başlık: localStorage'ı temizle
  • Açıklama: Tüm localStorage'ı temizler
  • Parametreler: Yok
  • Salt okunur: false

• browser_localstorage_delete
  • Başlık: localStorage öğesini sil
  • Açıklama: Bir localStorage öğesini siler
  • Parametreler:
    • key (string): Silinecek anahtar
  • Salt okunur: false

• browser_localstorage_get
  • Başlık: localStorage öğesini al
  • Açıklama: Anahtara göre bir localStorage öğesini alır
  • Parametreler:
    • key (string): Alınacak anahtar
  • Salt okunur: true

• browser_localstorage_list
  • Başlık: localStorage'ı listele
  • Açıklama: Tüm localStorage anahtar-değer çiftlerini listeler
  • Parametreler: Yok
  • Salt okunur: true

• browser_localstorage_set
  • Başlık: localStorage öğesini ayarla
  • Açıklama: Bir localStorage öğesi ayarlar
  • Parametreler:
    • key (string): Ayarlanacak anahtar
    • value (string): Ayarlanacak değer
  • Salt okunur: false

• browser_sessionstorage_clear
  • Başlık: sessionStorage'ı temizle
  • Açıklama: Tüm sessionStorage'ı temizler
  • Parametreler: Yok
  • Salt okunur: false

• browser_sessionstorage_delete
  • Başlık: sessionStorage öğesini sil
  • Açıklama: Bir sessionStorage öğesini siler
  • Parametreler:
    • key (string): Silinecek anahtar
  • Salt okunur: false

• browser_sessionstorage_get
  • Başlık: sessionStorage öğesini al
  • Açıklama: Anahtara göre bir sessionStorage öğesini alır
  • Parametreler:
    • key (string): Alınacak anahtar
  • Salt okunur: true

• browser_sessionstorage_list
  • Başlık: sessionStorage'ı listele
  • Açıklama: Tüm sessionStorage anahtar-değer çiftlerini listeler
  • Parametreler: Yok
  • Salt okunur: true

• browser_sessionstorage_set
  • Başlık: sessionStorage öğesini ayarla
  • Açıklama: Bir sessionStorage öğesi ayarlar
  • Parametreler:
    • key (string): Ayarlanacak anahtar
    • value (string): Ayarlanacak değer
  • Salt okunur: false

• browser_set_storage_state
  • Başlık: Depolama durumunu geri yükle
  • Açıklama: Bir dosyadan depolama durumunu (çerezler, yerel depolama) geri yükler. Bu, geri yüklemeden önce mevcut çerezleri ve yerel depolamayı temizler.
  • Parametreler:
    • filename (string): Geri yüklenecek depolama durumu dosyasının yolu. Göreli dosya adları çalışma alanı köküne göre çözümlenir.
  • Salt okunur: false

• browser_storage_state
  • Başlık: Depolama durumunu kaydet
  • Açıklama: Depolama durumunu (çerezler, yerel depolama) daha sonra yeniden kullanmak üzere bir dosyaya kaydeder
  • Parametreler:
    • filename (string, isteğe bağlı): Depolama durumunu kaydetmek için dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Belirtilmezse, depolama durumu çıktı dizinine storage-state-{timestamp}.json olarak kaydedilir.
  • Salt okunur: true

• browser_annotate
  • Başlık: Geçerli sayfayı açıklama ekle
  • Açıklama: Geçerli sayfa için Playwright Dashboard'u açıklama modunda açar ve kullanıcının açıklamalar çizmesini bekler. Açıklamalı ekran görüntüsünü, ARIA anlık görüntüsünü ve açıklama listesini döndürür.
  • Parametreler: Yok
  • Salt okunur: true

• browser_hide_highlight
  • Başlık: Öğe vurgusunu gizle
  • Açıklama: Öğe için daha önce eklenen bir vurgu katmanını kaldırır.
  • Parametreler:
    • element (string, isteğe bağlı): Vurgu eklenirken kullanılan insan tarafından okunabilir öğe açıklaması; browser_highlight'a iletilen değerle eşleşmelidir.
    • target (string, isteğe bağlı): Sayfa anlık görüntüsünden tam hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: true

• browser_highlight
  • Başlık: Öğeyi vurgula
  • Açıklama: Sayfadaki öğenin etrafında kalıcı bir vurgu katmanı gösterir.
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden alınan tam hedef öğe referansı veya benzersiz bir öğe seçici
    • style (string, isteğe bağlı): Vurgu katmanına uygulanan ek satır içi CSS, örn. "outline: 2px dashed red".
  • Salt okunur: true

• browser_resume
  • Başlık: Duraklatılmış komut dosyası yürütmeyi sürdür
  • Açıklama: Duraklatıldıktan sonra komut dosyası yürütmeyi sürdürür. step true olarak çağrıldığında, yürütme bir sonraki eylemden önce tekrar duraklatılır.
  • Parametreler:
    • step (boolean, isteğe bağlı): true olduğunda, yürütme bir sonraki eylemden önce tekrar duraklatılır ve adım adım hata ayıklamaya olanak tanır.
    • location (string, isteğe bağlı): Belirli bir : konumunda yürütmeyi duraklatır, örn. "example.spec.ts:42".
  • Salt okunur: false

• browser_start_recording
  • Başlık: Kullanıcı eylemlerini kaydetmeye başla
  • Açıklama: Kullanıcının tarayıcıda gerçekleştirdiği eylemleri Playwright kodu olarak kaydetmeye başlar. Kullanıcı bir akışı manuel olarak göstermek istediğinde kullanın. Kullanıcı bittiğini söylediğinde kaydedilen eylemleri almak için browser_stop_recording çağırın.
  • Parametreler: Yok
  • Salt okunur: true

• browser_start_tracing
  • Başlık: İzlemeyi başlat
  • Açıklama: İz kaydını başlat
  • Parametreler: Yok
  • Salt okunur: true

• browser_start_video
  • Başlık: Videoyu başlat
  • Açıklama: Video kaydını başlat
  • Parametreler:
    • filename (string, isteğe bağlı): Videonun kaydedileceği dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Belirtilmezse, video çıktı dizinine video-{timestamp}.webm olarak kaydedilir.
    • size (object, isteğe bağlı): Video boyutu
    • fps (number, isteğe bağlı): Saniyedeki kare sayısı cinsinden video kare hızı, varsayılan 25
    • cursor (boolean, isteğe bağlı): Her eylem noktasına giden animasyonlu bir fare imleci oluşturur. İmlecin hareket etmesi için eylemleri 800ms ile hızlandırır.
  • Salt okunur: true

• browser_stop_recording
  • Başlık: Kullanıcı eylemlerini kaydetmeyi durdur
  • Açıklama: browser_start_recording ile başlatılan kaydı durdurur ve kaydedilen eylemleri Playwright kodu olarak döndürür.
  • Parametreler: Yok
  • Salt okunur: true

• browser_stop_tracing
  • Başlık: İzlemeyi durdur
  • Açıklama: İz kaydını durdur
  • Parametreler: Yok
  • Salt okunur: true

• browser_stop_video
  • Başlık: Videoyu durdur
  • Açıklama: Video kaydını durdur
  • Parametreler: Yok
  • Salt okunur: true

• browser_video_chapter
  • Başlık: Video bölümü
  • Açıklama: Video kaydına bir bölüm işareti ekler. Bulanık arka planlı tam ekran bir bölüm kartı gösterir.
  • Parametreler:
    • title (string): Bölüm başlığı
    • description (string, isteğe bağlı): Bölüm açıklaması
    • duration (number, isteğe bağlı): Bölüm kartının gösterileceği milisaniye cinsinden süre
  • Salt okunur: true

• browser_video_hide_actions
  • Başlık: Eylem katmanlarını gizle
  • Açıklama: Sayfada gerçekleştirilen eylemleri açıklamayı durdur.
  • Parametreler: Yok
  • Salt okunur: true

• browser_video_show_actions
  • Başlık: Eylem katmanlarını göster
  • Açıklama: Sayfada gerçekleştirilen sonraki eylemleri, eylemi adlandıran ve stil uygulandığında eylem noktasını işaretleyen ve hedef öğeyi vurgulayan bir açıklama balonuyla açıklar. Video kaydı veya ekran kaydı sırasında kullanışlıdır.
  • Parametreler:
    • duration (number, isteğe bağlı): Her eylem açıklamasının ekranda ne kadar kalacağı, milisaniye cinsinden. Varsayılan 500.
    • position (string, isteğe bağlı): Eylem başlığının sayfaya göre nereye yerleştirileceği. Varsayılan sağ üst.
    • cursor (string, isteğe bağlı): İşaretçi eylemleri için imleç dekorasyonu. "pointer" (varsayılan) bir fare imlecini önceki eylem noktasından sonrakine animasyonla taşır; "none" imleç dekorasyonunu devre dışı bırakır.
    • style (object, isteğe bağlı): Eylem dekorasyonlarının stilleri.
  • Salt okunur: true

• browser_mouse_click_xy
  • Başlık: Tıkla
  • Açıklama: Belirli bir konumda fare düğmesine tıklar
  • Parametreler:
    • x (number): X koordinatı
    • y (number): Y koordinatı
    • button (string, isteğe bağlı): Tıklanacak düğme, varsayılan sol
    • clickCount (number, isteğe bağlı): Tıklama sayısı, varsayılan 1
    • delay (number, isteğe bağlı): Fare basma ve bırakma arasında milisaniye cinsinden beklenecek süre, varsayılan 0
  • Salt okunur: false

• browser_mouse_down
  • Başlık: Fareyi basılı tut
  • Açıklama: Fareyi basılı tut
  • Parametreler:
    • button (string, isteğe bağlı): Basılacak düğme, varsayılan sol
  • Salt okunur: false

• browser_mouse_drag_xy
  • Başlık: Fareyi sürükle
  • Açıklama: Sol fare düğmesini belirli bir konuma sürükler
  • Parametreler:
    • startX (number): Başlangıç X koordinatı
    • startY (number): Başlangıç Y koordinatı
    • endX (number): Bitiş X koordinatı
    • endY (number): Bitiş Y koordinatı
  • Salt okunur: false

• browser_mouse_move_xy
  • Başlık: Fareyi hareket ettir
  • Açıklama: Fareyi belirli bir konuma hareket ettirir
  • Parametreler:
    • x (number): X koordinatı
    • y (number): Y koordinatı
  • Salt okunur: false

• browser_mouse_up
  • Başlık: Fareyi bırak
  • Açıklama: Fareyi bırak
  • Parametreler:
    • button (string, isteğe bağlı): Bırakılacak düğme, varsayılan sol
  • Salt okunur: false

• browser_mouse_wheel
  • Başlık: Fare tekerleğini kaydır
  • Açıklama: Fare tekerleğini kaydır
  • Parametreler:
    • deltaX (number): X delta
    • deltaY (number): Y delta
  • Salt okunur: false

• browser_pdf_save
  • Başlık: PDF olarak kaydet
  • Açıklama: Sayfayı PDF olarak kaydeder
  • Parametreler:
    • filename (string, isteğe bağlı): PDF'in kaydedileceği dosya adı. Göreli dosya adları çalışma alanı köküne göre çözümlenir. Belirtilmezse, PDF çıktı dizinine page-{timestamp}.pdf olarak kaydedilir.
  • Salt okunur: true

• browser_generate_locator
  • Başlık: Öğe için konumlandırıcı oluştur
  • Açıklama: Testlerde kullanmak üzere verilen öğe için konumlandırıcı oluşturur
  • Parametreler:
    • element (string, isteğe bağlı): Öğeyle etkileşim izni almak için kullanılan insan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden alınan tam hedef öğe referansı veya benzersiz bir öğe seçici
  • Salt okunur: true

• browser_verify_element_visible
  • Başlık: Öğenin görünür olduğunu doğrula
  • Açıklama: Öğenin sayfada görünür olduğunu doğrular
  • Parametreler:
    • role (string): Öğenin ROLE'u. Anlık görüntüde şu şekilde bulunabilir: - {ROLE} "Accessible Name":
    • accessibleName (string): Öğenin ACCESSIBLE_NAME'i. Anlık görüntüde şu şekilde bulunabilir: - role "{ACCESSIBLE_NAME}"
  • Salt okunur: false

• browser_verify_list_visible
  • Başlık: Listenin görünür olduğunu doğrula
  • Açıklama: Listenin sayfada görünür olduğunu doğrular
  • Parametreler:
    • element (string): İnsan tarafından okunabilir liste açıklaması
    • target (string): Listeyi gösteren tam hedef öğe referansı
    • items (array): Doğrulanacak öğeler
  • Salt okunur: false

• browser_verify_text_visible
  • Başlık: Metnin görünür olduğunu doğrula
  • Açıklama: Metnin sayfada görünür olduğunu doğrular. Mümkünse browser_verify_element_visible tercih edin.
  • Parametreler:
    • text (string): Doğrulanacak METİN. Anlık görüntüde şu şekilde bulunabilir: - role "Accessible Name": {TEXT} veya şu şekilde: - text: {TEXT}
  • Salt okunur: false

• browser_verify_value
  • Başlık: Değeri doğrula
  • Açıklama: Öğe değerini doğrular
  • Parametreler:
    • type (string): Öğenin türü
    • element (string): İnsan tarafından okunabilir öğe açıklaması
    • target (string): Sayfa anlık görüntüsünden alınan tam hedef öğe referansı
    • value (string): Doğrulanacak değer. Onay kutusu için "true" veya "false" kullanın.
  • Salt okunur: false