Advance SEO Pro The Ultimate AI SEO Suite for Botble CMS

Stop paying $300+/month for SEMrush, Yoast, and Surfer SEO.

Advance SEO Pro is the ultimate, all-in-one AI-powered SEO weapon built exclusively for Botble CMS. Bring your own AI key (OpenAI, Gemini, or Anthropic) and enjoy 1-click AI content rewriting, live SEO/AEO scoring, site-wide technical audits, free unlimited keyword research, automatic schema markup, and built-in rank tracking—all running 100% securely on your own server.

Get lifetime access today for just $149 before the price jumps to $199 forever. One plugin. Every SEO tool you will ever need.

# Advance SEO — The Complete AI SEO Suite for Botble CMS

>**One plugin. Every SEO weapon you'll ever need.** Replace Yoast, Rank Math, SEMrush, Ahrefs and Surfer SEO — for the cost of a single LLM API call.

**Author:** Maryam International LLC · [codeupp.xyz](https://codeupp.xyz)

**Version:** 1.0.1 · **Botble CMS:** 7.0+ · **PHP:** 8.1+ · **License:** MIT (your purchase = your rights)

---

## Why this plugin obliterates the competition

Most SEO tools force you into a $99–$499/month subscription, leak your data to their servers and still don't write content for you. **Advance SEO flips the table:**

- 🔑 **Bring your own AI key.** OpenAI · Gemini · Anthropic — pick the cheapest model and pay $0.0001 per fix.

- 🛰 **Runs 100% on your server.** Your content, your competitor data, your customer keywords — never leave your database.

- 🧠 **AI Fix in one click.** Title, meta, slug, body, FAQ, schema — rewritten instantly with a side-by-side BEFORE / AFTER diff.

- 📈 **Live SEO scoring** for every Product, Post and Page — SEO % · Readability % · GEO (AI Overviews) % · AEO (featured snippet) %.

- 🌐 **Site-wide technical audit** with AI-generated fix plans for every issue.

- 🔍 **Free keyword research** powered by Google Autocomplete + AI expansion. Unlimited. No API key needed.

- 📊 **Daily rank tracking** via free Google scrape *or* SerpAPI / DataForSEO.

- 🔗 **Backlink manager** with AI toxicity detection — import CSVs from Ahrefs / SEMrush / GSC.

- 🎯 **Competitor gap analysis** — paste any domain, AI returns the keywords they outrank you for.

- 🏷 **JSON-LD schema auto-injection** — Organization, Product, Article, FAQ, Breadcrumbs — all toggleable.

- 🗺 **XML sitemap** auto-generated, auto-pinged to Google & Bing on every content update.

- ↪️ **301 / 302 redirect manager** — never lose ranking from URL changes again.

- 🎨 **Theme-agnostic.** Works flawlessly on Martfury, Shofy, Nest, Wowy, Bloomwoo and every Botble theme.

---

## Module-by-module breakdown

### 1. Dashboard

A single command center showing average score, total AI fixes applied, monthly AI cost, open audit issues and 30-day rank trend. Top performers vs. pages that need attention.

### 2. Products / Posts / Pages SEO

Every entity in your store and blog gets:

- Live SEO score with a colored progress bar

- Auto-detected focus keyword

- 🪄 **AI Fix button** → modal with side-by-side diff → review → 1-click apply

- Bulk re-analyze

- Direct edit link back to the native Botble editor

### 3. Website SEO Audit

Crawls a configurable sample of your published URLs and reports:

- Missing or oversize titles & meta descriptions

- Missing canonical, Open Graph, H1, alt attributes

- Broken pages (HTTP 4xx/5xx)

- Missing robots.txt / sitemap.xml / HTTPS

- Missing JSON-LD schema

- Click any issue → AI-generated step-by-step fix plan

### 4. Keyword Research

- Free unlimited **Google Autocomplete** + automatic modifier expansion (`how to X`, `best X`, `X near me`, `X price`, `X vs`, …)

- AI enrichment with intent classification, estimated difficulty and volume

- 1-click "Track" to add to rank tracker

- 1-click "Write article" → AI drafts a full 1200-1800 word SEO-optimized blog post with FAQ

### 5. Rank Tracker

- Daily Google position check via free scrape (no key) or SerpAPI (paid, accurate)

- Position · previous position · trend arrow

- 30-day rolling average in the dashboard

- Built-in cron job — set & forget

### 6. Backlinks

- Import CSV from Ahrefs / SEMrush / Google Search Console

- AI toxicity & quality analysis

- Dofollow / Nofollow / Domain Rating tracking

### 7. Competitors

- Add up to unlimited competitor domains

- AI Content Gap analysis → returns prioritized keyword opportunities they rank for that you don't

### 8. Schema Markup

JSON-LD injected automatically on every front-end page. Toggle per type:

- Organization · WebSite (with sitelinks search) · BreadcrumbList

- Product (price, availability, ratings) · Article · FAQPage · AggregateRating

### 9. Sitemap

-`/advance-seo-sitemap.xml` — instantly live

- Pages + Posts + Products with `lastmod`, `changefreq`, `priority`

- Auto-ping Google & Bing on every content update

### 10. Redirects

- Database-backed 301/302/307/308 redirects

- Hit counter + last-hit timestamp for analytics

- No `.htaccess` or nginx config required

### 11. Settings

- Pick provider (OpenAI / Gemini / Anthropic) and model

- Bring your own API key (validated with a 1-click test)

- Optional SerpAPI key for accurate ranks

- Toggle every schema type and the cron rank checker

---

## 💰 The economics that destroy SEMrush

| Tool | Monthly cost | Yearly | What you get |

|---|---|---|---|

| SEMrush Pro | $129.95 | $1,559 | Keyword + audit, no AI writing |

| Ahrefs Standard | $199 | $2,388 | Backlink data, no AI writing |

| Surfer SEO | $89 | $1,068 | Content scoring only |

| **Advance SEO** | **$0** | **$0** | **Everything above + AI rewriting + your own data** |

Plus the pay-as-you-go API cost — typically **$2–$15/month** for a busy store using Gemini Flash Lite.

---

## 📊 Deep completeness analysis vs SEMrush / Yoast / Rank Math / human SEO

| Capability | Advance SEO | Yoast Premium | Rank Math Pro | SEMrush | Surfer | Human SEO Manager |

|---|---|---|---|---|---|---|

| Live SEO score per page | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |

| **AI rewriting (1-click)** | ✅ | ❌ ($89 add-on) | ❌ ($99 add-on) | ❌ | ✅ | ✅ slow |

| Readability score | ✅ basic | ✅ | ✅ | ❌ | ✅ | ✅ |

| **GEO/AEO scoring** (AI Overviews ready) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |

| Schema auto-injection | ✅ 6 types | ✅ 8 types | ✅ 15 types | ❌ | ❌ | manual |

| XML sitemap | ✅ via native | ✅ | ✅ | ❌ | ❌ | manual |

| **Keyword research** | ✅ free Autocomplete + AI | ❌ | partial | ✅ database | ❌ | tools needed |

| **Rank tracking** | ✅ free scrape + SerpAPI | ❌ | ❌ ($) | ✅ huge | ❌ | tools needed |

| Backlink analysis | ✅ CSV + AI toxicity | ❌ | ❌ | ✅ huge index | ❌ | needs tool |

| **Competitor gap (AI)** | ✅ | ❌ | ❌ | ✅ but no AI | ❌ | manual |

| **Site audit / crawler** | ✅ up to 50k pages | ❌ | ✅ small | ✅ huge | ❌ | tools needed |

| **AI content writer** | ✅ full articles | ❌ | ❌ | ❌ ($59 add-on) | ✅ | ✅ slow |

| 301 redirects | ✅ | ✅ | ✅ | ❌ | ❌ | manual |

| **Monthly cost** | **$0** + ~$5 API | $99/yr | $59/yr | **$129/mo** | **$89/mo** | **$2k–$8k/mo** |

**Verdict:**

-**Better than Yoast / Rank Math?** ✅ Yes — adds AI rewriting, keyword research, rank tracking, competitor gaps that they don't have at all.

-**Better than SEMrush?** ❌ No, in raw data. SEMrush has 25 billion keywords and 43 trillion backlinks. But Advance SEO **rewrites your content directly** (SEMrush only suggests), integrates into your CMS, and costs $0/month vs $129/month.

-**Better than Surfer?** ✅ Yes for everything except Surfer's real-time NLP content optimizer (which crawls Google for you).

-**Better than a human SEO manager?** ❌ No. A human builds links, negotiates guest posts, and does strategy. But Advance SEO replaces ~70% of a junior SEO's monthly tasks for $5/month.

---

## ⚡ Install

1. Upload the `advance-seo` folder to `platform/plugins/` of your Botble site.

2. Go to **Admin → Plugins**, find **Advance SEO** and click **Activate**.

3. Open **Advance SEO → Settings**, choose a provider and paste your API key.

4. Click **Test AI Connection** — you should see ✅.

5. Visit **Advance SEO → Products** (or Posts / Pages) — every item already has a score.

6. Click 🪄 **Fix with AI** on any low-scoring item, review the diff, click **Apply**. Done.

> The plugin creates its own tables (`as_seo_scores`, `as_keywords`, `as_redirects`, …) the first time you visit the dashboard. Uninstalling cleanly removes them.

---

## 🧩 Architecture (for developers)

```

advance-seo/

├── src/

│ ├── Providers/AdvanceSeoServiceProvider.php ← routes, menu, hooks

│ ├── Services/

│ │ ├── AIService.php ← OpenAI / Gemini / Anthropic

│ │ ├── SeoAnalyzer.php ← server-side scoring engine

│ │ ├── EntityResolver.php ← theme-agnostic Product/Post/Page bridge

│ │ ├── KeywordResearchService.php ← Google Autocomplete + AI

│ │ ├── RankTrackerService.php ← free scrape + SerpAPI

│ │ ├── SiteAuditService.php ← technical/on-page crawler

│ │ ├── SchemaGenerator.php ← JSON-LD builder

│ │ └── SitemapGenerator.php

│ ├── Http/Controllers/ ← 13 thin controllers

│ └── Models/ ← Eloquent models for 10 tables

├── resources/views/ ← Bootstrap 5 + Tabler icons

├── database/migrations/ ← one consolidated migration

├── config/advance-seo.php ← all defaults + provider catalog

└── routes/web.php

```

Everything is a **first-class Laravel/Botble plugin** — Eloquent, Blade, Routes, Schedule, Filters. Extend any service via Laravel's container or hook into the documented filters.

---

## 🔌 Hooks & Filters (for theme/plugin developers)

| Hook | When | What |

|---|---|---|

| `cms_handler_meta_data` | every front-end response | We inject JSON-LD here — override to customize |

| `advance_seo_theme_adapters` | service-boot | Register a theme-specific entity adapter |

| `advance-seo:rank-check` | daily 03:00 | Cron schedule name — extend or replace |

---

## 🛡 Security & data residency

- Every secret (API keys) is stored in the Botble `settings` table — never in code.

- Customer / competitor data is processed on your server. Only the prompt is sent to the chosen LLM provider — never request bodies, never user info.

- All admin routes are gated behind Botble's `auth` + `core` middleware.

---

## 📜 License

MIT — once you buy, **it's yours forever.** Use it on unlimited projects. Modify the code. White-label it. Resell installations to your clients.

# Changelog

## 2.0.0 — safety, page intelligence and connected reporting 16 september 2026

### Added

- Page Intelligence inventory for published pages, posts and parent products.

- Editor snapshots and on-demand server-rendered HTML scans with source, date, scope and stale-state information.

- Findings showing priority, evidence, editing location, instructions and example wording.

- Optional contextual AI action plans using saved page evidence and available Search Console query rows, with human-verification instructions.

- Indexed internal-link records, observed incoming links and related-page linking suggestions.

- Topic assignments, hub flags and topical-map link coverage.

- Per-page E-E-A-T evidence URLs/notes and transparently labeled documentation coverage.

- Revision comparison and selected-field restoration, including historical content where a saved revision exists.

- Dashboard Search Console snapshots, completed-period comparisons and page/query evidence.

- Explicit mobile PageSpeed measurements with separate lab and available field data.

- Isolated regression suite and deployment/upgrade instructions.

### Changed and fixed

- Restricted AI Apply to explicitly selected SEO titles/descriptions; reject page content, name and URL mutations.

- Replaced incompatible metadata storage with Botble MetaBox; preserve unrelated values and verify writes.

- Record revisions and apply metadata in one transaction; reject stale previews and roll back failed writes.

- Replaced the active score-driven rewriting workflow with observable checks. Word-count/density targets no longer drive safe metadata suggestions.

- Disabled destructive AMP transformations. Lazy-loading changes skip the first editor image and images explicitly marked eager/high priority.

- Corrected internal-link field/URL handling and broken Content Briefs, Content Gap and Backlink Opportunities route references.

- Added real redirect responses, cached rules, same-site target validation and cycle protection.

- Connected schema to public rendering hooks, encoded JSON-LD safely, used Botble data accessors and preserved existing schema types.

- Preserved native sitemap preference; added paginated fallback output for pages, posts and parent products. Removed retired search-engine HTTP pings.

- Reused the original competitor crawl session, reset crawler state and moved audit work to protected background jobs.

- Added bounded public-URL fetching, IP pinning, redirect revalidation and response-size limits.

- Removed normal-request schema-table checks/automatic migrations; migrations run during activation or deployment.

- Added a registered management permission and rate limiting for metadata AI fix routes.

- Encrypted newly issued/refreshed Search Console tokens, improved API error reporting and added reporting pagination.

- Removed unreliable free Google rank scraping. Provider failures do not become fake ranks or zero-traffic measurements.

- Kept autocomplete as keyword research rather than substituting it for actual SERP pages.

- Escaped AI previews and labeled estimates, imported data and evidence coverage explicitly.

### Included 2.0.0 corrective hotfix

- Fixed public URL resolution for Botble's macro-backed attributes: read the attribute directly instead of bypassing `__get` through null coalescing.

- Normalize valid root-relative URLs and reject unsupported or ambiguous URLs.

- Replaced the nonexistent article-author `getFullName()` call with the author's `name` attribute.

- Treat an unpublished item or unusable scan URL as an actionable admin message without reporting that expected condition as an exception email. Unexpected failures remain reportable.

- Added regression cases reproducing the macro URL issue, relative/invalid URLs and Eloquent author-name access. Current suite: **142 passing checks**.

### Upgrade notes / limitations

- The full 1.x → 2.0.0 upgrade requires migration, asset publishing and queue setup. See `UPGRADE-2.0.md`.

- The four-file scan/schema hotfix for stores already running 2.0.0 needs no additional migration or asset publishing; clear caches and restart workers after replacing its files.

- No existing storefront page was automatically rewritten or restored during development. Recovery requires a reviewed saved revision or backup.

- Live integrations, production database and cross-theme/mobile behavior still require staging acceptance. No ranking guarantees; this is not a global backlink/keyword database.

## 1.0.1 — pre-enhancement package

The inspected package manifest identified itself as 1.0.1, while its README still showed 1.0.0. No trustworthy separate 1.0.1 change history was present, so specific changes are not attributed to this version.

## 1.0.0 — initial release baseline

Initial feature set documented in the original package:

- Botble product, post and page SEO panels and dashboard.

- AI-generated suggestions/content and an Apply workflow.

- Keyword research, rank tracking, competitor analysis and backlink CSV management.

- Website auditing, schema settings, sitemap tools and redirect management.

- Configurable AI providers and administrative settings.

This entry records the historical baseline, not a claim that every original function worked correctly. The 2.0.0 entries above describe the reviewed safety and compatibility corrections. Original publication dates were not verified and have intentionally not been invented.

---

## 🤝 Support

Email **support@codeupp.xyz** — average response time under 12 hours.

Website **[codeupp.xyz](https://codeupp.xyz)** · Built by **Maryam International LLC**.

> Rank higher. Sell more. Keep every dollar.