Skip to content
Back to search

simongloel-seo-aeo-pass

MarketplaceWorks with Claude CodeGitHub

SEO and AI-answer visibility skill with a multi-agent workflow.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/simongloel--seo-aeo-pass/badge.svg)](/listings/simongloel--seo-aeo-pass)

HTML

<a href="/listings/simongloel--seo-aeo-pass"><img src="/api/listings/simongloel--seo-aeo-pass/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Any agent that reads `SKILL.md` (Claude Code, Codex, Cursor, Gemini CLI, Copilot and others):

npx skills add simongloel/seo-aeo-pass

In Claude Code use `-a claude-code`, or install it as a plugin, which also registers the workflow as `/seo-aeo-pass:seo-aeo-pass`:

/plugin marketplace add simongloel/seo-aeo-pass
/plugin install seo-aeo-pass@simongloel-seo-aeo-pass

Manual: copy `skills/seo-aeo-pass/` into `~/.claude/skills/` (or your agent's skills folder).

Then ask something like "run an SEO and AEO pass on example.com" or "why doesn't our pricing page rank".

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "simongloel-seo-aeo-pass",
  3. "description": "SEO and AI-answer visibility skill with a multi-agent workflow.",
  4. "owner": {
  5. "name": "Simon Gloel",
  6. "url": "https://github.com/simongloel"
  7. },
  8. "plugins": [
  9. {
  10. "name": "seo-aeo-pass",
  11. "source": "./",
  12. "description": "SEO and AI-answer visibility from free first-party data, with an optional multi-agent workflow."
  13. }
  14. ]
  15. }
README.md · README · 84 lines
  1. # seo-aeo-pass
  2. An agent skill that runs a full SEO and AEO pass on a website: where it ranks, why it doesn't rank higher, which search terms are worth a page, whether ChatGPT, Perplexity, Gemini, Claude and Google's AI Overviews name it, and what to do first. It works from free first-party data (Search Console, your analytics, live search results, autocomplete) and uses paid keyword, backlink or AI-visibility tools only when you have them connected.
  3. It comes out of real passes on a young SaaS domain and a small agency site in 2026, with the lessons from those written in: what moved, what didn't, and which tool numbers misled us.
  4. ## What you get
  5. - **A reading** of what holds the site back most (links, intent mismatch, technical faults, wrong claims on live pages, absence from the sources AI answers cite).
  6. - **Keywords chosen by what a visitor is worth**, not by volume. Each term is checked against the live results, scored, and then a skeptic tries to kill it. Left-out terms come with the reason.
  7. - **A ranked plan** of at most 25 actions, each with its evidence and effort, and the decisions that are yours marked as such.
  8. - **Optional page drafts** for the top pages, and a **report** on disk with every number's source.
  9. Nothing is invented: no search volumes from thin air, no fake reviews or authors, no "AI visibility score" without the run count behind it.
  10. ## Two modes
  11. At the start the skill asks which one you want:
  12. - **Multi-agent workflow (recommended).** Six measurement streams in parallel, one researcher plus one skeptic per keyword cluster, a critic on the plan. In Claude Code this runs as a [workflow](https://code.claude.com/docs/en/workflows); in other agents it falls back to subagents. Better output, several times the tokens.
  13. - **Flat analysis.** One agent, same steps in sequence, less depth. Cheaper, weaker.
  14. ## Install
  15. Any agent that reads `SKILL.md` (Claude Code, Codex, Cursor, Gemini CLI, Copilot and others):
  16. ```bash
  17. npx skills add simongloel/seo-aeo-pass
  18. ```
  19. In Claude Code use `-a claude-code`, or install it as a plugin, which also registers the workflow as `/seo-aeo-pass:seo-aeo-pass`:
  20. ```
  21. /plugin marketplace add simongloel/seo-aeo-pass
  22. /plugin install seo-aeo-pass@simongloel-seo-aeo-pass
  23. ```
  24. Manual: copy `skills/seo-aeo-pass/` into `~/.claude/skills/` (or your agent's skills folder).
  25. Then ask something like "run an SEO and AEO pass on example.com" or "why doesn't our pricing page rank".
  26. ## Connect your data first
  27. The pass is much better with these two. Both are free.
  28. | Data | MCP server | Setup |
  29. |---|---|---|
  30. | Google Search Console | [AminForou/mcp-gsc](https://github.com/AminForou/mcp-gsc) | `claude mcp add gsc -e GSC_OAUTH_CLIENT_SECRETS_FILE=/abs/path/client_secrets.json -- uvx mcp-search-console` |
  31. | Google Analytics 4 | [googleanalytics/google-analytics-mcp](https://github.com/googleanalytics/google-analytics-mcp) | `claude mcp add analytics-mcp --scope user -e GOOGLE_APPLICATION_CREDENTIALS=<adc.json> -e GOOGLE_CLOUD_PROJECT=<project> -- pipx run analytics-mcp` |
  32. | or Matomo | [Matomo MCP](https://matomo.org/faq/how-to/how-to-configure-the-matomo-mcp-server/) (Cloud built in, self-hosted via the McpServer plugin) | copy the endpoint from Matomo's settings |
  33. Optional: Bing Webmaster Tools (free backlinks, keyword data and Copilot citations), and paid keyword, backlink or AI-visibility tools if you have them. `skills/seo-aeo-pass/references/data-sources.md` has the details.
  34. ## Scripts
  35. Standard-library Python 3.9+, no installs. Each prints its usage with `--help`.
  36. | Script | Does |
  37. |---|---|
  38. | `keyword_suggest.py` | Expands seeds through Google autocomplete (Bing optional) with buyer modifiers and question words |
  39. | `keyword_score.py` | Ranks terms by expected value: volume x CTR at the position you can reach x value per visit x intent and fit |
  40. | `serp_difficulty.py` | Estimates keyword difficulty from the top 10 when no tool KD exists |
  41. | `site_audit.py` | Crawls the sitemap: status, titles, descriptions, canonicals, hreflang, structured data, internal links |
  42. | `ai_readiness.py` | robots.txt for search, answer and training bots; raw-HTML word counts; bot vs browser responses; llms.txt |
  43. | `ai_visibility.py` | Asks your buyer prompts to Claude, OpenAI, Perplexity and Gemini with web search on; mention rate, citations, share of voice |
  44. | `ai_crawler_logs.py` | Reads access logs: what AI crawlers fetch, errors they hit, visits referred by AI assistants |
  45. | `authority.py` | Compares domains on popularity (Tranco) and links (Open PageRank, Common Crawl), with a score relative to the set |
  46. `references/metrics.md` explains how commercial SEO and AI-visibility tools compute volume, difficulty, authority, traffic and AI visibility, with sources, and how to approximate each from free data.
  47. ## What it contacts
  48. The skill itself sends nothing anywhere. The scripts contact only what you point them at:
  49. - your site (pages, sitemap, robots.txt, llms.txt);
  50. - `suggestqueries.google.com`, and `api.bing.com` if you ask for Bing, for autocomplete (the seed terms are sent);
  51. - `tranco-list.eu`, and `openpagerank.com` if you set `OPR_API_KEY` (domain names are sent);
  52. - the APIs of Anthropic, OpenAI, Perplexity and Google Gemini, only in `ai_visibility.py`, only for providers whose key you set, after showing the call count and asking (your prompts are sent).
  53. MCP servers you connect follow their own terms. The skill asks for a spending cap before any paid call and stays read-only on every account.
  54. ## License
  55. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.