Metadata-Version: 2.4
Name: readystack-epub-a11y-metadata-lint
Version: 1.0.5
Summary: 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 (bundled Node.js runtime)
Author-email: ReadyStack <support@getreadystack.com>
License: Proprietary - see LICENSE.txt
Project-URL: Homepage, https://getreadystack.com/tools/epub-a11y-metadata-lint?ref=pypi
Project-URL: Documentation, https://getreadystack.com/tools/epub-a11y-metadata-lint?ref=pypi
Project-URL: Support, https://getreadystack.com/support
Keywords: epub,accessibility,publishing,eaa,metadata,ebook,onix
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: nodejs-wheel-binaries>=20
Dynamic: license-file

# EPUB Accessibility Metadata Lint (EAA)

> Runs the same checker as the npm package `@readystack/epub-a11y-metadata-lint` on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.

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

## Install

```
epub-a11y-metadata-lint file
```

Node 18+. The same 18 rules as the VS Code extension, from a terminal or CI.

## 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.

```
@readystack/epub-a11y-metadata-lint --dir ./templates --report html --out report.html
```

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:

```json
{ "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 agent gets every finding with the line number.

## Use in CI

```yaml
- 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`)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.

[Get a licence](https://buy.polar.sh/polar_cl_oPMAjVdCsJ3pQdXfabWNj50DOpyh2wFYTMd6w11o7Aj)


<!-- epub a11y metadata lint -->


## Install (PyPI)

```
pip install readystack-epub-a11y-metadata-lint
epub-a11y-metadata-lint --help
```
