# BRAINIAC LLMs.txt Navigation Analyzer

> BRAINIAC LLMs.txt Navigation Analyzer is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-12).

Analyzes an llms.txt document's navigation structure for AI-agent usability issues like ambiguous titles, generic section names, and missing link descriptions, returning a scored report.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/llms-txt/navigation-analyze?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-llms-txt-navigation-analyzer-4b9d1170
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RCvWRzSLclsvX1FHyaMRC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-llms-txt-navigation-analyzer-4b9d1170 -d '<json body>'
```

Example prompt: Can you analyze my llms.txt navigation document and score how agent-friendly it is? Here's the full text — I want to know if any link titles are ambiguous, if any sections are too generically named, and what links are missing descriptions.

## When to prefer this

Use this endpoint when you need a machine-readable, scored audit of an llms.txt navigation file specifically for AI agent usability — particularly to catch ambiguous link titles, generic section groupings, and missing descriptions before publishing. Prefer it over generic link-checkers or linters that don't understand the llms.txt format or agent-navigation semantics.

## Known failure modes

- Input text exceeds 200,000 character limit — request rejected
- Malformed document object structure — validation error returned
- No sections or links provided — score may be trivially high with no issues detected
- Network timeout for large documents
- Payment not received via x402 — 402 response returned before analysis

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing: a numeric quality score (0–100), a list of issues (e.g. ambiguous_title, generic_section) each with type, evidence, location, severity, and description; a list of warnings for unclear links; a plain-English analysis summary; recommendations; and a limitations list explaining the scoring rules.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "document": {
   "type": "object",
   "properties": {
    "title": {
     "type": "string",
     "maxLength": 200
    },
    "summary": {
     "type": "string",
     "maxLength": 5000
    },
    "sections": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "name",
       "links"
      ],
      "properties": {
       "name": {
        "type": "string",
        "maxLength": 200
       },
       "links": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "title",
          "url"
         ],
         "properties": {
          "url": {
           "type": "string",
           "maxLength": 2000
          },
          "title": {
           "type": "string",
           "maxLength": 200
          },
          "description": {
           "type": "string",
           "maxLength": 1000
          }
         },
         "additionalProperties": false
        },
        "maxItems": 200
       }
      },
      "additionalProperties": false
     },
     "maxItems": 50
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "score": 82,
  "issues": [
   {
    "type": "ambiguous_title",
    "evidence": "overview",
    "location": "line 6 and line 7",
    "severity": "medium",
    "description": "The same link title points at more than one path, so an agent cannot choose from the title alone."
   },
   {
    "type": "generic_section",
    "evidence": "docs",
    "location": "line 5",
    "severity": "medium",
    "description": "A section with a generic name holds at least five links, so the group does not say what those links cover."
   }
  ],
  "success": true,
  "analysis": "Checked 5 links in 1 sections for repeated titles and generic group names.",
  "warnings": [
   {
    "type": "unclear_link",
    "location": "line 6",
    "description": "The link has no description to distinguish it inside its section."
   },
   {
    "type": "unclear_link",
    "location": "line 7",
    "description": "The link has no description to distinguish it inside its section."
   },
   {
    "type": "unclear_link",
    "location": "line 8",
    "description": "The link has no description to distinguish it inside its section."
   },
   {
    "type": "unclear_link",
    "location": "line 9",
    "description": "The link has no description to distinguish it inside its section."
   },
   {
    "type": "unclear_link",
    "location": "line 10",
    "description": "The link has no description to distinguish it inside its section."
   }
  ],
  "limitations": [
   "The parser reads ATX headings, a blockquote directly after the H1, and markdown list links. It does not fetch URLs, run HTML, or decide that a link works.",
   "An ambiguous title is the same case-insensitive title with two different paths. Generic section names are links, docs, documentation, other, misc, stuff, items, and pages.",
   "Each ambiguous title subtracts 10. Each generic section of five or more links subtracts 8. Missing descriptions are warnings and do not change the score."
  ],
  "recommendations": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-llms-txt-navigation-analyzer-4b9d1170/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
