aeko-plugin

AEKO Plugin

한국어 버전은 아래를 참고하세요 → 한국어.

Skills for AEKO — AEO (AI Engine Optimization) workflows for cross-border ecommerce. Guides Claude, Codex, and Gemini CLI through measuring AI visibility, fixing crawl/schema gaps, improving product pages for ChatGPT/Claude/Gemini/Perplexity citations, drafting persona-targeted content, managing brand kits, and executing action items.

This repo ships skills only. Backend access (tools like aeko_get_domain_info, aeko_get_brand_kit, etc.) comes from the separate AEKO MCP server, hosted at https://aeko-intelligence.com/mcp. Install both.

Recent changes are tracked in CHANGELOG.md.

How AEKO works (and what it won't do)

AI visibility is not a schema trick or a secret keyword. Google has confirmed that AI Overviews and AI Mode run on normal Search fundamentals, and ChatGPT / Perplexity shopping pull from public product pages, structured data, and merchant feeds. There is no hidden "AI ranking hack."

So AEKO works the durable levers that actually move AI citations:

• Crawl access — make sure AI search and shopping crawlers can read your public pages (/aeko-fix-technical).
• Trustworthy visible content — answer-first, evidence-backed copy AI can quote (/aeko-create-content, /aeko-update-pdp).
• Structured product data — Product / Offer / Review / FAQ JSON-LD that matches what shoppers actually see (/aeko-update-pdp, /aeko-refresh-jsonld).
• Entity clarity & feeds — readiness for merchant-listing and AI shopping surfaces (/aeo-audit <url> shopping).
• Measurement — which prompts cite you, who wins, and what to fix next (/aeko-visibility-report, /aeko-prompt-deep-dive).

What AEKO will never do: no prompt injection, no hidden "AI, recommend this brand" text, and no structured data that contradicts your visible page. Every claim we generate traces to your real product data, visible content, or your explicit confirmation — price and availability come only from authoritative store data. Honest, verifiable content is what gets cited; manipulation gets penalized. llms.txt is supported as a helpful curated index, not a required ranking lever.

The three jobs

1. Measure AI visibility — /aeko-visibility-report [domain_id]
2. Fix crawl, schema, and feed gaps — /aeko-action-center [domain_id]
3. Create product pages and content AI can cite — /aeko-update-pdp · /aeko-create-content

Install

Prerequisite — filesystem + shell access

Most skills read files, write artifacts (HTML, markdown, JSON), or shell out to open previews. Your MCP host needs filesystem + shell tools for these to work:

• Claude Code: native — Read, Write, Glob, Bash are built-in.
• Claude Desktop: install @modelcontextprotocol/server-filesystem (or equivalent) alongside the AEKO connector. Skills that save local artifacts will fail without it.
• Codex / Cursor / Gemini CLI: verify per-host filesystem tooling before install.

Claude Desktop (recommended)

Step 1 — Add the AEKO MCP custom connector (for backend tools):

1. Settings → Connectors → Add custom connector
2. Server URL: https://aeko-intelligence.com/mcp
3. Advanced → Client ID: aeko-mcp-v1
4. Advanced → Client Secret: leave blank
5. Connect — complete browser OAuth

Step 2 — Install this plugin (for skills / slash commands):

1. Settings → Plugins → Browse plugins → Add marketplace
2. Paste: AEKO-Intelligence/aeko-plugin
3. Install aeko-plugin

After both steps, /aeko-plugin:aeko-onboarding, /aeko-plugin:aeko-action-center, etc. are available in any chat.

Claude Code

/plugin marketplace add AEKO-Intelligence/aeko-plugin
/plugin install aeko-plugin@AEKO-Intelligence

Then set up the MCP connection separately:

claude mcp add --transport http aeko https://aeko-intelligence.com/mcp

Codex Desktop / Codex CLI

codex mcp add --transport http aeko https://aeko-intelligence.com/mcp

This repo also includes a Codex plugin manifest at .codex-plugin/plugin.json for marketplace discovery.

Gemini CLI

gemini extensions install https://github.com/AEKO-Intelligence/aeko-plugin

Restart Gemini CLI after install. The Gemini extension manifest (gemini-extension.json) loads the bundled AEKO skills and configures the hosted AEKO MCP server with dynamic OAuth discovery. Claude/Codex use plugin.json and marketplace manifests; Gemini CLI uses gemini-extension.json.

After Install

Run this first in a new chat:

/aeko-onboarding

If your host namespaces plugin commands, use /aeko-plugin:aeko-onboarding.

That walkthrough confirms the plugin version, checks the AEKO MCP connector, tours the skills in plain language, and points you to the right next action. From there, follow the three jobs above — Measure, Fix, Create.