npx @foxygeo/audit — CI linter for llms.txt and GPTBot

npx @foxygeo/audit — CI linter for llms.txt and GPTBot

Free console linter that checks llms.txt, GPTBot/ClaudeBot access, and schema in GitHub Actions, then comments the AI Readiness score with a public foxygeo.com report.

Open-Source Developer CLI & GitHub Action

@foxygeo/audit

Two-second deterministic linter for AI crawler access (GPTBot, ClaudeBot), llms.txt standard compliance, and JSON-LD schema regressions in CI/CD.

⚡ Run instant scan anywhere (zero install required):
One-liner CLI command
npx @foxygeo/audit https://example.com
CLI Usage & Modes

Local & Remote Execution

Run locally on your codebase before commit, or audit remote staging/production domains.

1. Local workspace scan (reads repo files)
npx @foxygeo/audit
2. Remote live domain check
npx @foxygeo/audit https://example.com
3. CI mode with PR comment & public report
npx --yes @foxygeo/audit --ci --publish example.com
CI / CD Workflow Generator

Copy-Paste GitHub Actions Generator

Automate GEO checks on push & PRs. Choose threshold enforcement or sticky PR comments:

.github/workflows/geo-audit.yml
name: GEO Audit
on: [push, pull_request]
jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: npx @foxygeo/audit https://example.com --min-score 75

What @foxygeo/audit Scores (100 Point Scale)

AI Bot Access (40 pts)

Checks /robots.txt and root headers to ensure GPTBot, ClaudeBot, PerplexityBot, and Google-Extended are not inadvertently blocked.

llms.txt Standard (30 pts)

Validates existence of /llms.txt and /llms-full.txt, checks byte limits (<100KB), markdown link validity, and canonical domain consistency.

Schema & Entity Data (30 pts)

Verifies JSON-LD structured data (Organization, WebSite, FAQPage, Article) for accurate entity resolution by LLMs.

Open-Source on GitHub

The @foxygeo/audit package and GitHub Action are completely open-source. Contribute, inspect the source, or report issues on GitHub.

PR Comment Preview
🦊 FoxyGEO AI Readiness: 94/100
✅ GPTBot / ClaudeBot: Allowed
✅ llms.txt: Valid (12 pages linked)
✅ JSON-LD: Organization, WebSite found
📊 Public report: https://foxygeo.com/report/yourdomain-com

Free score

Get a practical score instead of waiting for a paid demo or enterprise onboarding.

Actionable report

Every scan provides a comprehensive report with recommendations and prompt opportunities.

AI crawler ready

Designed around what AI crawlers actually need: canonical pages, schema, sitemap, robots, and llms.txt.