chromeflow 0.1.33 → 0.1.35

package/CLAUDE.md

@@ -149,4 +149,38 @@ screenshot to check what happened.
 
 **Waiting for async results** (build, save, deploy): `wait_for_selector(selector, timeout)` — never poll with screenshots.
 
+**React Select / custom styled dropdowns** (e.g. "Select..." components on DataAnnotation):
+`click_element` and `fill_input` do NOT work on these — they intercept native events. Use
+`execute_script` directly:
+
+```js
+// 1. Open the menu — click the control div (filter by pageY if multiple)
+var controls = document.querySelectorAll('[class*="control"]');
+controls[N].click();
+
+// 2. Pick an option by exact text
+var allEls = document.querySelectorAll('*');
+for (var i = 0; i < allEls.length; i++) {
+  if (allEls[i].textContent.trim() === 'Target Option' && allEls[i].children.length === 0) {
+    allEls[i].dispatchEvent(new MouseEvent('mousedown', {bubbles: true}));
+    allEls[i].click();
+    break;
+  }
+}
+
+// 3. Verify
+controls[N].textContent.trim(); // should show selected value
+```
+
+**Page content rendered as images** (e.g. qualification "Examples" tabs that show PNG screenshots
+instead of DOM text): `get_page_text()` returns nothing useful. Zoom out and screenshot instead:
+
+```js
+// Shrink to fit wide content, then screenshot
+document.body.style.zoom = '0.4';
+// use take_and_copy_screenshot() to read it
+// restore afterward:
+document.body.style.zoom = '1';
+```
+
 **Never use Bash to work around a stuck browser interaction.**

package/dist/tools/browser.js

@@ -6,7 +6,7 @@ import { execSync } from "child_process";
 function registerBrowserTools(server, bridge) {
   server.tool(
     "open_page",
-    "Navigate to a URL. By default reuses the active tab. Set new_tab=true to open alongside the current tab without losing it.",
+    "Navigate to a URL. By default reuses the active tab. Set new_tab=true to open alongside the current tab without losing it. After navigating, call get_page_text to read the page \u2014 do NOT take a screenshot.",
     {
       url: z.string().url().describe("The URL to navigate to"),
       new_tab: z.boolean().optional().describe("Open in a new tab instead of replacing the current one (default false)")
@@ -50,7 +50,7 @@ ${lines.join("\n")}` }]
   );
   server.tool(
     "take_screenshot",
-    "Capture a screenshot and return it to Claude only \u2014 no file is saved, nothing goes to the clipboard. Use ONLY when you need to visually inspect the page layout or get pixel coordinates for highlight_region. DO NOT use to check page state or confirm actions \u2014 use get_page_text for that. To also save or copy the image, use take_and_copy_screenshot instead.",
+    "Capture a screenshot of the current page. IMPORTANT: Do NOT use this to read page content or check what is on the page \u2014 call get_page_text instead, which is faster and returns searchable text. Screenshots are ONLY for locating a specific element's pixel coordinates when get_elements has already failed. Never take a screenshot immediately after open_page, scroll_page, or click_element \u2014 always use get_page_text after those actions. Never take more than 1-2 screenshots in a row. To also save or copy the image, use take_and_copy_screenshot instead.",
     {},
     async () => {
       const response = await bridge.request({ type: "screenshot" });

package/dist/tools/flow.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 function registerFlowTools(server, bridge) {
   server.tool(
     "scroll_page",
-    "Scroll the page or the focused panel up or down. Use this when the target location is unknown. If you know which field or element you need, use scroll_to_element instead \u2014 it scrolls precisely without guessing. After scrolling, retry click_element or fill_input.",
+    "Scroll the page or the focused panel up or down. Use this when the target location is unknown. If you know which field or element you need, use scroll_to_element instead \u2014 it scrolls precisely without guessing. After scrolling, call get_page_text to read the new content \u2014 NEVER call take_screenshot after scrolling.",
     {
       direction: z.enum(["down", "up"]).describe("Scroll direction"),
       amount: z.number().optional().describe("Pixels to scroll (default 400)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromeflow",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Browser guidance MCP server for Claude Code — highlights, clicks, fills, and captures from the web so you don't have to.",
   "type": "module",
   "bin": {