aeo.unstructured-text

What to change

A finding of this rule on a page carries the exact edits for that page: the markup it quotes, and what to write instead.

When it runs

Runs on every AEO audit: of a page, a crawl, a build directory or HTML. Info is a best practice: worth doing, rarely urgent, and --no-info leaves it out. Each finding takes 1 point off the page's score.

The severity here is the rule's usual one: a finding can be raised or lowered when the page gives a reason.

Run it, or skip it

Check a page for this rule alone, after a fix for instance:

npx @rivi-software/agentic-seo-check aeo https://example.com --rule aeo.unstructured-text

Or from an assistant, with the MCP tool seo_aeo_audit:

{
  "url": "https://example.com",
  "rules": [
    "aeo.unstructured-text"
  ]
}

To leave it out of an audit, pass --disable aeo.unstructured-text on the command, or disableRules: ["aeo.unstructured-text"] to a tool.

• Infoaeo.noaiThe page sets noai or noimageai, directives no major answer engine documents support for.
• Infoaeo.data-nosnippetdata-nosnippet hides a large share of the page's text (20% or more) from snippets and AI Overviews.
• Warningaeo.text-needs-javascriptThe HTML is an empty JavaScript app shell; most AI crawlers do not run JavaScript, so they see no content.
• Infoaeo.question-not-answered-firstA heading asks a question but no short, direct answer follows it.
• Warningaeo.schema-text-not-visibleFAQPage, QAPage or HowTo structured data holds questions, answers or steps that are not in the page's HTML text.
• Warningaeo.article-author-missingArticle structured data names no author.
• Infoaeo.article-author-incompleteThe article's author is a bare name, without a url or sameAs that identifies the person.
• Warningaeo.article-dates-missingArticle structured data lacks datePublished (warning) or dateModified (info), which tell answer engines how fresh the content is.