SEO - AI Advisor

General Information

Writing meta titles, descriptions and keywords for thousands of products is the kind of work that never ends. SEO copy gets rewritten every time the product range, the brand voice or the search landscape shifts. For most merchants it sits permanently at the bottom of someone's to-do list.

The Qoliber SEO Advisor AI extension brings the four leading large-language-model providers — OpenAI (ChatGPT), Google (Gemini), Anthropic (Claude) and xAI (Grok) — directly into the product and category edit forms. One click on the Check SEO button opens a popup with model-generated meta titles, descriptions, keywords, and prose-level recommendations grounded in the entity you're editing right now.

What Does This Extension Do?

• Adds a "Check SEO" button to product and category admin forms. One click sends the entity's current SEO attributes to your chosen AI provider and renders the response in a clean popup.
• Supports four providers — ChatGPT (GPT-4.1-mini default), Gemini (2.5 Flash default), Claude (Sonnet 4.6 default), Grok (3 default). Switch providers per use case; pay only for what you call.
• Customisable system prompt — admin-editable Twig template with placeholders for entity type and SEO attributes. Encode your brand voice, language preferences and SEO guidelines once.
• Live model lists — the model dropdown is auto-populated from each provider's API and cached for 24 hours. Swap to the latest model the day it ships, no module update required.
• Structured JSON output for Gemini and Claude — no more parsing markdown fences. Suggestions arrive as fielded data ready to be pasted into the form.
• Retry with exponential backoff — transient HTTP 429 / 5xx errors from upstream providers are retried up to three times with capped delays. Rate-limit spikes don't surface as user-visible errors.
• CSRF-protected and input-validated — entity types and attribute keys are whitelisted; payload size is capped at 8 KB; form keys protect every request.

Why Is This a Game Changer?

• Bring-your-own-key. You use your own OpenAI / Anthropic / Google / xAI account. We don't proxy your data through a qoliber service, we don't add a margin to your token spend, and your prompts never leave your provider relationship.
• Prompt-engineered for SEO, not generic chat. The default system prompt is tuned for meta-title length, description CTR best practice, and keyword diversity — not "write me a poem about your product".
• Provider-agnostic. A/B test models per category. Use Claude for editorial copy, Gemini for cost-sensitive bulk runs, ChatGPT for the long-tail. Your choice.
• Lives where the work happens. The admin button appears next to the meta fields you're editing. Suggestions are one click and one copy-paste away — no separate tool, no separate browser tab.

How Does It Work?

When a merchant clicks Check SEO, the module:

1. Collects the entity's current SEO-relevant attributes (name, description, meta fields).
2. Renders the admin-configured system prompt with those attributes substituted in.
3. Calls the chosen provider's API with structured-output settings where supported.
4. Streams the response back into the admin popup, ready to copy.

The merchant reviews and pastes — the AI never writes directly to the database.

Configuration at a glance

Find the module under Stores → Configuration → Qoliber → SEO: Advisor AI. Add API keys for any subset of the four providers, choose your default model, and customise the system prompt. The Check SEO button appears on every product and category edit form.

What's New in 2.1

• Structured JSON output for Gemini and Claude — clients no longer parse markdown fences out of free-text responses.
• Retry with exponential backoff — three attempts, 5-second cap, transparent to the merchant.
• Critical DI fix — the AI provider registry is now wired correctly at runtime; pre-2.1 installs may have seen empty responses on first call.
• Hardened input validation — entity types restricted to product / category / cms_page; attribute keys filtered against a 7-field whitelist; 8 KB payload cap.