scrapeless-mcp-server 0.4.2 → 0.4.3

package/README.md

@@ -64,6 +64,9 @@ This project provides several MCP servers that enable AI assistants like Claude
 - `browser_scroll_to`
   Scroll a specific element into view.
 
+- `browser_press_key`
+  Simulate a key press.
+
 ### Universal Tools
 
 - `scrape_html`

package/build/tools/browser/browser.js

@@ -442,3 +442,42 @@ export const browserScrollTo = defineTool({
         }
     },
 });
+export const browserPressKey = defineTool({
+    name: "browser_press_key",
+    description: `Simulate a key press.
+    Restrictions: Must specify a valid key name; optional target selector.
+    Valid: Press Enter in #search.
+    Invalid: Press a key without specifying the key name.`,
+    inputSchema: {
+        selector: z.string().describe("The CSS selector of the element to focus.").optional(),
+        key: z.string().describe('Name of the key to press or a character to generate, such as `ArrowLeft` or `a`'),
+    },
+    handle: async (context, params) => {
+        const session = context.getSession(params.sessionId);
+        if (!session?.page) {
+            return wrapMcpBrowserResponse("No active browser session found. Please create a browser session first.");
+        }
+        try {
+            if (params.selector) {
+                await session.page.focus(params.selector);
+            }
+            await session.page.keyboard.press(params.key);
+            const accessibilitySnapshot = await snapshot(session.page);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: params.selector ? `Focus on the ${params.selector} and press ${params.key}` : `press ${params.key}`,
+                    },
+                    {
+                        type: "text",
+                        text: accessibilitySnapshot,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return wrapMcpBrowserResponse(`Failed to press key: ${error.message}`);
+        }
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeless-mcp-server",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "main": "index.js",
   "type": "module",
   "bin": {