# 🔍 SEO Assistant

> Audits posts and pages for SEO health. Fixes meta titles, descriptions, headings, and keyword usage so your content ranks higher.

| Field | Value |
|-------|-------|
| Slug | `seo-assistant` |
| Version | 1.0.0 |
| Category | SEO |
| Author | Agentic Community |
| Required Capabilities | `edit_posts` |

## What It Does

SEO Assistant audits your WordPress content for on-page SEO issues and applies fixes. It can scan your entire site to find posts with missing meta descriptions, thin content, broken heading hierarchies, missing alt text, and poor internal linking. It works with Rank Math, Yoast, or the built-in Agentic SEO Engine.

For individual posts, SEO Assistant provides a detailed score (0-100) covering title length, meta description quality, heading structure, keyword density, internal/external link counts, and image alt text coverage. It generates specific, actionable recommendations and can apply fixes directly.

The agent also includes a complete internal linking toolkit. It can map your entire link graph, identify orphan pages (invisible to crawlers) and dead-end pages (no outbound links), suggest related content to link to, and bulk-fix linking issues across your site. Schema markup analysis and FAQ schema injection round out its capabilities.

## Tools

| Tool | Risk | Description |
|------|------|-------------|
| `get_seo_overview` | None | Scan all published posts for common SEO issues: missing meta descriptions, short/long titles, thin content, no internal links, and no images. |
| `list_posts_needing_seo` | None | List posts filtered by a specific SEO issue. Useful for batching fixes. |
| `analyze_post_seo` | None | Full SEO audit of a single post. Returns a score (0-100), title length, meta description, heading structure, keyword density, link counts, and recommendations. |
| `update_post_seo` | Medium | Update SEO fields on a post: title, meta description, URL slug, and focus keyword. |
| `analyze_internal_links` | None | Build the site's internal link graph. Returns orphan pages, dead-end pages, and hub pages to diagnose linking issues. |
| `get_link_suggestions` | None | For a given post, suggest related internal pages to link to based on shared categories, tags, and keyword overlap. |
| `add_related_links_section` | Medium | Append a "Related Articles" section (as Gutenberg blocks) to the end of a post's content. |
| `insert_contextual_link` | Medium | Find an unlinked phrase in a post's content and wrap it in an anchor tag. Only links the first unlinked occurrence. |
| `fix_all_internal_links` | High | Bulk operation that adds a "Related Articles" section to every dead-end page across the entire site. |
| `fix_orphan_pages` | High | Bulk operation that fixes orphan pages by adding inbound links from topically related hub pages. |
| `check_schema_coverage` | None | Analyse rendered pages for missing schema markup types (Article, FAQPage, HowTo, BreadcrumbList, Organization, etc.). |
| `add_faq_schema` | Medium | Extract Q&A pairs from a post's content and save FAQPage JSON-LD schema. |
| `optimize_post_title` | Medium | Analyse a post title for search intent alignment and rewrite it. Updates both post_title and SEO title meta. |
| `update_attachment_alt_text` | Medium | Update the alt text, title, caption, or description of a media library attachment. |

## Example Prompts

- "Run a site-wide SEO overview"
- "Audit post #25 for SEO"
- "Find and fix all orphan pages on my site"
- "Add FAQ schema to post #30"
- "Show me which pages have no internal links pointing to them"
- "Fix the alt text on all my product images"
- "Rewrite the title of post #12 so it ranks better for buyer intent"
- "Which of my pages are missing Article or FAQPage schema?"

---

_Generated by Agent Builder for WordPress_
