browser_click_text

Instructions

Implementation Reference

• index.ts:22-33 (registration)

  Tool name enum definition for browser_click_text

  enum ToolName {
    BrowserNavigate = "browser_navigate",
    BrowserScreenshot = "browser_screenshot",
    BrowserClick = "browser_click",
    BrowserClickText = "browser_click_text",
    BrowserFill = "browser_fill",
    BrowserSelect = "browser_select",
    BrowserSelectText = "browser_select_text",
    BrowserHover = "browser_hover",
    BrowserHoverText = "browser_hover_text",
    BrowserEvaluate = "browser_evaluate"
  }

• index.ts:72-82 (schema)

  Input schema for browser_click_text tool - accepts a 'text' string parameter

  {
    name: ToolName.BrowserClickText,
    description: "Click an element on the page by its text content",
    inputSchema: {
      type: "object",
      properties: {
        text: { type: "string", description: "Text content of the element to click" },
      },
      required: ["text"],
    },
  },

• index.ts:275-314 (handler)

  Handler implementation: uses page.getByText(args.text).click() to find and click an element by its visible text content, with strict mode violation retry logic

  case ToolName.BrowserClickText:
    try {
      await page.getByText(args.text).click();
      return {
        content: [{
          type: "text",
          text: `Clicked element with text: ${args.text}`,
        }],
        isError: false,
      };
    } catch (error) {
      if((error as Error).message.includes("strict mode violation")) {
          console.log("Strict mode violation, retrying on first element...");
          try {
              await page.getByText(args.text).first().click();
              return {
                  content: [{
                      type: "text",
                      text: `Clicked element with text: ${args.text}`,
                  }],
                  isError: false,
              };
          } catch (error) {
              return {
                  content: [{
                      type: "text",
                      text: `Failed (twice) to click element with text ${args.text}: ${(error as Error).message}`,
                  }],
                  isError: true,
              };
          }
      }
      return {
        content: [{
          type: "text",
          text: `Failed to click element with text ${args.text}: ${(error as Error).message}`,
        }],
        isError: true,
      };
    }

• index.ts:36-152 (registration)

  TOOLS array registration including BrowserClickText as part of the tool list

  const TOOLS: Tool[] = [
    {
      name: ToolName.BrowserNavigate,
      description: "Navigate to a URL",
      inputSchema: {
        type: "object",
        properties: {
          url: { type: "string" },
        },
        required: ["url"],
      },
    },
    {
      name: ToolName.BrowserScreenshot,
      description: "Take a screenshot of the current page or a specific element",
      inputSchema: {
        type: "object",
        properties: {
          name: { type: "string", description: "Name for the screenshot" },
          selector: { type: "string", description: "CSS selector for element to screenshot" },
          fullPage: { type: "boolean", description: "Take a full page screenshot (default: false)", default: false },
        },
        required: ["name"],
      },
    },
    {
      name: ToolName.BrowserClick,
      description: "Click an element on the page using CSS selector",
      inputSchema: {
        type: "object",
        properties: {
          selector: { type: "string", description: "CSS selector for element to click" },
        },
        required: ["selector"],
      },
    },
    {
      name: ToolName.BrowserClickText,
      description: "Click an element on the page by its text content",
      inputSchema: {
        type: "object",
        properties: {
          text: { type: "string", description: "Text content of the element to click" },
        },
        required: ["text"],
      },
    },
    {
      name: ToolName.BrowserFill,
      description: "Fill out an input field",
      inputSchema: {
        type: "object",
        properties: {
          selector: { type: "string", description: "CSS selector for input field" },
          value: { type: "string", description: "Value to fill" },
        },
        required: ["selector", "value"],
      },
    },
    {
      name: ToolName.BrowserSelect,
      description: "Select an element on the page with Select tag using CSS selector",
      inputSchema: {
        type: "object",
        properties: {
          selector: { type: "string", description: "CSS selector for element to select" },
          value: { type: "string", description: "Value to select" },
        },
        required: ["selector", "value"],
      },
    },
    {
      name: ToolName.BrowserSelectText,
      description: "Select an element on the page with Select tag by its text content",
      inputSchema: {
        type: "object",
        properties: {
          text: { type: "string", description: "Text content of the element to select" },
          value: { type: "string", description: "Value to select" },
        },
        required: ["text", "value"],
      },
    },
    {
      name: ToolName.BrowserHover,
      description: "Hover an element on the page using CSS selector",
      inputSchema: {
        type: "object",
        properties: {
          selector: { type: "string", description: "CSS selector for element to hover" },
        },
        required: ["selector"],
      },
    },
    {
      name: ToolName.BrowserHoverText,
      description: "Hover an element on the page by its text content",
      inputSchema: {
        type: "object",
        properties: {
          text: { type: "string", description: "Text content of the element to hover" },
        },
        required: ["text"],
      },
    },
    {
      name: ToolName.BrowserEvaluate,
      description: "Execute JavaScript in the browser console",
      inputSchema: {
        type: "object",
        properties: {
          script: { type: "string", description: "JavaScript code to execute" },
        },
        required: ["script"],
      },
    },
  ];