Skip to main content
Analyze a single blog post or article for SEO and AI readability. Use this for specific article URLs, not homepages.

​
Overview

audit_article provides article-level analysis:
  • 7 SEO checks — title, description, headings, content quality, readability, images, internal links
  • 14 AEO checks — AI-specific optimizations for better visibility
  • Keyword targeting — optional keyword to evaluate optimization for
  • Playwright rendering — optional JavaScript rendering for dynamic content
This tool is completely free and works without an API key.

​
Parameters

​
url
string
required
The article URL to audit. Should be a specific blog post or article page, not a homepage or listing page.
​
keyword
string
Target keyword to evaluate optimization for. If provided, checks will assess how well the article is optimized for this keyword.
​
use_playwright
boolean
default:"false"
Whether to use Playwright for JavaScript rendering. Enable this for single-page applications or JavaScript-heavy sites.

​
Example prompts

Audit https://example.com/blog/my-post

Check this article targeting 'content marketing'

Audit https://example.com/blog/guide with keyword SEO optimization

​
Response structure

The tool returns a JSON object with:
​
seo
object
SEO check results (7 checks)
​
aeo
object
AEO check results (14 checks)
​
keyword_optimization
object
Keyword optimization analysis (if keyword provided)

​
Usage example

# How the tool is called in the MCP server
@mcp.tool(annotations=READ_ONLY)
def audit_article(
    url: str,
    keyword: str | None = None,
    use_playwright: bool = False,
) -> str:
    """Analyze a single blog post or article for SEO and AI readability."""
    client = _get_client()
    return _call(client.audit_article, url, keyword=keyword, use_playwright=use_playwright)

​
When to use

Use audit_article for:
  • Specific blog posts — URLs containing /blog/, /post/, /article/
  • Content optimization — before rewriting or improving an article
  • Keyword targeting — evaluate optimization for a specific search term
  • Content audits — systematically review all blog content
Do not use audit_article for homepages or domain-level audits. Use audit_site instead.

​
Routing rule

The MCP server instructions specify this routing:
  • “audit my site” / any domain / homepage → audit_site
  • “audit this article” / specific blog post URL → audit_article
  • When in doubt, use audit_site

​
Next steps

After running audit_article, you can: