seo-competitor-pages Checked

5. **Fetch existing comparison pages** WebFetch (always) + mcp__firecrawl-mcp__firecrawl_scrape (when available)

• **WebFetch first** (free): pull the top 3 SERP winners' markdown. Extract H2 outline, feature-matrix dimensions, verdict pattern, CTA placement.
• **Firecrawl second** (3 Firecrawl credits — 1 per winner) — recovers what WebFetch markdown can't show:
• Schema types from <script type="application/ld+json"> blocks (Product ×N, BreadcrumbList, FAQPage, Review, AggregateRating).
• og:title / og:description / og:image / twitter:card from metadata.
• <title> and meta description lengths from real HTML.
• **If Firecrawl unavailable:** WebFetch portion runs unchanged. The "schema types" line in evidence/04-existing-pages-teardown.md reads (skipped — Firecrawl required for JSON-LD). Schema generation in step 8 falls back to a default Product + BreadcrumbList + FAQPage template instead of mirroring whatever the winners use.
• This anchors the draft in observed-rewarded-pattern.

5b. **Bulk competitor scrape** mcp__firecrawl-mcp__firecrawl_scrape (optional, opt-in)

• When user passes --bulk-scrape <urls> or supplies a list of competitor URLs to compare directly (beyond the SERP top-3), Firecrawl-scrape each URL.
• For each URL, extract: <title>, og:*, twitter:*, JSON-LD @types, hero-image presence, pricing-block detection (regex on prose for $N/mo, €N/mo, etc.), CTA count, comparison-table presence, free-tier-mention boolean.
• Output competitor-elements.csv — one row per competitor URL × these signals.
• Cost: 1 Firecrawl credit per URL. Surface estimate before running; refuse >50 URLs without --confirm-cost.

6. **Pull keyword comparison data** DATA_getDomainKeywordsComparison (if available for the brands)

• Side-by-side keyword overlap.

7. **Build feature matrix**

• Dimensions inferred from the top SERP winners (e.g., "Pricing", "Free tier", "Integrations", "Support tiers", "Best for").
• Cells: ✓ / ✗ / partial / "TBD — confirm with PM" placeholders for fields you can't auto-infer.
• Where SE Ranking data informs a cell (e.g., "ranks for X enterprise keywords"), pull the number.

8. **Synthesise** COMPARISON.md

• Hero (target keyword in H1, balanced positioning).
• TL;DR / verdict box in first 200 words.
• Feature matrix.
• Section per major dimension (each H2 = one dimension).
• PAA-derived FAQ (top 3–5 questions from step 4).
• Verdict / recommendation.
• CTA flow.
• Schema-ready JSON-LD: Product (×N) + BreadcrumbList + FAQPage (if real Q&A).

Output format

Create a folder seo-competitor-pages-{target-slug}-{YYYYMMDD}/ with:

seo-competitor-pages-{target-slug}-{YYYYMMDD}/
├── COMPARISON.md                     (the page draft — primary deliverable)
├── 05-feature-matrix.md              (inferred dimensions × brands — load-bearing reference for PMs/writers)
├── schema.jsonld                     (paste-ready Product + Breadcrumb + FAQ — load-bearing artefact for engineering)
├── 05b-competitor-elements.csv       (only if --bulk-scrape ran: competitor URL × on-page-element grid)
└── evidence/
    ├── 01-competitor-context.md      (DATA_getDomainCompetitors — raw step output)
    ├── 02-keyword-overlap.md         (DATA_getDomainKeywords for each brand — raw step output)
    ├── 03-comparative-serp.md        (top 10 + PAA for the target keyword — raw step output)
    └── 04-existing-pages-teardown.md (top-3 SERP winners' structure + schema/og — Firecrawl-recovered)

Top-level: COMPARISON.md + 05-feature-matrix.md + schema.jsonld. The 01–04 step files preserve raw API/scrape outputs in evidence/. 05b-competitor-elements.csv only appears when --bulk-scrape was passed.

COMPARISON.md for an "X vs Y" page follows this shape:

# {User's Brand} vs {Competitor}: 2026 Comparison

> Updated {YYYY-MM-DD}. Compare {Brand A} and {Brand B} on pricing, features, integrations, and best-fit use case.

## TL;DR
{One paragraph balanced verdict — when to choose A, when to choose B}

## At a glance

| Dimension | {Brand A} | {Brand B} |
|---|---|---|
| Starting price | {$X/mo} | {$Y/mo} |
| Free tier | {✓/✗} | {✓/✗} |
| Best for | {use case} | {use case} |
| Integrations | {n} | {n} |
| Support | {tier} | {tier} |
| ... | | |

## {Dimension 1 header — e.g., Pricing}
{Side-by-side detail, balanced. Avoid hyperbole.}

## {Dimension 2 header — e.g., Features}
{...}

## {Dimension 3 header — e.g., Integrations}
{...}

## {Dimension 4 header — e.g., Support}
{...}

## When to choose {Brand A}
- {scenario 1}
- {scenario 2}
- {scenario 3}

## When to choose {Brand B}
- {scenario 1}
- {scenario 2}
- {scenario 3}

## FAQ
**{PAA question 1}**
{Answer}

**{PAA question 2}**
{Answer}

**{PAA question 3}**
{Answer}

## Get started
{Brand A} CTA — {link}
{Brand B} CTA — {link if balanced; otherwise drop}

## Schema
See `schema.jsonld` — paste into `<head>`.

Tips

• **Balance is conversion.** Pages that pretend the user's product is always better lose trust and rankings. Honest assessments outperform partisan ones.
• Respect rate limit. Step 5 (fetching top 3 SERP winners) takes 3 WebFetch calls + earlier MCP queries.
• Cost: ~15–25 SE Ranking credits typical, +3 Firecrawl credits for the schema/og benchmark in step 5, +1 Firecrawl credit per URL in step 5b (opt-in only). Pass --no-firecrawl to skip both Firecrawl steps.
• **Schema:** use Product for both products in a vs page, plus BreadcrumbList, plus FAQPage if the FAQ section is real Q&A (not a manufactured one).
• For "alternatives to X" pages, positi