Test element added at: ${new Date().toLocaleTimeString()}
`; container.appendChild(newElement); } ``` -------------------------------- ### Close Multiple Pages Sequentially Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Demonstrates closing multiple browser tabs sequentially by calling the close_page function for each. ```javascript await puppeteer_close_page({ pageId: "login-page" }); await puppeteer_close_page({ pageId: "temp-page" }); ``` -------------------------------- ### Set Cookies for a Page Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Sets one or more cookies for a specified page. Supports standard cookie attributes like domain, path, expiration, and security flags. ```javascript await puppeteer_set_cookies({ pageId: "main", cookies: [ { name: "session_id", value: "abc123xyz", domain: "example.com" } ] }); ``` ```javascript await puppeteer_set_cookies({ pageId: "main", cookies: [ { name: "auth_token", value: "eyJhbGciOiJIUzI1NiIs...", domain: ".example.com", path: "/", expires: Date.now() / 1000 + 86400, // 24 hours from now httpOnly: true, secure: true, sameSite: "Strict" }, { name: "user_preferences", value: JSON.stringify({ theme: "dark", lang: "en" }), domain: "example.com", path: "/", sameSite: "Lax" } ] }); ``` -------------------------------- ### Remove MCP Configuration Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/TESTING.md Remove the MCP configuration from the project. ```bash npm run remove-mcp ``` -------------------------------- ### Data Extraction with Puppeteer Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/README.md Shows how to extract text from an element and execute custom JavaScript within the browser context. Ensure the browser is launched and the page is navigated before extraction. ```javascript // Extract text from an element await puppeteer_get_text({ pageId: "main", selector: "h1" }); // Execute custom JavaScript await puppeteer_evaluate({ pageId: "main", script: "document.querySelectorAll('a').length" }); ``` -------------------------------- ### Close Browser Instance Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Closes the entire browser instance and all associated pages, cleaning up all resources. ```javascript await puppeteer_close_browser({}); ``` -------------------------------- ### Uninstall puppeteer-mcp-claude Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/README.md Use this command to remove the puppeteer-mcp-claude server from all your Claude applications. ```bash npx puppeteer-mcp-claude uninstall ``` -------------------------------- ### puppeteer_new_page Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Creates a new browser tab (page) with a unique identifier for later reference. Each page maintains its own state and can be controlled independently. ```APIDOC ## puppeteer_new_page ### Description Creates a new browser tab with a unique identifier for later reference. Each page maintains its own state and can be controlled independently. ### Method POST ### Endpoint /puppeteer_new_page ### Parameters #### Request Body - **pageId** (string) - Required - A unique identifier for the new page. ### Request Example ```json { "pageId": "main" } ``` ### Response #### Success Response (200) - **content** (array) - An array containing the result of the operation. - **type** (string) - The type of content, e.g., 'text'. - **text** (string) - The textual content, e.g., 'Page main created successfully'. #### Response Example ```json { "content": [ { "type": "text", "text": "Page main created successfully" } ] } ``` ``` -------------------------------- ### Retrieve Cookies from a Page Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Retrieves cookies from a specified page. Can fetch all cookies for the current page or filter by specific URLs. ```javascript await puppeteer_get_cookies({ pageId: "main" }); ``` ```javascript await puppeteer_get_cookies({ pageId: "main", urls: [ "https://example.com", "https://api.example.com" ] }); ``` -------------------------------- ### Show Dynamic Content with JavaScript Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/test-site/index.html This function makes a hidden div visible and updates its content with the current time. It's useful for toggling the visibility of elements and displaying real-time data. Ensure the target element has `id='dynamic-content'` and a placeholder for time with `id='current-time'`. ```javascript function showDynamicContent() { const dynamicContent = document.getElementById('dynamic-content'); dynamicContent.style.display = 'block'; document.getElementById('current-time').textContent = new Date().toLocaleTimeString(); } ``` -------------------------------- ### Handle Form Submission with JavaScript Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/test-site/index.html This script handles the submission of a form, preventing default submission, retrieving input values, and displaying them in a result section. It also resets the form after submission. Use this for client-side form processing. ```javascript document.getElementById('test-form').addEventListener('submit', function(e) { e.preventDefault(); const name = document.getElementById('name').value; const email = document.getElementById('email').value; document.getElementById('result-name').textContent = name; document.getElementById('result-email').textContent = email; document.getElementById('result').style.display = 'block'; // Clear form this.reset(); }); ``` -------------------------------- ### Exit Claude Code Session Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/TESTING.md Use Ctrl+C or type 'exit' to stop the current Claude Code session. ```bash # Press Ctrl+C or type exit ``` -------------------------------- ### Capture Screenshot with Puppeteer Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Captures a screenshot of the browser page. Can capture the visible viewport or the entire scrollable page and save it as a PNG file. If no path is provided, the screenshot is held in memory. ```javascript // Screenshot visible viewport await puppeteer_screenshot({ pageId: "main", path: "/tmp/viewport-screenshot.png" }); ``` ```javascript // Full page screenshot (captures entire scrollable area) await puppeteer_screenshot({ pageId: "main", path: "/tmp/full-page-screenshot.png", fullPage: true }); ``` ```javascript // Screenshot without saving to file (for in-memory use) await puppeteer_screenshot({ pageId: "main" }); ``` ```javascript // Screenshot with specific naming await puppeteer_screenshot({ pageId: "dashboard-page", path: "./screenshots/dashboard-2024-01-15.png", fullPage: false }); ``` -------------------------------- ### Type Text into Element with Puppeteer Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Simulates typing text into an input field or textarea character by character. Use this for filling out forms or entering data into text areas. Ensure the selector targets the correct input or textarea. ```javascript // Type into a text input await puppeteer_type({ pageId: "main", selector: "input[name='username']", text: "john.doe@example.com" }); ``` ```javascript // Type into a password field await puppeteer_type({ pageId: "main", selector: "input[type='password']", text: "secretPassword123" }); ``` ```javascript // Type into a search box await puppeteer_type({ pageId: "main", selector: "#search-input", text: "puppeteer automation" }); ``` ```javascript // Type into a textarea await puppeteer_type({ pageId: "main", selector: "textarea.comment-box", text: "This is a multi-line\ncomment with special chars: @#$%" }); ``` -------------------------------- ### Delayed Element Appearance with JavaScript Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/test-site/index.html This script uses `setTimeout` to add a new div element to the page after a 2-second delay. This is ideal for testing scenarios where elements appear asynchronously, such as with `waitForSelector` in Puppeteer. ```javascript setTimeout(function() { const delayedElement = document.createElement('div'); delayedElement.id = 'delayed-element'; delayedElement.style.cssText = 'margin: 20px 0; padding: 15px; background-color: #cce5ff; border-radius: 4px;'; delayedElement.innerHTML = 'This element appeared after 2 seconds - perfect for testing waitForSelector!
'; document.querySelector('.container').appendChild(delayedElement); }, 2000); ``` -------------------------------- ### puppeteer_close_browser Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Closes the entire browser instance and all associated pages. Cleans up all resources. ```APIDOC ## puppeteer_close_browser ### Description Closes the entire browser instance and all associated pages. Cleans up all resources. ### Method Not specified, assumed to be a function call. ### Endpoint Not applicable, this is a function call. ### Parameters This endpoint does not require any parameters. ### Request Example ```json {} ``` ### Response #### Success Response (200) - **content** (array) - An array containing the result message. - **type** (string) - The type of content, e.g., 'text'. - **text** (string) - The result message, e.g., 'Browser closed'. #### Response Example ```json { "content": [ { "type": "text", "text": "Browser closed" } ] } ``` ``` -------------------------------- ### Evaluate JavaScript in Browser Context with Puppeteer Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Executes arbitrary JavaScript code within the browser's execution context. Returns the result of the script, which can be any JSON-serializable value. Useful for complex DOM manipulations, data extraction, or triggering client-side logic. ```javascript // Get the page title await puppeteer_evaluate({ pageId: "main", script: "document.title" }); ``` ```javascript // Count elements on the page await puppeteer_evaluate({ pageId: "main", script: "document.querySelectorAll('a').length" }); ``` ```javascript // Get all link URLs await puppeteer_evaluate({ pageId: "main", script: "Array.from(document.querySelectorAll('a')).map(a => a.href)" }); ``` ```javascript // Scroll to bottom of page await puppeteer_evaluate({ pageId: "main", script: "window.scrollTo(0, document.body.scrollHeight)" }); ``` ```javascript // Get localStorage data await puppeteer_evaluate({ pageId: "main", script: "JSON.parse(localStorage.getItem('userData'))" }); ``` ```javascript // Modify DOM elements await puppeteer_evaluate({ pageId: "main", script: "document.querySelector('#hidden-field').value = 'new-value'" }); ``` ```javascript // Get computed styles await puppeteer_evaluate({ pageId: "main", script: "getComputedStyle(document.querySelector('.button')).backgroundColor" }); ``` -------------------------------- ### Close a Specific Page Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Closes a specific browser tab identified by its pageId and removes it from the managed pages. ```javascript await puppeteer_close_page({ pageId: "main" }); ``` -------------------------------- ### Click Element with Puppeteer Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Clicks on an element identified by a CSS selector. The element must be visible and interactable. Use this for simulating user clicks on buttons, links, or other interactive elements. ```javascript // Click a button by ID await puppeteer_click({ pageId: "main", selector: "#submit-button" }); ``` ```javascript // Click a link by class await puppeteer_click({ pageId: "main", selector: ".nav-link.active" }); ``` ```javascript // Click by data attribute await puppeteer_click({ pageId: "main", selector: "[data-testid='login-btn']" }); ``` ```javascript // Click a specific list item await puppeteer_click({ pageId: "main", selector: "ul.menu > li:nth-child(3) > a" }); ``` -------------------------------- ### puppeteer_set_cookies Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Sets one or more cookies for a page. Supports all standard cookie attributes including domain, path, expiration, and security flags. ```APIDOC ## puppeteer_set_cookies ### Description Sets one or more cookies for a page. Supports all standard cookie attributes including domain, path, expiration, and security flags. ### Method Not specified, assumed to be a function call. ### Endpoint Not applicable, this is a function call. ### Parameters #### Request Body - **pageId** (string) - Required - Identifier for the page. - **cookies** (array) - Required - An array of cookie objects to set. - **name** (string) - Required - The name of the cookie. - **value** (string) - Required - The value of the cookie. - **domain** (string) - Optional - The domain for which the cookie is set. - **path** (string) - Optional - The path for which the cookie is set. - **expires** (number) - Optional - The expiration date of the cookie as a Unix timestamp. - **httpOnly** (boolean) - Optional - Whether the cookie is HTTP only. - **secure** (boolean) - Optional - Whether the cookie is secure. - **sameSite** (string) - Optional - The SameSite attribute for the cookie ('Strict', 'Lax', 'None'). ### Request Example ```json { "pageId": "main", "cookies": [ { "name": "session_id", "value": "abc123xyz", "domain": "example.com" } ] } ``` ### Response #### Success Response (200) - **content** (array) - An array containing the result message. - **type** (string) - The type of content, e.g., 'text'. - **text** (string) - The result message, e.g., 'Set 2 cookie(s) for page main'. #### Response Example ```json { "content": [ { "type": "text", "text": "Set 2 cookie(s) for page main" } ] } ``` ``` -------------------------------- ### puppeteer_close_page Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Closes a specific browser tab and removes it from the managed pages. ```APIDOC ## puppeteer_close_page ### Description Closes a specific browser tab and removes it from the managed pages. ### Method Not specified, assumed to be a function call. ### Endpoint Not applicable, this is a function call. ### Parameters #### Request Body - **pageId** (string) - Required - Identifier for the page to close. ### Request Example ```json { "pageId": "main" } ``` ### Response #### Success Response (200) - **content** (array) - An array containing the result message. - **type** (string) - The type of content, e.g., 'text'. - **text** (string) - The result message, e.g., 'Page main closed'. #### Response Example ```json { "content": [ { "type": "text", "text": "Page main closed" } ] } ``` ``` -------------------------------- ### Delete Cookies from a Page Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Deletes specified cookies from a page. Cookies can be identified by name, and optionally filtered by domain and path. ```javascript await puppeteer_delete_cookies({ pageId: "main", cookies: [ { name: "session_id" } ] }); ``` ```javascript await puppeteer_delete_cookies({ pageId: "main", cookies: [ { name: "auth_token", domain: ".example.com", path: "/" }, { name: "tracking_id", domain: "analytics.example.com" } ] }); ``` -------------------------------- ### Wait for Selector with Puppeteer Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Waits for an element matching the specified CSS selector to appear in the DOM. This is crucial for handling dynamically loaded content or elements that appear after asynchronous operations. Supports custom timeouts. ```javascript // Wait for element with default timeout (30 seconds) await puppeteer_wait_for_selector({ pageId: "main", selector: ".loading-complete" }); ``` ```javascript // Wait with custom timeout (5 seconds) await puppeteer_wait_for_selector({ pageId: "main", selector: "#dynamic-content", timeout: 5000 }); ``` ```javascript // Wait for modal to appear await puppeteer_wait_for_selector({ pageId: "main", selector: ".modal.visible", timeout: 10000 }); ``` ```javascript // Wait for search results await puppeteer_wait_for_selector({ pageId: "main", selector: ".search-results li", timeout: 15000 }); ``` -------------------------------- ### Change Page Title with JavaScript Source: https://github.com/jaenster/puppeteer-mcp-claude/blob/main/test-site/index.html This function modifies the browser tab's title and displays an alert. It's useful for testing dynamic title updates and user notifications. The new title includes a timestamp. ```javascript function changeTitle() { document.title = 'Title Changed by Puppeteer Test - ' + new Date().toLocaleTimeString(); alert('Page title changed!'); } ``` -------------------------------- ### puppeteer_set_request_interception Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Enables request interception to block specific resource types or modify request headers. Useful for performance optimization and testing. ```APIDOC ## puppeteer_set_request_interception ### Description Enables request interception to block specific resource types or modify request headers. Useful for performance optimization and testing. ### Method Not specified, assumed to be a function call. ### Endpoint Not applicable, this is a function call. ### Parameters #### Request Body - **pageId** (string) - Required - Identifier for the page. - **enable** (boolean) - Required - Whether to enable or disable request interception. - **blockResources** (array) - Optional - An array of resource types to block (e.g., 'image', 'font', 'stylesheet', 'media'). - **modifyHeaders** (object) - Optional - An object containing headers to add or modify for all requests. - **header-name** (string) - The value of the header. ### Request Example ```json { "pageId": "main", "enable": true, "blockResources": ["image", "font", "stylesheet"], "modifyHeaders": { "User-Agent": "CustomBot/1.0" } } ``` ### Response #### Success Response (200) - **content** (array) - An array containing the result message. - **type** (string) - The type of content, e.g., 'text'. - **text** (string) - The result message, e.g., 'Request interception enabled for page main'. #### Response Example ```json { "content": [ { "type": "text", "text": "Request interception enabled for page main" } ] } ``` ``` -------------------------------- ### puppeteer_delete_cookies Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Deletes specified cookies from a page by name, optionally filtered by domain and path. ```APIDOC ## puppeteer_delete_cookies ### Description Deletes specified cookies from a page by name, optionally filtered by domain and path. ### Method Not specified, assumed to be a function call. ### Endpoint Not applicable, this is a function call. ### Parameters #### Request Body - **pageId** (string) - Required - Identifier for the page. - **cookies** (array) - Required - An array of cookie objects specifying which cookies to delete. - **name** (string) - Required - The name of the cookie to delete. - **domain** (string) - Optional - The domain of the cookie to delete. - **path** (string) - Optional - The path of the cookie to delete. ### Request Example ```json { "pageId": "main", "cookies": [ { "name": "session_id" } ] } ``` ### Response #### Success Response (200) - **content** (array) - An array containing the result message. - **type** (string) - The type of content, e.g., 'text'. - **text** (string) - The result message, e.g., 'Deleted 2 cookie(s) from page main'. #### Response Example ```json { "content": [ { "type": "text", "text": "Deleted 2 cookie(s) from page main" } ] } ``` ``` -------------------------------- ### Set Request Interception Source: https://context7.com/jaenster/puppeteer-mcp-claude/llms.txt Enables or disables request interception for a page. Can be used to block specific resource types, modify request headers, or block all media and tracking resources. ```javascript await puppeteer_set_request_interception({ pageId: "main", enable: true, blockResources: ["image", "font", "stylesheet"] }); ``` ```javascript await puppeteer_set_request_interception({ pageId: "main", enable: true, blockResources: ["image", "media", "font"] }); ``` ```javascript await puppeteer_set_request_interception({ pageId: "main", enable: true, modifyHeaders: { "X-Custom-Header": "custom-value", "Authorization": "Bearer token123", "Accept-Language": "en-US,en;q=0.9" } }); ``` ```javascript await puppeteer_set_request_interception({ pageId: "main", enable: true, blockResources: ["image", "stylesheet", "font"], modifyHeaders: { "User-Agent": "CustomBot/1.0" } }); ``` ```javascript await puppeteer_set_request_interception({ pageId: "main", enable: false }); ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.