Akii — SEO & AI Search Optimizer

Free AI-powered SEO, AEO, and GEO toolkit by Akii for Claude Code.

Aligned with Google's AI Optimization Guide for Google AI Overviews + AI Mode — and extends those foundations to the 5 other engines (ChatGPT, Claude, Gemini, Perplexity, Copilot) using peer-reviewed cross-engine research where Google doesn't have jurisdiction.

All skills run on your Claude Code session model (Claude Sonnet / Opus / etc) — same model you're already using.

Audit websites, plan content strategy, optimize pages, generate schema markup, cluster keywords, estimate your AI visibility for ChatGPT, Claude, Gemini, Perplexity, Copilot, and Google AI Overviews, generate llms.txt for non-Google AI crawlers, and apply the cross-engine GEO rewrite tactics from the Princeton/IIT Delhi study (Aggarwal et al., KDD 2024, arXiv:2311.09735) — all without leaving your terminal or IDE.

On AI visibility analysis: the ai-visibility skill uses public web signals in your Claude Code session, or observations from a connected Ahrefs Brand Radar MCP. It does not request an Akii-hosted numeric score and does not directly query the named engines. See AUTHORITIES.md for methodology and source limits.

See AUTHORITIES.md for how each source is scoped (Google guide → Google AI surfaces · Princeton paper → cross-engine GEO tactics · FirstPageSage breakdown → per-engine signal correlations).

Installation

Install directly from this GitHub repo. Inside the Claude Code prompt, run these as two separate commands — paste the first, press Enter, then paste the second. Pasting both at once concatenates them with a space and Claude Code treats the whole blob as one broken /plugin marketplace add call.

Step 1 — add the marketplace:

/plugin marketplace add https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer

Step 2 — install the plugin:

/plugin install akii-seo-ai-search-optimizer@akii

Use the full https:// URL above — the short owner/repo form makes Claude Code clone via SSH on some systems and fails if you don't have a GitHub SSH key configured.

Submitted to the Anthropic community marketplace — pending review. Once accepted, you'll also be able to install with:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install akii-seo-ai-search-optimizer@claude-community

Updating

Third-party Claude Code marketplaces have auto-update disabled by default. Two paths:

Recommended — enable auto-update once, never think about it again:

/plugin

Press Enter, navigate to Marketplaces tab → akii → Enable auto-update.

After that, every Claude Code startup refreshes the marketplace + updates installed plugins to the latest version. A notification will prompt /reload-plugins if updates landed.

Manual update per release: paste each command separately, press Enter between:

/plugin marketplace update akii

/reload-plugins

The first refreshes the marketplace catalog from GitHub; the second activates the updated plugin in the current session.

Quick start

After install, try this first to see what the plugin does — just ask in natural language:

"What's my AI visibility for yourdomain.com?"

The ai-visibility skill auto-triggers and builds a per-engine public-signal map for ChatGPT, Claude, Gemini, Perplexity, Copilot, and Google AI Overviews. It labels proxy estimates, discloses the sources used, and uses connected Ahrefs Brand Radar observations when available. From there, ask things like "audit my site", "compare my SEO against competitor.com", or "apply GEO optimization to ./blog/my-post.md". Skills auto-trigger on natural language.

What's included

Skills (12)

Skills activate automatically when you ask about these topics. Grouped by workflow:

Audit

Optimize

Content

AI Search

Localization

Agents (5)

Autonomous agents for deep, multi-step work. Each agent has a fast-path skill counterpart (see routing table below). Agents only fire on explicit "deep / agent / autonomous / bulk" phrasing — never on generic triggers.

Routing contract

When in doubt, the skill is the default for any question in its capability area. The agent only triggers when the user explicitly says one of: deep, agent mode, autonomous, bulk, across my site, every page, 5+ competitors, comprehensive. If you want the agent specifically, name it: e.g. "run the schema-generator agent".

Commands (3)

Three argument-driven slash commands for operations that benefit from positional $ARGUMENTS parsing. Everything else triggers through the skill catalog above — either via natural language ("translate this to German", "generate schema for this page") or by typing the skill's slash slug (/akii-seo-ai-search-optimizer:content-translation, /akii-seo-ai-search-optimizer:schema-markup, etc.).

Examples

# Review your public AI visibility signals and per-engine fixes
"What's my AI visibility for example.com?"

# Research topics for your niche
/create-topic "SaaS marketing"

# Full SEO + AEO + GEO audit
"Audit the SEO of my website"

# Generate content
/create-content "how to improve website speed"

# Quick check on the open file
/check-file src/app/page.tsx

# Per-engine AI visibility breakdown
"How does my brand rank in ChatGPT vs Gemini vs Perplexity vs Claude?"

# Localize for Mexico
"Translate this to Spanish (Mexico)"

# Cluster keywords
"Cluster these keywords: seo tools, best seo software, seo audit, website optimization, keyword research tool"

# Generate schema for the open file
"Generate Article schema for this file"

# Compare against competitors
"Compare my SEO against competitor1.com and competitor2.com"

# Apply Princeton GEO method to a blog post
"Apply GEO optimization to ./blog/my-post.md"  # routes to optimize-page --mode=geo

# Generate llms.txt for the AI crawlers
"Generate llms.txt for this site"

Auto-detected third-party MCPs

The plugin works standalone using Claude's built-in tools (WebFetch, WebSearch, Read, Glob, Grep, Bash). But if you've already connected any of the following MCPs, skills automatically use them for richer, real-data outputs:

No extra configuration needed. Skills auto-detect and degrade gracefully if the MCP isn't installed.

Telemetry

The plugin sends a single anonymized HTTP POST to https://akii.com/api/plugin-telemetry at most once per machine per 24 hours from the SessionEnd hook. The full payload is:

{
  "plugin_version": "2.9.0",
  "session_hash": "<16-hex-char sha256 prefix of machine UUID>",
  "os": "Darwin",
  "timestamp": "2026-05-27T18:00:00Z"
}

That is the entire payload. The plugin never sends code, file paths, prompts, skill outputs, audited domains, bash commands, or anything else from your session. We use this to count active installs and version distribution. Full details — what's collected field-by-field, what isn't, why, and how to verify the implementation locally — are in PRIVACY.md.

To disable, set any one of:

Telemetry is default-off on Amazon Bedrock, Google Cloud Vertex, Microsoft Foundry, and Claude Platform on AWS, matching Anthropic's own posture for commercial-provider users.

Compatibility

If you hit a compatibility issue with a newer Claude Code release, please open an issue with claude --version output. Full compatibility matrix (MCPs, env vars, known limitations) is in COMPATIBILITY.md.

This free plugin and the legacy Akii platform

The platform column records the legacy Akii SaaS feature set. It is not an offer to buy new Akii SaaS access. This documentation change does not change any existing customer agreement.

Akii Technologies builds, owns, and runs AI products. Explore Marquorum, Revenue Scout, and our free SEO & AI Search Optimizer plugin.

Why free?

We believe every website deserves great SEO + AEO + GEO. This toolkit gives you professional-grade visibility capabilities right inside your AI assistant — with no login, no signup, no usage cap.

This free plugin is separate from the legacy Akii SaaS. The table keeps those old platform features for reference. This change leaves existing customer agreements unchanged.

Contributing

PRs welcome. See CONTRIBUTING.md for repo layout, validator gate, skill / agent / command authoring conventions, citation rules, and the release process.

Security

Report vulnerabilities privately per SECURITY.md. Please do not open a public issue.

License

MIT — free for personal and commercial use.

Built by Akii Technologies, an AI venture builder that builds, owns, and runs AI products.