Reddit SEO

SKILL.md

Full skill file your agent reads.

---
name: reddit-seo
description: Runs Reddit SEO workflows using AI SEO Tracker data — cited Reddit URLs, brand snippets, and prompt visibility. Use when the user asks for reddit seo, Reddit comments, Reddit posts, CrowdReply, or agent outreach from AI SEO Tracker sources and prompts.
---

# Reddit SEO (AI SEO Tracker)

## 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

Use the HTTP MCP server when configured (no local build). Use the REST API only for scripts that already have an OAuth access token from the same authorization flow.

## Workflow

Copy this checklist:

```
Reddit SEO progress:
- [ ] Load sources (domain=reddit.com), prompts, snippets, competitors
- [ ] Read brand snippets — how AI describes the product
- [ ] Review Reddit sources — threads cited in AI answers
- [ ] Review prompts — winning / opportunities / missing visibility
- [ ] Draft comment replies for existing threads
- [ ] Draft new post ideas for missing/opportunity prompts
```

### Step 1 — Load data (four primitives)

**MCP** (preferred), for project slug e.g. `genppt`:

1. `get_project_sources` with `domain: "reddit.com"`
2. `get_project_prompts` (no filter, or filter by `status`)
3. `get_project_snippets` with `projectSlug` as `brand` (own brand)
4. `get_project_competitors` (optional — competitor slugs for snippet lookups)

**REST** (OAuth Bearer only — prefer MCP in agent clients; for scripts, reuse the access token from your OAuth client):

```bash
BASE="http://localhost:3000/api/agent/v1/projects/genppt"
TOKEN="your-oauth-access-token"
curl -s -H "Authorization: Bearer $TOKEN" "$BASE/sources?domain=reddit.com"
curl -s -H "Authorization: Bearer $TOKEN" "$BASE/prompts"
curl -s -H "Authorization: Bearer $TOKEN" "$BASE/snippets?brand=genppt"
curl -s -H "Authorization: Bearer $TOKEN" "$BASE/competitors"
```

### Step 2 — Understand the brand

From snippets: summarize positioning, pricing, use cases, and differentiators. Use this voice in all Reddit copy.

**MCP:** `get_project_snippets` with `projectSlug` and optional `brand` (defaults to own brand).

### Step 3 — Reddit threads to engage

From sources (reddit filter): each item has `url`, `title`, `mentionCount`, and `prompts` (queries that cited it).

Prioritize URLs with higher `mentionCount` and prompts where status is `opportunities` or `missing`.

### Step 4 — Prompt gaps

From prompts:

| Status | Meaning | Reddit action |
| --- | --- | --- |
| `winning` | Rank ≤3 in AI | Defend/share proof in relevant threads |
| `opportunities` | Mentioned but rank >3 | Comment with comparisons, link naturally |
| `missing` | Not mentioned | **New posts** targeting that query intent |

### Step 5 — Deliverables

Produce two sections:

**A. Comments** (for each high-value Reddit source URL)

```markdown
### [Thread title](url)
**Prompt context:** query from prompts array
**Angle:** ...
**Draft comment:** (authentic, helpful, not spam; disclose affiliation if recommending own product)
```

**B. New post ideas** (from `missing` + `opportunities` prompts without a matching Reddit URL)

```markdown
### r/subreddit — title idea
**Target prompt:** ...
**Outline:** ...
**Draft post:** ...
```

## Rules

- Never invent Reddit URLs — only use URLs from sources or tell the user to add prompts/sources in AI SEO Tracker first.
- Match subreddit culture; read thread titles before suggesting tone.
- Prefer helpful answers over naked promotion.
- For pitch-deck-style products: emphasize concrete use cases from snippets.