getreadystack/epub-a11y-metadata-lint repository overview

⁠EPUB Accessibility Metadata Lint (EAA)

18 rules over the accessibility metadata in your .opf: 12 findings in the sample file, 9 of them errors, 6 of them invented or malformed values

⁠Run

docker run --rm -v "$PWD":/work getreadystack/epub-a11y-metadata-lint /work/file

The same 18 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠Free

• Lints the .opf you have open with all 18 rules and names every missing, mistyped or self-contradicting accessibility metadata value with the exact line to paste. The sample file returns 12 findings, 9 of them errors, 6 of them invented or malformed values such as altText, sight and noFlashing.
• --rules lists every rule

⁠With a licence ($29 once)

• Sweeps every .opf in a catalogue folder in one run and writes a dated pass/fail report per title, the document a distributor or retailer asks for. Different axis from the free layer: scope and a file you keep, not a bigger version of the same check.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/epub-a11y-metadata-lint --dir /work --ci

An EPUB production freelancer bills $50 to $95 an hour.

⁠Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "epub-a11y-metadata-lint": { "command": "npx", "args": ["-y", "@readystack/epub-a11y-metadata-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence; the full sweep is free for 7 days). The agent gets every finding with the line number.

⁠Use in CI

- name: EPUB Accessibility Metadata Lint (EAA)
  run: npx -y @readystack/epub-a11y-metadata-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/epub-a11y-metadata-lint --dir /work --ci)

Try the full run free for 7 days — no key needed. Then one licence, 7-day refund, no questions. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠