Comparison Page Writer

SKILL.md

Full skill file your agent reads.

---
name: comparison-page-writer
description: Drafts "you vs competitor" comparison pages from snippet and prompt data. Use for alternative pages, vs pages, or migration landing pages.
---

# Comparison Page Writer

## Prerequisites

AI SEO Tracker MCP must be connected before running this skill.

1. Open AI SEO Tracker -> Project Settings -> Agent (`/p/{projectSlug}/settings/agent`).
2. Copy the MCP URL shown on that page (`https://aiseotracker.com/api/agent/mcp` for this environment).
3. Add it to your MCP-capable client. Cursor example:

```json
{
  "mcpServers": {
    "aiseotracker": {
      "url": "https://aiseotracker.com/api/agent/mcp"
    }
  }
}
```

4. Reload/restart your MCP client so it discovers the new server. In Cursor, reload the window after saving `.cursor/mcp.json`.
5. In Cursor, open Settings -> MCP, find `aiseotracker`, and click **Connect**.
6. Approve the AI SEO Tracker OAuth prompt in the browser. No API key or static token is required.
7. If a tool call returns `agent_auth_required`, the client has not completed OAuth yet. Reconnect/reload MCP from the Agent settings page and retry.

Available MCP tools:

- `get_project_sources` - citation URLs and domains; optional `domain` filter
- `get_project_prompts` - tracked prompts, visibility status, and ranks; optional `status`
- `get_project_snippets` - how AI describes a brand
- `get_project_competitors` - tracked competitor brands

## Workflow

```
- [ ] get_project_competitors (pick one rival)
- [ ] get_project_snippets (your brand + rival brand slug)
- [ ] get_project_prompts (prompts where both appear or you are opportunities)
```

## Output

```markdown
# [You] vs [Rival]
## TL;DR
## When to choose [You]
## When to choose [Rival] (be fair)
## Feature comparison table
## Pricing (only if in snippets)
## What AI says (paraphrase snippets, cite prompt context)
## CTA
```

Fair, specific, grounded in MCP data. No fabricated features.

Related skills

• Content Brief from GapsArticles for missing prompts