.codex-plugin/plugin.json

{
  "author": {
    "name": "Browserless"
  },
  "description": "Read the public web with a real cloud browser. Summarize a page or list its links, search the web for sources and recent news, list the pages on a website, fetch a page's HTML, JSON or XML source, or run a Lighthouse audit for performance, accessibility and SEO scores.\n\nBuilt for developers, analysts and researchers. Requires a Browserless account.",
  "interface": {
    "capabilities": [
      "Read web pages",
      "Search the web",
      "List a website's pages",
      "Export page source",
      "Run Lighthouse audits"
    ],
    "category": "Developer Tools",
    "defaultPrompt": [
      "Read https://example.com and summarize what the page says.",
      "Search the web for the Node.js release schedule and list the top three sources.",
      "Run a Lighthouse audit on https://example.com and tell me the performance and SEO scores."
    ],
    "developerName": "Browserless",
    "displayName": "Browserless",
    "longDescription": "Read the public web with a real cloud browser. Summarize a page or list its links, search the web for sources and recent news, list the pages on a website, fetch a page's HTML, JSON or XML source, or run a Lighthouse audit for performance, accessibility and SEO scores.\n\nBuilt for developers, analysts and researchers. Requires a Browserless account.",
    "privacyPolicyURL": "https://www.browserless.io/mcp/privacy",
    "shortDescription": "Read and search the web",
    "supportURL": "https://www.browserless.io/contact",
    "termsOfServiceURL": "https://www.browserless.io/terms-of-service",
    "websiteURL": "https://www.browserless.io/",
    "logo": "./assets/logo.png",
    "logoDark": "./assets/logo-dark.png",
    "composerIcon": "./assets/composer-icon.png",
    "composerIconDark": "./assets/composer-icon-dark.png"
  },
  "name": "browserless",
  "version": "1.1.0",
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read a public page and summarize it",
              "prompt": "Read https://example.com and summarize what the page says.",
              "tools_triggered": "browserless_read_page",
              "expected_behavior": "Calls browserless_read_page for https://example.com and summarizes the page: example.com is a placeholder domain for use in documentation examples and isn't meant to be relied on as a real service."
            },
            {
              "description": "Search the web for sources on a topic",
              "prompt": "Search the web for the Node.js release schedule and list the top three sources.",
              "tools_triggered": "browserless_search",
              "expected_behavior": "Calls browserless_search and lists three relevant results with their titles and links, such as the Node.js releases page on nodejs.org and the nodejs/Release repository on GitHub."
            },
            {
              "description": "List the pages on a website that match a topic",
              "prompt": "List the pages on https://docs.browserless.io that are about MCP.",
              "tools_triggered": "browserless_map",
              "expected_behavior": "Calls browserless_map for https://docs.browserless.io with an MCP search phrase and lists docs.browserless.io URLs about MCP, such as the MCP server setup, Connector and Browser Agent pages."
            },
            {
              "description": "Export a page's HTML source",
              "prompt": "Export https://example.com and tell me the page title.",
              "tools_triggered": "browserless_export",
              "expected_behavior": "Calls browserless_export for https://example.com, receives the page's HTML source and reports that the title is Example Domain."
            },
            {
              "description": "Run a Lighthouse audit",
              "prompt": "Run a Lighthouse audit on https://example.com and tell me the performance and SEO scores.",
              "tools_triggered": "browserless_performance",
              "expected_behavior": "Calls browserless_performance for https://example.com, shows the Lighthouse scorecard and states the Performance and SEO scores out of 100."
            }
          ],
          "negative": [
            {
              "description": "Signing in and buying are out of scope. The tools only read public pages and can't sign in, click or purchase, so the plugin should not be used and ChatGPT should explain that it can't do this.",
              "prompt": "Log in to my Amazon account and reorder my last purchase."
            },
            {
              "description": "Submitting a form changes data on a third-party site. Every tool is read-only, so the plugin should decline rather than attempt it.",
              "prompt": "Fill in the contact form on https://example.com with my name and email and submit it."
            },
            {
              "description": "The plugin has no access to Browserless account, usage or billing data, so it should say it can't answer instead of guessing.",
              "prompt": "How many Browserless units have I used this month?"
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=mJ4WGs896j0",
        "commerce": false,
        "commerce_description": "Browserless doesn't sell products or process payments in ChatGPT."
      },
      "publication": {
        "release_notes": "Version 1.1.0 exposes every operation as its own read-only tool with a clear description, input schema and explicit annotations: read a page, search the web, list a site's pages, export a page's source, and run a Lighthouse audit. The general-purpose browser agent, the skill library and the account tools were removed."
      }
    }
  },
  "apps": "./.app.json"
}