Aetos SEO Documentation

Chapter 01

Getting Started

Aetos SEO is a WordPress plugin that audits your website's technical SEO and AI-readiness, then exports a structured bundle you can feed into ChatGPT, Claude, or any AI assistant so the AI gives you fixes based on your actual site — not generic advice.

This page is the complete user guide. If you just bought a license and want the fastest path to your first report, follow Chapters 02 → 03 → 04 (about 10 minutes total).

Chapter 02

Installation

Aetos uses the same two-plugin model as established WordPress products: the official free plugin provides the core, and the separate Pro add-on unlocks advanced modules in that same interface. Keep both plugins installed and active.

Step-by-step

1. In WordPress, go to Plugins → Add New, search for Aetos SEO, then install and activate the official Lite plugin.
2. Download the Aetos SEO Pro ZIP from your order email.
3. Go to Plugins → Add New → Upload Plugin, choose the Pro ZIP, then install and activate it.
4. Confirm that Aetos SEO and Aetos SEO Pro are both active on the Plugins screen.
5. Open Aetos SEO → Pro Status, enter your license key, and activate it.
6. Use the single Aetos SEO menu; Pro modules and reports appear inside it.

Chapter 03

License & Activation

Aetos SEO uses a domain-bound licensing model. Each license is tied to a single domain you specified at purchase. Here's what you can expect:

Where to view your license status

In WP Admin, go to Aetos SEO → Pro Status. You'll see:

• Your Pro or Agency tier
• The domain bound to the license
• The expiry date
• Status (Active / Expired / Domain mismatch)

What each tier includes

Domain transfer

If you move your site to a new domain (e.g., during a rebrand or migration), reply to your welcome email and we'll re-issue the build for the new domain. Pro and Agency licenses include 1 free transfer per year.

Renewal

About 14 days before expiry, you'll receive a renewal reminder. After expiry, the plugin continues to function for a 14-day grace period, then audits are disabled until renewal. You won't lose any data — your reports stay accessible.

Chapter 04

Running Your First Audit

A full audit scans your site against dozens of technical and AI-readiness checks. Most sites complete in 2-3 minutes.

How to run it

1. Open Aetos SEO → Audit.
2. Click Run Full Site Audit.
3. A progress bar appears. Don't close the browser tab — the scan runs in the background but the UI keeps it visible.
4. When complete, click View Results.

What gets checked

The full audit covers, among others:

• Technical foundation: robots.txt, sitemap, canonical tags, meta robots, hreflang, redirects
• Page-level signals: titles, descriptions, headings, internal linking, image alt text
• Schema markup: Organization, Product, Article, FAQ, BreadcrumbList — what exists and what's malformed
• Performance signals: Core Web Vitals (LCP, CLS, INP) via PageSpeed Insights API if connected
• AI readiness: structured data coverage, content depth, entity clarity, citation-worthiness
• Indexability: noindex flags, blocked resources, orphan pages

Partial audits

For large sites, you can run targeted audits — pick a single category (e.g., "Schema only") to scan in 30 seconds. Use this when you've just fixed something and want to verify the change.

Chapter 05

Reading the Report

The Results page is organized into three views:

1. Priority Actions

A short list of the highest-impact fixes for your site. Each item shows:

• Severity — critical, high, medium, low
• Affected pages — how many URLs have the issue
• What to do — a one-paragraph fix description
• Estimated impact — qualitative ("major" / "moderate" / "minor")

2. Findings (full)

Every check that ran, grouped by category. Use this when you want the complete picture, including checks that passed.

3. By URL

Pivots the same data by page. Useful when you're debugging a single URL — you see every issue that page has, on one screen.

Severity definitions

Chapter 06

AI Context Export

This is the feature that makes Aetos SEO different from a regular auditor. After every full audit, you can export a single JSON context file that contains:

• Your site's structural audit (every check, every URL, every finding)
• A snapshot of your WordPress runtime environment
• Log signals (recent errors, slow queries, if available)
• A normalized priority list ready for an AI to act on

How to export

1. From the Results page, click Export.
2. You get a JSON file (usually 1-4 MB).

How to use it with AI

1. Open ChatGPT (or Claude, or any chat AI that accepts attachments).
2. Attach the JSON file.
3. Ask the AI a question like: "Fix the top 5 issues on the priority list. For each issue, give me the exact code or WordPress setting change."
4. The AI now has ground-truth context for your site — its suggestions are specific, not generic.

Chapter 07

In-WordPress Messages

From time to time, we may send a message that appears inside your WordPress admin — for example, a release announcement, an urgent security note, or a tip relevant to your tier.

What you'll see

Messages appear as a standard WordPress admin notice at the top of any Aetos SEO page. They include a title, a short body, and sometimes a button (e.g., "Read more"). Each message is dismissible — click the X in the corner.

What we will send

• New version announcements (so you know when to update)
• Security advisories (rare, only when relevant to you)
• Tips on a feature you haven't used yet

What we will NOT send

• Marketing for unrelated products
• Notifications outside Aetos SEO pages (we never touch your regular WP admin)
• Anything you didn't opt into

Chapter 08

Receiving Updates

Lite and Pro update separately because they come from different trusted sources. Lite updates through WordPress.org. A licensed Pro add-on receives signed updates through the Aetos updater. Your settings and audit history remain in the shared Aetos data layer.

How to update (one click)

1. In WordPress: Plugins → Installed Plugins.
2. Update Aetos SEO when WordPress.org offers a Lite update.
3. Update Aetos SEO Pro when its licensed updater offers a signed Pro update.
4. Leave both plugins active. A normal update does not require re-entering the license.

Chapter 09

Troubleshooting

The license says "Domain mismatch"

The license is active for another domain. Deactivate it on the old site or contact support for an eligible domain transfer, then activate the same Pro add-on on the new domain.

The license says "Invalid" or "Tampered"

Recheck the key for missing characters and confirm outbound HTTPS is allowed. Pro accepts only a signed license response for the current domain. If it persists, contact support without posting the full key publicly.

The audit gets stuck on "Running…"

Audits self-recover after 15 minutes. You can force-recover sooner by going to Aetos SEO → System Health → Recover Scan State. The most common cause is a temporary PHP timeout or a memory limit on shared hosting.

Activation fails on shared hosting (Hostinger, SiteGround, etc.)

Almost always a PHP version issue. We require PHP 7.4 or newer. In your hosting control panel, find the PHP version selector and upgrade to PHP 8.2 (the current recommended version). The plugin will then activate cleanly.

I deleted the plugin and now my menu is gone, but the folder is still there

Some hosts hold a file lock after a failed update. Use the WordPress Plugins screen first. If support asks you to inspect folders, the current folders are wp-content/plugins/aetos-seo/ and wp-content/plugins/aetos-seo-pro/. Never delete both without a backup.

I get a "403 Forbidden" on every Aetos SEO page

This usually means another plugin or a security firewall (like Wordfence) is blocking AJAX calls. Try temporarily disabling the firewall, or add an exception for admin-ajax.php requests from your own IP.

The PageSpeed Insights checks return zero data

You need a Google PageSpeed API key (free quota up to 25,000 requests/day). Get one at Google's PageSpeed Insights page, then paste it into Aetos SEO → Settings → Performance.

Chapter 10

Getting Support

Pro and Agency licenses include 1 year of email support. The fastest way to reach us:

• Email: support@aetosseo.com — we reply within 1 business day, usually same day.
• Phone / WhatsApp: +20 106 818 7346 — Sunday-Thursday 10:00-18:00 Cairo time.
• Reply to your welcome email — keeps the conversation threaded.

What to include when reporting an issue

• The exact error message you see (a screenshot helps)
• Your WordPress version, PHP version, hosting provider
• What you were doing when the issue happened
• Optional: the AI Export Bundle (gives us full context in one file)