# Button Accessible Name Auditor (`phoenix2810/button-accessible-name-auditor`) Actor Audit one public page for buttons missing accessible names. Checks native buttons, button inputs, role=button controls, score, and accessibility fixes. - **URL**: https://apify.com/phoenix2810/button-accessible-name-auditor.md - **Developed by:** [Sanskar Jaiswal](https://apify.com/phoenix2810) (community) - **Categories:** SEO tools, Developer tools, Open source - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Button Accessible Name Auditor Button Accessible Name Auditor checks one public web page for buttons and `role="button"` controls missing accessible names. It returns structured JSON for accessibility QA, SEO agency reports, launch checks, and scheduled template monitoring. ### Use cases - Audit icon buttons, menu buttons, dialog controls, and calls to action before launch. - Add focused accessibility checks to site migration and CMS template QA. - Monitor high-value pages for regressions after design changes. - Feed button accessibility results into dashboards, QA workflows, and issue triage. ### Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `startUrl` | string | Yes | Public HTTP or HTTPS page URL to audit. Credentials and private network targets are rejected. | | `timeoutSeconds` | integer | No | Request timeout for the page fetch. Default: `10`, range: `3` to `30`. | | `maxButtons` | integer | No | Maximum buttons and unnamed buttons to include in the dataset item. Default: `50`, range: `1` to `200`. | ### Output The actor pushes one dataset item per run. | Field | Type | Description | | --- | --- | --- | | `inputUrl` | string | Original submitted URL. | | `normalizedInputUrl` | string | URL after adding a default scheme if needed. | | `finalUrl` | string | Final URL after safe redirects. | | `status` | integer or null | HTTP status from the page fetch. | | `ok` | boolean | True when the page was fetched and all detected buttons have accessible names. | | `checkedAt` | string | ISO timestamp for the audit. | | `buttonCount` | integer | Number of native buttons, button inputs, and `role="button"` controls checked. | | `namedCount` | integer | Number of checked buttons with an accessible name. | | `unnamedButtonCount` | integer | Number of checked buttons without an accessible name. | | `accessibleNameCoveragePercent` | integer | Percentage of checked buttons with accessible names. | | `buttons` | array | Sample of checked buttons with tag, type, id, class, role, accessible name signals, and status. | | `unnamedButtons` | array | Sample of buttons missing accessible names. | | `score` | integer | Readiness score from 0 to 100. | | `grade` | string | Letter grade from A to F. | | `issues` | array | Human-readable findings. | | `recommendations` | array | Actionable fixes. | | `error` | string or null | Fetch or validation error when present. | ### Example input ```json { "startUrl": "https://example.com/pricing", "timeoutSeconds": 10, "maxButtons": 50 } ```` ### Example output ```json { "inputUrl": "https://example.com/pricing", "normalizedInputUrl": "https://example.com/pricing", "finalUrl": "https://example.com/pricing", "status": 200, "ok": false, "checkedAt": "2026-07-18T00:00:00.000Z", "buttonCount": 2, "namedCount": 1, "unnamedButtonCount": 1, "accessibleNameCoveragePercent": 50, "buttons": [ { "tag": "button", "type": "button", "id": null, "className": "icon-close", "role": null, "hasAriaLabel": false, "hasAriaLabelledby": false, "hasVisibleText": false, "accessibleName": null, "ok": false } ], "unnamedButtons": [], "score": 80, "grade": "B", "issues": ["1 button(s) lack an accessible name"], "recommendations": ["Add button text, aria-label, aria-labelledby, value, or alt text for icon/image buttons."], "error": null } ``` ### Security - Fetches only public HTTP and HTTPS URLs. - Rejects URL credentials. - Blocks localhost, private IPv4 ranges, link-local IPv4, loopback, private IPv6, and link-local IPv6 targets. - Resolves hostnames before fetching and blocks DNS results that point to private networks. - Revalidates redirects before following them. - Reads a bounded response body to avoid oversized page runs. ### Pricing Suggested pay-per-event pricing: | Event | Suggested price | | --- | ---: | | Actor start | `$0.005` | | Page audited | `$0.01` | Typical one-page run cost: about `$0.015` before Apify platform charges. Apify keeps its standard commission and the actor owner receives the remainder. ### FAQ #### Does this replace a full accessibility audit? No. It checks one high-signal button-name issue on one page. Use it as a lightweight API check alongside broader accessibility testing. #### Does it execute JavaScript or click buttons? No. It fetches static HTML and parses buttons. It does not click, type, submit, or execute browser automation. #### What counts as an accessible name? The actor treats visible button text, `aria-label`, `aria-labelledby`, `value`, `alt`, and `title` as naming signals for this focused static check. #### Can it crawl a whole site? No. It audits one submitted page. Schedule multiple runs or pass pages through your own queue when site-wide coverage is needed. # Actor input Schema ## `startUrl` (type: `string`): Public HTTP or HTTPS page URL to audit. Credentials and private network targets are rejected. ## `timeoutSeconds` (type: `integer`): Request timeout for the page fetch. ## `maxButtons` (type: `integer`): Maximum buttons and unnamed buttons to include in the dataset item. ## Actor input object example ```json { "startUrl": "https://example.com", "timeoutSeconds": 10, "maxButtons": 50 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrl": "https://example.com" }; // Run the Actor and wait for it to finish const run = await client.actor("phoenix2810/button-accessible-name-auditor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrl": "https://example.com" } # Run the Actor and wait for it to finish run = client.actor("phoenix2810/button-accessible-name-auditor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrl": "https://example.com" }' | apify call phoenix2810/button-accessible-name-auditor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=phoenix2810/button-accessible-name-auditor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Button Accessible Name Auditor", "description": "Audit one public page for buttons missing accessible names. Checks native buttons, button inputs, role=button controls, score, and accessibility fixes.", "version": "0.1", "x-build-id": "AYOaVcfoeUfU2cloD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/phoenix2810~button-accessible-name-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-phoenix2810-button-accessible-name-auditor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/phoenix2810~button-accessible-name-auditor/runs": { "post": { "operationId": "runs-sync-phoenix2810-button-accessible-name-auditor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/phoenix2810~button-accessible-name-auditor/run-sync": { "post": { "operationId": "run-sync-phoenix2810-button-accessible-name-auditor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrl" ], "properties": { "startUrl": { "title": "Page URL", "type": "string", "description": "Public HTTP or HTTPS page URL to audit. Credentials and private network targets are rejected." }, "timeoutSeconds": { "title": "Timeout seconds", "minimum": 3, "maximum": 30, "type": "integer", "description": "Request timeout for the page fetch.", "default": 10 }, "maxButtons": { "title": "Max buttons in output", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum buttons and unnamed buttons to include in the dataset item.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```