{"_id":"@sirblob/mcp-selenium","_rev":"6-4a2061ebb55469b07892d8f947c5623d","name":"@sirblob/mcp-selenium","dist-tags":{"latest":"1.0.3"},"versions":{"0.2.0":{"name":"@sirblob/mcp-selenium","version":"0.2.0","keywords":["selenium","webdriver","mcp","modelcontextprotocol","automation","browser-automation"],"author":{"name":"SirBlobby"},"license":"MIT","_id":"@sirblob/mcp-selenium@0.2.0","maintainers":[{"name":"sir_blob","email":"adithcool.5@gmail.com"}],"homepage":"https://github.com/SirBlobby/mcp-selenium#readme","bugs":{"url":"https://github.com/SirBlobby/mcp-selenium/issues"},"bin":{"mcp-selenium":"dist/bin/mcp-selenium.js"},"dist":{"shasum":"1bc697ffe722b159a7a1eabccb88242b0d0c754e","tarball":"https://registry.npmjs.org/@sirblob/mcp-selenium/-/mcp-selenium-0.2.0.tgz","fileCount":21,"integrity":"sha512-0xybf5TlZtNcpgME6VdYkwq+tcq3b5U0N1H//SFY60B6dSQfzFigWpG0UGmFP1iOkI0HGp5c2j3yoXXBmnbcsQ==","signatures":[{"sig":"MEYCIQCiQ39TZ3plSbJwWrIL/IaJ8KPYTzLCjm9n8fz6IRtYWQIhAPWTsNftpTB4ZsfRScyQtDd5f5AHg5+OZ282cMpngJ4S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68822},"main":"dist/src/server.js","type":"module","gitHead":"150957b30818ff513a997f040a06f96af8df6218","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/server.js"},"_npmUser":{"name":"sir_blob","email":"adithcool.5@gmail.com"},"repository":{"url":"git+https://github.com/SirBlobby/mcp-selenium.git","type":"git"},"_npmVersion":"11.4.2","description":"Selenium WebDriver MCP Server","directories":{},"_nodeVersion":"22.14.0","dependencies":{"selenium-webdriver":"^4.34.0","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14","@types/selenium-webdriver":"^4.1.28"},"_npmOperationalInternal":{"tmp":"tmp/mcp-selenium_0.2.0_1752871371827_0.20595105577970307","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@sirblob/mcp-selenium","version":"0.2.1","keywords":["selenium","webdriver","mcp","modelcontextprotocol","automation","browser-automation"],"author":{"name":"SirBlobby"},"license":"MIT","_id":"@sirblob/mcp-selenium@0.2.1","maintainers":[{"name":"sir_blob","email":"adithcool.5@gmail.com"}],"homepage":"https://github.com/SirBlobby/mcp-selenium#readme","bugs":{"url":"https://github.com/SirBlobby/mcp-selenium/issues"},"bin":{"mcp-selenium":"dist/bin/mcp-selenium.js"},"dist":{"shasum":"832300129c7da303f4c9e196a0e370e42c68fdaa","tarball":"https://registry.npmjs.org/@sirblob/mcp-selenium/-/mcp-selenium-0.2.1.tgz","fileCount":21,"integrity":"sha512-4pcdcD2sMNUEI3mWP58TBiyLnkZiqrfF2zP+4EBVkyaEr32XOtIWebgbSw5p79fMfRpoyxVkQeCt3HRmBs9vCg==","signatures":[{"sig":"MEYCIQDP5CZ5rg+nHgXSQz1oKRnbehsNO9sORMduOPEOfVwOGwIhAP1jmXy8FESjSP+o2moxcC7MvFWLRbjSm1M4pvG2lBB7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68805},"main":"dist/src/server.js","type":"module","gitHead":"88f362f5401714bdbf2c6c319a84c031cc719937","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/server.js"},"_npmUser":{"name":"sir_blob","email":"adithcool.5@gmail.com"},"repository":{"url":"git+https://github.com/SirBlobby/mcp-selenium.git","type":"git"},"_npmVersion":"11.4.2","description":"Selenium WebDriver MCP Server","directories":{},"_nodeVersion":"22.14.0","dependencies":{"selenium-webdriver":"^4.34.0","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14","@types/selenium-webdriver":"^4.1.28"},"_npmOperationalInternal":{"tmp":"tmp/mcp-selenium_0.2.1_1752871461520_0.8374926664442743","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@sirblob/mcp-selenium","version":"1.0.0","keywords":["selenium","webdriver","mcp","modelcontextprotocol","automation","browser-automation"],"author":{"name":"SirBlobby"},"license":"MIT","_id":"@sirblob/mcp-selenium@1.0.0","maintainers":[{"name":"sir_blob","email":"adithcool.5@gmail.com"}],"homepage":"https://github.com/SirBlobby/mcp-selenium#readme","bugs":{"url":"https://github.com/SirBlobby/mcp-selenium/issues"},"bin":{"mcp-selenium":"dist/bin/mcp-selenium.js"},"dist":{"shasum":"aafd010a7f4ac61efc9d5f2ab12a632c664814c6","tarball":"https://registry.npmjs.org/@sirblob/mcp-selenium/-/mcp-selenium-1.0.0.tgz","fileCount":21,"integrity":"sha512-sw4DaWsnYfkZvQYkOOPdhpUMsGVq0XTJl79VaNaJWQnnDBqh8y7vHklpER5YeKKUYEB/WujIV2iOT8stvGlg/w==","signatures":[{"sig":"MEUCID3QYeW5GbeRH/iWEkaByaOp+JPqBHWQbFITMngn1TGrAiEAtrKTqN31XPM6Gbzk6rrvgtOlnoRomjgnQ+3ybXNOjVE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":109598},"main":"dist/src/server.js","type":"module","gitHead":"8cdede55293f0a5582a77121d275df3d2d01e3a2","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/src/server.js"},"_npmUser":{"name":"sir_blob","email":"adithcool.5@gmail.com"},"repository":{"url":"git+https://github.com/SirBlobby/mcp-selenium.git","type":"git"},"_npmVersion":"11.4.2","description":"Selenium WebDriver MCP Server","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","selenium-webdriver":"^4.34.0","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14","@types/selenium-webdriver":"^4.1.28"},"_npmOperationalInternal":{"tmp":"tmp/mcp-selenium_1.0.0_1752888529066_0.49605609385542593","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@sirblob/mcp-selenium","version":"1.0.1","keywords":["selenium","webdriver","mcp","modelcontextprotocol","automation","browser-automation"],"author":{"name":"SirBlobby"},"license":"MIT","_id":"@sirblob/mcp-selenium@1.0.1","maintainers":[{"name":"sir_blob","email":"adithcool.5@gmail.com"}],"homepage":"https://github.com/SirBlobby/mcp-selenium#readme","bugs":{"url":"https://github.com/SirBlobby/mcp-selenium/issues"},"bin":{"mcp-selenium":"dist/bin/mcp-selenium.js"},"dist":{"shasum":"44adafbee32f78671374f8ddf867122b1cacbc87","tarball":"https://registry.npmjs.org/@sirblob/mcp-selenium/-/mcp-selenium-1.0.1.tgz","fileCount":21,"integrity":"sha512-zwrPGfwp26KxJUfF/LQftD0q+ozzEX38H+XQ+gGFIFoTE+zGhWLRkWsFw2LMwUf4Z5/OBIJa+f++Oin37t+7jA==","signatures":[{"sig":"MEUCIGPdC432VQ5D59dWLUC33wgyoBHhyfiMGiX3shyhYWNwAiEA36AjnSWFtPEKf8WSOIJuDa7gU5hfp7V0roG5CkdFVTs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":109449},"main":"dist/src/server.js","type":"module","gitHead":"8cdede55293f0a5582a77121d275df3d2d01e3a2","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/src/server.js"},"_npmUser":{"name":"sir_blob","email":"adithcool.5@gmail.com"},"repository":{"url":"git+https://github.com/SirBlobby/mcp-selenium.git","type":"git"},"_npmVersion":"11.4.2","description":"Selenium WebDriver MCP Server","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","selenium-webdriver":"^4.34.0","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14","@types/selenium-webdriver":"^4.1.28"},"_npmOperationalInternal":{"tmp":"tmp/mcp-selenium_1.0.1_1752888596397_0.21378765699162794","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@sirblob/mcp-selenium","version":"1.0.2","keywords":["selenium","webdriver","mcp","modelcontextprotocol","automation","browser-automation"],"author":{"name":"SirBlobby"},"license":"MIT","_id":"@sirblob/mcp-selenium@1.0.2","maintainers":[{"name":"sir_blob","email":"adithcool.5@gmail.com"}],"homepage":"https://github.com/SirBlobby/mcp-selenium#readme","bugs":{"url":"https://github.com/SirBlobby/mcp-selenium/issues"},"bin":{"mcp-selenium":"dist/bin/mcp-selenium.js"},"dist":{"shasum":"b4eded7c5efc59cb533a5f1e68b468d0ee19d891","tarball":"https://registry.npmjs.org/@sirblob/mcp-selenium/-/mcp-selenium-1.0.2.tgz","fileCount":21,"integrity":"sha512-A0KjaD1o1wEgRIXQytCEXr7oTgwqNZT9rXoNWadkHpcUcrr/ovXpRllCKZIjs7nUBTUB6UPyiQGzosePN5mJFQ==","signatures":[{"sig":"MEUCIQCKctzLwf7o9Q79UvlLFuRJ/9IcYGihrRLAT+nI1ikaQQIgYHCdVcqTHk7U2OYqd2tTz1nfsnaxrcCac6lR3Dv37Zc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":108872},"main":"dist/src/server.js","type":"module","gitHead":"8cdede55293f0a5582a77121d275df3d2d01e3a2","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/src/server.js"},"_npmUser":{"name":"sir_blob","email":"adithcool.5@gmail.com"},"repository":{"url":"git+https://github.com/SirBlobby/mcp-selenium.git","type":"git"},"_npmVersion":"11.4.2","description":"Selenium WebDriver MCP Server","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","selenium-webdriver":"^4.34.0","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14","@types/selenium-webdriver":"^4.1.28"},"_npmOperationalInternal":{"tmp":"tmp/mcp-selenium_1.0.2_1752888703486_0.06785463728464958","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@sirblob/mcp-selenium","version":"1.0.3","description":"Selenium WebDriver MCP Server","author":{"name":"SirBlobby"},"license":"MIT","type":"module","main":"dist/src/server.js","bin":{"mcp-selenium":"dist/bin/mcp-selenium.js"},"scripts":{"build":"tsc","start":"node dist/src/server.js","dev":"tsc --watch","clean":"rm -rf dist"},"dependencies":{"@modelcontextprotocol/sdk":"^1.16.0","selenium-webdriver":"^4.34.0","zod":"^3.25.76"},"devDependencies":{"@types/node":"^24.0.14","@types/selenium-webdriver":"^4.1.28","typescript":"^5.8.3"},"homepage":"https://github.com/SirBlobby/mcp-selenium#readme","repository":{"type":"git","url":"git+https://github.com/SirBlobby/mcp-selenium.git"},"bugs":{"url":"https://github.com/SirBlobby/mcp-selenium/issues"},"keywords":["selenium","webdriver","mcp","modelcontextprotocol","automation","browser-automation"],"_id":"@sirblob/mcp-selenium@1.0.3","gitHead":"8cdede55293f0a5582a77121d275df3d2d01e3a2","_nodeVersion":"22.14.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-J4ZwaRXtxUk/FYOW+sZBca4mpFp01ohKvZ/PjM3Zw2MvbuV/NC6QhxBVQvqKltG6Iq8ulqN3yWx5foBkbR+Hvg==","shasum":"0c9c34800c7d1d4c6662f532843d24b740363cd1","tarball":"https://registry.npmjs.org/@sirblob/mcp-selenium/-/mcp-selenium-1.0.3.tgz","fileCount":21,"unpackedSize":108850,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDGIQR511hXczUDBUHl3a7EGEs5CQ3erO26GyKgW5TSGAIhAODo+gipHuMB8YevV3Nb9LNFSrUQlGoEwPymW4LG6iF/"}]},"_npmUser":{"name":"sir_blob","email":"adithcool.5@gmail.com"},"directories":{},"maintainers":[{"name":"sir_blob","email":"adithcool.5@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-selenium_1.0.3_1752888905976_0.4102179038460574"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-18T20:42:51.710Z","modified":"2025-07-19T01:35:06.323Z","0.2.0":"2025-07-18T20:42:52.003Z","0.2.1":"2025-07-18T20:44:21.693Z","1.0.0":"2025-07-19T01:28:49.274Z","1.0.1":"2025-07-19T01:29:56.601Z","1.0.2":"2025-07-19T01:31:43.668Z","1.0.3":"2025-07-19T01:35:06.152Z"},"bugs":{"url":"https://github.com/SirBlobby/mcp-selenium/issues"},"author":{"name":"SirBlobby"},"license":"MIT","homepage":"https://github.com/SirBlobby/mcp-selenium#readme","keywords":["selenium","webdriver","mcp","modelcontextprotocol","automation","browser-automation"],"repository":{"type":"git","url":"git+https://github.com/SirBlobby/mcp-selenium.git"},"description":"Selenium WebDriver MCP Server","maintainers":[{"name":"sir_blob","email":"adithcool.5@gmail.com"}],"readme":"# MCP Selenium\r\n\r\nA comprehensive Model Context Protocol (MCP) server implementation for Selenium WebDriver, enabling advanced browser automation through standardized MCP clients like Claude Desktop and other MCP-compatible applications.\r\n\r\n**This allows AI assistants to control web browsers programmatically with 80+ automation tools.**\r\n\r\n<img style=\"display: inline-block;\" src=\"https://img.shields.io/npm/v/@sirblob/mcp-selenium\">\r\n<img style=\"display: inline-block;\" src=\"https://img.shields.io/npm/dt/@sirblob/mcp-selenium\" >\r\n<img style=\"display: inline-block;\" src=\"https://img.shields.io/github/issues/SirBlobby/mcp-selenium\" >\r\n\r\n## Installation\r\n\r\nInstall the package using npm:\r\n```bash\r\nnpm install @sirblob/mcp-selenium\r\n```\r\n\r\nInstall the package using pnpm:\r\n```bash\r\npnpm install @sirblob/mcp-selenium\r\n```\r\n\r\n## Usage\r\n\r\nAdd to your MCP client configuration:\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"selenium\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@sirblob/mcp-selenium\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Supported Browsers\r\n- **Chrome** - Full feature support including headless mode\r\n- **Firefox** - Full feature support including headless mode  \r\n- **Edge** - Full feature support including headless mode\r\n- **Safari** - Basic feature support (limited options)\r\n\r\n## Available Tools\r\n\r\n### Browser Management\r\n- **start_browser** - Launches a browser (Chrome, Firefox, Edge, or Safari) with optional configuration\r\n- **navigate** - Navigates to a specified URL\r\n- **close_session** - Closes the current browser session\r\n- **get_browser_status** - Gets the status of the current browser session\r\n\r\n### Element Finding and Interaction\r\n- **find_element** - Finds an element using various locator strategies\r\n- **click_element** - Clicks on an element\r\n- **send_keys** - Sends text input to an element (typing)\r\n- **get_element_text** - Gets the text content of an element\r\n- **get_element_source** - Gets the HTML source code of an element and all its child elements\r\n- **upload_file** - Uploads a file using a file input element\r\n- **find_elements_by_xpath** - Finds multiple elements using XPath\r\n- **scroll_to_element** - Scrolls to bring an element into view\r\n- **highlight_element** - Highlights an element with a colored border for debugging\r\n- **find_parent_element** - Finds the parent element of a given element\r\n- **find_sibling_element** - Finds sibling elements of a given element\r\n\r\n### Select Element Tools\r\n- **select_option_by_text** - Selects an option in a select element by its visible text\r\n- **select_option_by_value** - Selects an option in a select element by its value attribute\r\n- **select_option_by_index** - Selects an option in a select element by its index\r\n- **get_select_options** - Gets all available options from a select element\r\n- **get_selected_option** - Gets the currently selected option from a select element\r\n\r\n### Table Element Tools\r\n- **get_table_data** - Extracts all data from a table element\r\n- **get_table_cell** - Gets the content of a specific table cell by row and column\r\n- **click_table_cell** - Clicks on a specific table cell by row and column\r\n- **get_table_row_count** - Gets the number of rows in a table\r\n- **get_table_column_count** - Gets the number of columns in a table\r\n- **find_table_row_by_text** - Finds a table row that contains specific text\r\n\r\n### List Element Tools\r\n- **get_list_items** - Gets all items from a list element (ul or ol)\r\n- **get_list_item** - Gets a specific list item by index\r\n- **click_list_item** - Clicks on a specific list item by index\r\n- **click_list_item_by_text** - Clicks on a list item that contains specific text\r\n- **find_list_item_by_text** - Finds the index of a list item that contains specific text\r\n- **get_list_item_count** - Gets the number of items in a list\r\n- **get_nested_lists** - Gets information about nested lists within a list\r\n- **filter_list_items** - Filters list items based on text criteria\r\n\r\n### Element State and Properties\r\n- **get_element_attribute** - Gets an attribute value from an element\r\n- **get_element_css_property** - Gets a CSS property value from an element\r\n- **is_element_displayed** - Checks if an element is visible\r\n- **is_element_enabled** - Checks if an element is enabled/interactive\r\n- **is_element_selected** - Checks if an element is selected (for checkboxes, radio buttons)\r\n\r\n### Mouse and Keyboard Interactions\r\n- **hover** - Moves the mouse to hover over an element\r\n- **hover_element** - Alternative hover command for element interaction\r\n- **drag_and_drop** - Drags an element to another location\r\n- **double_click** - Double-clicks an element\r\n- **right_click** - Right-clicks an element (context menu)\r\n- **send_key_combination** - Sends keyboard combinations (Ctrl+C, Alt+Tab, etc.)\r\n- **press_key** - Simulates pressing a single keyboard key\r\n\r\n### Page Actions\r\n- **take_screenshot** - Captures a screenshot of the current page and saves it to the current directory with timestamp\r\n- **get_page_title** - Gets the current page title\r\n- **get_title** - Alternative method to get the current page title\r\n- **get_current_url** - Gets the current page URL\r\n- **get_page_source** - Gets the complete HTML source of the page\r\n- **page_source** - Alternative method to get the complete HTML source of the page\r\n- **refresh_page** - Refreshes the current page\r\n- **go_back** - Navigates back in browser history\r\n- **go_forward** - Navigates forward in browser history\r\n\r\n### JavaScript Execution\r\n- **execute_javascript** - Executes JavaScript code in the browser\r\n- **execute_async_javascript** - Executes asynchronous JavaScript with callback support\r\n\r\n### Scrolling\r\n- **scroll_to_element** - Scrolls to bring an element into view\r\n- **scroll_element_into_view** - Alternative method to scroll an element into view\r\n- **scroll_by_pixels** - Scrolls by a specified number of pixels\r\n- **scroll_to_coordinates** - Scrolls to specific coordinates on the page\r\n- **scroll_to_top** - Scrolls to the top of the page\r\n- **scroll_to_bottom** - Scrolls to the bottom of the page\r\n\r\n### Window Management\r\n- **get_window_size** - Gets the current window dimensions\r\n- **set_window_size** - Sets the window size\r\n- **maximize_window** - Maximizes the browser window\r\n- **get_window_handles** - Gets all open window handles\r\n- **switch_to_window** - Switches to a specific window by handle\r\n- **switch_to_window_by_title** - Switches to a window/tab by its title\r\n- **switch_to_window_by_url** - Switches to a window/tab by its URL\r\n- **close_window** - Closes the current window\r\n- **switch_to_frame** - Switches to a frame by ID or name\r\n- **switch_to_default_content** - Switches back to the main document\r\n\r\n### Cookie Management\r\n- **get_cookies** - Gets all cookies for the current domain\r\n- **add_cookie** - Adds a new cookie\r\n- **delete_cookie** - Deletes a specific cookie\r\n- **delete_all_cookies** - Deletes all cookies\r\n\r\n### XPath Tools\r\n- **evaluate_xpath** - Evaluates an XPath expression and returns the result\r\n- **count_elements_by_xpath** - Counts elements matching an XPath expression\r\n- **get_xpath_text_content** - Gets text content from elements matching XPath\r\n- **get_element_source_by_xpath** - Gets HTML source of elements matching XPath\r\n- **get_element_xpath** - Gets the XPath of an element\r\n- **get_elements_xpath** - Gets XPath expressions for multiple elements\r\n- **get_element_attribute_by_xpath** - Gets an attribute value from an element using XPath\r\n- **find_element_by_xpath_attribute** - Finds elements by XPath and attribute values\r\n- **find_element_by_xpath_index** - Finds an element by XPath at a specific index\r\n- **click_element_by_xpath_text** - Clicks an element found by XPath containing specific text\r\n\r\n## Advanced Element Operations\r\n\r\n### Element State and Properties\r\n- **get_element_attribute** - Gets an attribute value from an element\r\n- **get_element_css_property** - Gets a CSS property value from an element\r\n- **is_element_displayed** - Checks if an element is visible\r\n- **is_element_enabled** - Checks if an element is enabled/interactive\r\n- **is_element_selected** - Checks if an element is selected (for checkboxes, radio buttons)\r\n\r\n## Configuration Parameters\r\n\r\n### Browser Options\r\nConfigure browser behavior with optional parameters:\r\n```json\r\n{\r\n  \"headless\": false,\r\n  \"arguments\": [\"--window-size=1920,1080\", \"--disable-web-security\", \"--disable-dev-shm-usage\"]\r\n}\r\n```\r\n\r\n**Common Browser Arguments:**\r\n- `--headless=new` - Run in headless mode (Chrome/Edge)\r\n- `--window-size=width,height` - Set initial window size\r\n- `--disable-web-security` - Disable CORS restrictions\r\n- `--disable-dev-shm-usage` - Overcome limited resource problems\r\n- `--no-sandbox` - Disable sandbox (useful in containerized environments)\r\n- `--disable-gpu` - Disable GPU hardware acceleration\r\n\r\n### Locator Strategies\r\nMultiple ways to find elements on the page:\r\n- **id** - Find by element ID (`<div id=\"myElement\">`)\r\n- **css** - Find by CSS selector (`div.class-name`, `#id-name`)\r\n- **xpath** - Find by XPath expression (`//div[@class='example']`)\r\n- **name** - Find by name attribute (`<input name=\"username\">`)\r\n- **tag** - Find by HTML tag name (`div`, `span`, `input`)\r\n- **class** - Find by class name (`class-name`)\r\n\r\n### Timeout Configuration\r\nMost tools accept an optional `timeout` parameter (default: 10000ms):\r\n```json\r\n{\r\n  \"by\": \"id\",\r\n  \"value\": \"submit-button\",\r\n  \"timeout\": 15000\r\n}\r\n```\r\n\r\n### Requirements\r\n- **Node.js** 22+ \r\n- **npm** or **pnpm**\r\n- **Browser drivers** (automatically managed by Selenium)\r\n- **TypeScript** 5.0+ (dev dependency)\r\n\r\n## Troubleshooting\r\n\r\n### Common Issues\r\n- **Driver not found**: Selenium automatically downloads drivers, but ensure you have the target browser installed\r\n- **Permission errors**: On Linux, you may need to install browser packages (`chromium-browser`, `firefox`, etc.)\r\n- **Timeout errors**: Increase timeout values for slow-loading pages\r\n- **Headless mode issues**: Some features may not work in headless mode (file uploads, certain interactions)\r\n\r\n### Platform-Specific Notes\r\n- **macOS**: Safari requires enabling automation in Safari preferences\r\n- **Linux**: May require additional dependencies for GUI browsers\r\n- **Windows**: Should work out of the box with standard browser installations\r\n\r\n## License\r\nMIT License - see [LICENSE](LICENSE) file for details.\r\n\r\n## Acknowledgements\r\nInspired by [@angiejones/mcp-selenium](https://github.com/angiejones/mcp-selenium)\r\n","readmeFilename":"README.md"}