Documentation

Last updated: July 23, 2026 · Applies to SEOWing 3.12+

SEOWing is an AI-first SEO plugin for WordPress. It replaces Yoast SEO, RankMath and Imagify with one plugin that can be operated manually from the WordPress admin — or by an AI agent over the Model Context Protocol (MCP). This guide takes you from installation to a fully optimized site. For the full list of AI tools, see the MCP Tool Reference.

Requirements
Installation
Activating your license
Your first site audit
Modules
Working in the editor
Migrating from Yoast or RankMath
AI & MCP integration
Updates
Troubleshooting
Uninstalling & data removal
Privacy & AI services
Support
MCP Tool Reference (61 tools)

1. Requirements

WordPress 6.3 or newer (tested up to 7.0)
PHP 7.4 or newer (PHP 8.1+ recommended)
An active SEOWing license key. Creating an account on app.seowing.io instantly issues a free 30-day trial license for one website (full SEO core; the AI/MCP autopilot and advanced modules belong to the paid Pro and Studio plans). Paid keys arrive by email and live in your account.
HTTPS is strongly recommended, and required for the AI/MCP integration

2. Installation

Download the plugin ZIP from your purchase email or your account.
In WordPress, go to Plugins → Add New → Upload Plugin, choose the ZIP and click Install Now.
Click Activate. A new SEOWing menu appears in the admin sidebar with Dashboard, Modules, Settings, Tools and SEO Audit.

If you are replacing Yoast SEO or RankMath, keep the old plugin installed until you have finished the migration (see Migration), then deactivate and delete it. Running two SEO plugins at the same time permanently is not supported.

3. Activating your license

SEOWing uses per-site licenses: Starter and Pro cover one website per license, Studio covers up to 10 websites. Activating the plugin on a domain consumes one seat.

Open SEOWing → Dashboard and locate the license panel.
Paste your license key and click Activate. The key is bound to this domain.
The plugin re-validates the license once a day. With an active license you receive plugin updates and support.

Moving to a new domain? Deactivate the license on the old site first (this frees the seat), then activate it on the new one. You can also disconnect installs yourself in your customer account. If you run out of seats, upgrade your plan or contact hello@seowing.io.

4. Your first site audit

Start with an audit before changing anything:

Go to SEOWing → SEO Audit and run a full-site audit. You get an overall SEO score plus per-page findings: missing or weak titles and descriptions, missing structured data, image issues, thin content and more.
Fix issues manually per page, or let the autopilot handle them: the audit offers recommended fixes which you can preview before applying (the AI equivalent is seo_auto_setup with dry_run — see the MCP reference).
Re-run the audit after major content changes or once a month. A scheduled audit additionally re-scores your whole site automatically every week.

Recommendation: take a backup of your site before the first autopilot run without dry-run. Bulk operations are idempotent and only fill missing values by default, but a backup is the safest foundation for any bulk write.

5. Modules

Everything in SEOWing is a module you can enable or disable under SEOWing → Modules. Disabled modules load no code, so you only pay the performance cost of what you use.

Core SEO

Titles & Meta — templates and per-post overrides for SEO titles, meta descriptions and canonicals; Quick Edit support in post lists.
Schema / Structured Data — JSON-LD generator with 20+ types (Article, Product, LocalBusiness, FAQ, HowTo, Event and more), automatic Organization and Breadcrumb schema, and per-page custom schema.
Sitemaps & IndexNow — XML sitemaps for posts, pages and taxonomies, plus News, Video and Image sitemaps. IndexNow pings search engines automatically on publish.
Redirects & 404 Monitor — 301/302/307 redirects with CSV import, and a 404 log so you can catch broken URLs early.
Breadcrumbs — breadcrumb trail as a shortcode, Gutenberg block or Elementor widget, with matching schema.

Images

Image Optimizer — compression, WebP and AVIF conversion, lazy loading.
AI Alt Text — generates missing alt attributes, in bulk if you want (always with a preview first).

Content & Analysis

SEO Analyzer & Readability — per-post analysis with a score and concrete suggestions.
Internal Links — finds pages whose topics you already mention elsewhere and suggests contextual internal links.
Content Generator, Glossary, Topic Clusters, Entity Manager — AI-era content tooling for building topical authority.
Content Decay Detection — flags pages whose rankings or freshness are slipping.
Social Previews — Open Graph and Twitter card control with live preview.

Trust & local

E-E-A-T — accreditations, certifications and expert profiles, output as structured data (increasingly important for AI search).
Local SEO — name/address/phone, opening hours, geo coordinates and price range as LocalBusiness schema.
International / Hreflang — hreflang manager for multilingual sites.
LLM & GEO Optimization — AI-summary and AI-keyword meta tags plus llms.txt generation, so AI assistants understand and cite your site.

6. Working in the editor

Meta box — every post and page gets a SEOWing panel for title, description, focus keyword, canonical, schema and social preview.
Gutenberg — blocks for FAQ, HowTo, Table of Contents and Key Takeaways (all with matching schema), plus a sidebar panel.
Elementor — native widgets (Breadcrumbs, FAQ, TOC, Author Box, SEO Score) and dynamic tags (SEO Title, Description, Canonical, Focus Keyword). SEOWing's audit also understands Elementor layouts, including heading hierarchy and alt-text checks.
WooCommerce — automatic Product schema with price, availability and reviews.

7. Migrating from Yoast or RankMath

Install and activate SEOWing while the old plugin is still active.
Go to SEOWing → Tools → Migration and choose your current plugin. SEOWing imports titles, descriptions, canonicals, redirects and social settings.
Spot-check a handful of important pages (view source and verify title/meta/schema output).
Deactivate and delete the old plugin, then run a full-site audit.

8. AI & MCP integration

This is what makes SEOWing different: an AI agent can audit, configure and optimize your entire site through 61 purpose-built tools.

In SEOWing → Settings → MCP, generate an API key. Treat it like a password — it grants write access to your site's SEO. Tokens are shown only once; you can revoke them at any time.
Connect your AI client:
- Claude.ai / Claude Desktop — add SEOWing as a connector via the OAuth flow; you explicitly confirm the connection in your WordPress admin.
- Claude Code / custom scripts — add the SEOWing MCP server by API key; the endpoint is https://your-site.com/wp-json/seowing/v1/mcp/, with the key sent in the X-SEOWing-API-Key header.
Start with a prompt like: “Run a full site audit and walk me through the results.”

Permissions (scopes) & safety. Access can be restricted to permission levels (read, content-write, settings-write), so a token used for analysis and reporting cannot change settings or write files (principle of least privilege). The per-site token doubles as the kill switch: revoke it and agent access ends instantly, without deactivating the plugin. Bulk operations such as seo_auto_setup support a dry_run mode that previews every change before anything is written. The MCP interface is rate-limited; optional request logging provides an audit trail. See the MCP Tool Reference for every tool and typical workflows.

9. Updates

With an active license, updates appear in Dashboard → Updates like any other plugin and are delivered from our update server. Release notes are published in the changelog. If no update appears, verify the license is active on this exact domain.

10. Troubleshooting

License won't activate — check for typos, make sure the domain isn't already using all seats, and that your server can reach api.seowing.io (some firewalls block outgoing requests).
No updates offered — the license must be active and valid for this domain; re-save the license key to force a re-check.
MCP connection fails — the site must be reachable over HTTPS, the REST API must not be blocked, and the X-SEOWing-API-Key header must match a valid key.
Schema not showing — clear your page cache. SEOWing integrates with LiteSpeed Cache, WP Rocket and W3 Total Cache and flushes them automatically after changes, but external CDNs may need a manual purge.

11. Uninstalling & data removal

Deactivate the license in the dashboard first (this frees the seat), then deactivate and delete the plugin under Plugins. SEO data already written into your pages (titles, meta descriptions, structured data, redirects) is preserved and keeps working independently of SEOWing. If you also want to remove SEOWing's settings and database tables, enable “Remove data on uninstall” under Settings before deleting. Also revoke any MCP access so no agent can reach the site anymore.

12. Privacy & AI services

What leaves your site? The core features run locally in WordPress. When you use the AI/MCP part, the content being analyzed (text, metadata, image information) is transmitted to the AI client you connected or the AI provider you chose. For license validation the plugin transmits technical data (domain, plugin and WordPress version). Details are governed by the Privacy Policy, the Data Processing Agreement and the sub-processors list. Only run AI bulk operations on personal data after checking your own legal basis under data protection law.

13. Support

Email hello@seowing.io — include your site URL, plugin version and a short description. Pro and Studio plans get priority handling. Feature requests are welcome; much of SEOWing was built from customer requests.