# BRAINIAC Link Quality Check for llms.txt

> BRAINIAC Link Quality Check for llms.txt 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 the link quality of an llms.txt document, scoring link titles and descriptions and reporting issues like generic titles or missing descriptions.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/llms-txt/link-quality-check?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-link-quality-check-for-llms-txt-2a129e4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TFtZBHyuQHDav9VMeAwvP

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-link-quality-check-for-llms-txt-2a129e4c -d '<json body>'
```

Example prompt: Can you check the link quality of my llms.txt file and tell me the score plus any issues with generic titles or missing descriptions? Here's the full text: [paste llms.txt content]

## When to prefer this

Use this endpoint when you need to programmatically validate the link quality of an llms.txt file or similar structured markdown document intended for AI agent consumption. It is purpose-built for the llms.txt format and understands ATX headings, blockquote summaries, and markdown list links — unlike generic link checkers or HTML validators. It does not fetch URLs, so it is safe for offline or draft documents.

## Known failure modes

- Input text exceeds 200,000 character limit — validation error
- Malformed document object structure — schema validation error
- No parseable markdown links found — scores 0 with explanation
- Section array exceeds 50 items or link array exceeds 200 items — schema rejection
- Empty or null text field — likely returns score of 0 or error

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

Returns a numeric quality score (0–100), a list of issues (e.g. generic titles with their location, severity, and description), a list of warnings (e.g. missing descriptions, repeated descriptions), a short analysis summary, recommendations, and a limitations list explaining what the checker does and does not evaluate.

## 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": 88,
  "issues": [
   {
    "type": "generic_title",
    "evidence": "click here",
    "location": "line 6",
    "severity": "medium",
    "description": "The link title is a generic label, so an agent cannot tell what the target covers."
   }
  ],
  "success": true,
  "analysis": "Assessed 3 parsed links across 1 sections.",
  "warnings": [
   {
    "type": "missing_description",
    "location": "line 6",
    "description": "The link has no description after the URL."
   },
   {
    "type": "description_repeats_title",
    "location": "line 7",
    "description": "The description repeats the link title."
   }
  ],
  "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.",
   "Generic titles are an exact case-insensitive match against a fixed list: click here, here, link, read more, this, docs, documentation, page, info, more.",
   "Each generic title subtracts 12. A file with no parsed links scores 0. Missing descriptions are warnings and do not change the score.",
   "This check does not open links and does not judge whether a description is factually correct."
  ],
  "recommendations": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-link-quality-check-for-llms-txt-2a129e4c/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)
