# Toprank

> AI-powered SEO/SEM automation suite with 6 specialised skills. Google Search Console integration, content writing (E-E-A-T), keyword research, meta tag optimisation, JSON-LD schema markup, and GEO (Generative Engine Optimisation) for AI citations. Use when doing SEO audits, keyword research, schema markup, or AI search citation optimisation.

- Skill: `dreamlab-ai/toprank` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add dreamlab-ai/toprank`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dreamlab-ai/toprank/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: dreamlab-ai (https://skillmd.com/u/dreamlab-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dreamlab-ai/toprank

---


# Toprank SEO Suite

AI-powered SEO and SEM automation through 6 specialised skills with Google Search Console integration.

## When to Use This Skill

- **SEO audits**: "analyse my SEO", "why is traffic down", "technical SEO audit"
- **Content creation**: "write blog post about X", "improve this page for SEO"
- **Keyword research**: "keyword research for [topic]", "content ideas", "search volume"
- **Meta tag optimisation**: "optimise title tag", "improve CTR", "social preview"
- **Schema markup**: "add schema markup", "rich snippets", "FAQ schema"
- **AI search optimisation**: "optimise for AI", "appear in AI answers", "GEO"

## When Not to Use

- For Answer Engine Optimisation with **no SEO context** -- use `bencium-aeo` instead; it owns
  the GEO/AI-citation technique library (`geo-content-optimizer` below is a pointer to it, kept
  for when GEO work happens inside a toprank SEO engagement)
- For general web research -- use `perplexity-research` instead
- For URL content analysis -- use `gemini-url-context` instead
- For LinkedIn/social media optimisation -- use `linkedin` instead

## Sub-Skills

7 nested sub-skills, each with its own `SKILL.md`, reachable only through this table (they are
intentionally **not** independently listed in `SKILL-DIRECTORY.md` or the router's
routing-table — this is the deliberate nested-pack pattern, not an oversight):

| Skill | Trigger | What It Does |
|-------|---------|-------------|
| `seo-analysis` | "SEO audit", "traffic down", "search console" | Full audit with GSC data, technical crawl, search intent, 30-day action plan |
| `content-writer` | "write blog post", "improve page" | E-E-A-T compliant content, blog posts, landing pages |
| `keyword-research` | "keyword research", "content ideas" | Keyword discovery, intent classification, topic clusters |
| `meta-tags-optimizer` | "optimise title", "improve CTR" | Title/description/OG tags, social preview optimisation |
| `schema-markup-generator` | "schema markup", "rich snippets" | JSON-LD structured data for articles, FAQ, products, etc. |
| `geo-content-optimizer` | "optimise for AI", "AI answers" | **Pointer** to `bencium-aeo`'s GEO technique library, framed for SEO-workflow use |
| `toprank-upgrade` | (internal) | Suite upgrade/maintenance tooling |

## Setup

```bash
# Install dependencies
pip install -r requirements.txt (from the toprank skill directory)

# Authenticate with Google Search Console
gcloud auth application-default login
```

The skill auto-detects your site URL when run inside a website repo.

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `GOOGLE_APPLICATION_CREDENTIALS` | For GSC | Path to service account JSON (or use `gcloud auth`) |

## Architecture

```
┌─────────────────────────────────┐
│  Claude Code / Skill Invocation │
└──────────────┬──────────────────┘
               │ Loads sub-skill SKILL.md
               ▼
┌─────────────────────────────────┐
│  Toprank Sub-Skill              │
│  (seo-analysis, content-writer, │
│   keyword-research, etc.)       │
└──────────────┬──────────────────┘
               │ Python scripts
               ▼
┌─────────────────────────────────┐
│  Google Search Console API      │
│  + Site crawling + Analysis     │
└─────────────────────────────────┘
```

## Integration with Other Skills

- `perplexity-research`: Research competitor strategies before keyword planning
- `bencium-aeo`: The GEO/AI-citation technique authority (see `geo-content-optimizer` above,
  which now points at it). Use `bencium-aeo` directly for AI-citation work with no SEO context;
  use toprank's `geo-content-optimizer` pointer when GEO is one step inside a broader SEO
  engagement running through this suite.
- `report-builder`: Generate comprehensive SEO reports with charts and Wardley maps
- `wardley-maps`: Map SEO component evolution and competitive positioning