> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AEO Content Scorecard

> Score how well an article performs for Answer Engine Optimization

The **AEO Content Scorecard** node evaluates how well a given article performs for Answer Engine Optimization (AEO). It analyzes the URL you provide, retrieves and inspects the content, and produces a structured scorecard with category-level scoring, weighted factors, and specific, actionable recommendations.

This node uses the same scoring logic that powers Profound’s Content Optimization feature, ensuring consistency between your Agent outputs and the optimization experience in the Profound platform.

Use this node when you want to diagnose how well an article aligns with the way AI systems evaluate relevance, clarity, structure, and answerability—and when you want to programmatically trigger optimization workflows based on these results.

<Tip>Check out [Getting started with Agents](/agents/getting-started) to learn how to add this node to an Agent.</Tip>

## When to use this node

Use the AEO Content Scorecard to:

* Audit existing content for AEO readiness
* Prioritize content refresh opportunities
* Trigger automated improvement workflows
* Benchmark your content against top-ranking competitors
* Provide structured optimization recommendations to writers or LLMs
* Standardize content scoring across your organization

This node is highly effective in both human-driven editorial processes and fully automated content optimization pipelines.

## Node configuration

Selecting the AEO Content Scorecard node opens its configuration panel on the right side of the Agent builder.

### URL (required)

Enter the URL of the article you want to evaluate.

This can be:

* A published content page
* A staging URL
* A temporary hosting URL
* Any accessible webpage containing the article text

The node retrieves the content and applies a full analysis across readability, structure, answerability, machine readability, and more.

### Target Prompt (required)

Enter the user prompt or question your content should be optimized for.

Example:

* “How do keyword hierarchies work in AI search?”
* “What is predictive maintenance in manufacturing?”

This helps evaluate whether the article directly matches user intent as seen in AI-generated answers.

### Output Label

Assign a descriptive label to access the scorecard output in downstream steps.

Examples:

* `aeo_scorecard`
* `content_score`
* `scorecard_output`

## How the node works behind the scenes

AEO Content Scorecard runs a multi-step evaluation pipeline:

### 1. Content retrieval

The node fetches the webpage content from the provided URL and prepares it for analysis.

### 2. AEO-focused content parsing

The underlying models identify:

* Text structure
* Header hierarchy
* Answerability signals
* Entity coverage
* URL patterns
* Schema presence
* Internal linking
* Machine readability cues

### 3. Scoring across AEO categories

The node produces a weighted score across categories, commonly including:

* **Readability**
* **Content Freshness**
* **Content Structure**
* **Answerability Signals**
* **Machine Readability**
* **Information Density**

Each category is scored and flagged (e.g., green, yellow, red).

### 4. Top recommendations

The node identifies the highest-impact improvements based on:

* AEO principles
* Competitor benchmarks
* Structural inconsistencies
* Opportunities to simplify, clarify, or enhance the content

Recommendations include:

* Before/after examples
* URL improvements
* Schema suggestions
* Title enhancements
* Subheading updates
* Opportunities to increase topical relevance

### 5. Final score assembly

The node compiles a structured scorecard containing:

* Final Score
* Target Score Range (based on top competitor performance)
* Detailed category breakdown
* Actionable recommendations

## Output

The resulting output is a structured report similar to the following example:

>

<Note>
  ### AEO Content Scorecard

  **URL:**<br />` https://www.tryprofound.com/blog/introducing-keyword-hierarchies`

  **Final Score:** 72/100<br />**Target Zone (Top Competitors):** 62–72

  #### Category Breakdown

  | **Category** | **Score** | **Status** |
  | - | - | - |
  | Readability | 64 | 🟡 |
  | Content Freshness | 91 | 🟢 |
  | Content Structure | 67 | 🟡 |
  | Answerability Signals | 81 | 🟢 |
  | Machine Readability | 63 | 🟡 |
  | Information Density | 21 | 🔴 |

  #### Top Recommendations

  1. **Enhance Subheading Relevance**<br />Improve clarity by explicitly mentioning “Keyword Hierarchies in AI Conversations.”<br />*Before:* “The technical innovation”<br />*After:* “How Keyword Hierarchies Enhance AI Conversations”
  2. **Simplify the URL Structure**<br />Shorten the URL to make it more topical and easier for AI systems to parse.
  3. **Implement FAQ Schema Markup**<br />Add FAQ entries such as “What are keyword hierarchies?” to better support answer engines.
  4. **Add Superlatives to the Title**<br />Example improvement:<br />*Before:* “Introducing Keyword Hierarchies”<br />*After:* “Discover the Most Effective Keyword Hierarchies for AI Conversations”
</Note>

## Example Agent: AEO Content Refresh

Here is how you might use this node inside a real optimization Agent aimed at automatically improving existing articles and republishing them.

**Steps:**

1. **AEO Content Scorecard**
   * Input the article URL
   * Retrieve a full AEO scorecard and improvement recommendations
2. **[Prompt LLM](/agents/nodes/prompt-llm): generate improved article**
   * Provide the scorecard and instruct the model to apply the recommended improvements
   * Rewrite the article with updated structure, headings, clarity, and answerability
   * Maintain original brand voice
   * Example prompt:

     ```text wrap theme={null}
     Here is the AEO Content Scorecard for this article.
     Apply all recommendations, rewriting the content where necessary.
     Produce an improved article that would score at least 10 points higher
     while maintaining factual accuracy and brand voice.

     {{aeo_scorecard}}
     ```
3. **[Prompt LLM](/agents/nodes/prompt-llm): validate against scorecard criteria**
   * Ensure the updated article meets or exceeds recommended category scores
4. **Publish or Update Step**
   * Use [Call API](/agents/nodes/call-api) or CMS publishing logic to update the article on your site

This workflow allows teams to create scalable, repeatable content optimization systems powered by Profound.

## Best Practices

* Use the **Target Prompt** field whenever the article exists to answer a specific question.
* Pair this agent with [Generate Article](/agents/nodes/content-creation/generate-article) for iterative optimization loops.
* Use clear output labels when chaining scorecards into rewrite steps.
* Run this node periodically in recurring Agent runs to detect content decay.