Developers
Run the audit from your terminal or your CI
The same engine behind the free audit, as a dependency-free Node CLI and a GitHub Action. MIT licensed, code on GitHub.
CLI
npx @alttextfix/cli https://yourstore.com
Handmade Ceramic Jewelry | Clayometry
19 images · 5 with no text alternative · 1 with weak alt text · 13 fine
- (empty) [empty]
https://…/category/clayometry-shop-earrings-144x144.webp
→ Close-up of an ear wearing a gold-tone hoop earring with a dark circular center.
Exit code is 1 when there is missing or weak alt text, so it drops straight into a pipeline. --no-describe skips the model call and only counts and flags what is there (instant, free). --csv alt-text.csv writes the same file the paid run produces.
GitHub Action
- uses: ascelio-co/beta-alttext-cli@v0
with:
url: https://your-preview-url.example.com
limit: 20
fail-on-missing: 0 # set > 0 to start failing the build
The step writes a table plus a sample of rewritten alt text into the job summary, and exposes missing and weak as outputs. Point it at a preview deployment and every pull request gets a before/after.
API
Two endpoints, no key, rate-limited by IP:
POST https://alttextfix.com/api/page
{ "url": "https://yourstore.com" }
→ { pageUrl, title, images: [{ src, alt, flags }], counts: { total, missing, poor } }
POST https://alttextfix.com/api/describe
{ "src": "https://…/shoe.jpg", "pageUrl": "https://yourstore.com", "alt": "current alt or null" }
→ { alt, type: "informative|decorative|logo|chart|screenshot|text-in-image", action: "keep|rewrite", why }
The free tier describes 20 images per run and is capped per IP and per day. If you need to run a whole catalogue, the paid path does up to 1,000 images across 40 pages and emails the CSV — $99. White-label volume pricing for tools and agencies: supplier sheet.
What the flags mean
- missing — no alt attribute at all
- empty — alt="" on an image that carries meaning (right for decoration, wrong for a product photo)
- filename — alt="hero-2-final.png"
- generic — alt="Image", alt="Banner title icon"
- duplicate — the same text on three or more images on the page
- too_long — over 125 characters
- stuffed — the same word three or more times
Bugs, corrections or a compatible endpoint you want supported: hello@alttextfix.com.