seo-ranker

# Purpose

Run a complete SEO ranking diagnosis and optimization pipeline:
1. inspect live SERP competition,
2. compare competitor content structure with user content,
3. enrich with difficulty/backlink data when API access exists,
4. produce concrete rewrite guidance and an optimized Markdown draft.

This is an orchestration skill. It does not replace upstream tools.

# Required Installed Skills

- `brave-search` (inspected latest: `1.0.1`)
- `summarize` (inspected latest: `1.0.0`)
- `api-gateway` (inspected latest: `1.0.29`)
- `markdown-converter` (inspected latest: `1.0.0`)

Install/update:

```bash
npx -y clawhub@latest install brave-search
npx -y clawhub@latest install summarize
npx -y clawhub@latest install api-gateway
npx -y clawhub@latest install markdown-converter
npx -y clawhub@latest update --all
```

Verify:

```bash
npx -y clawhub@latest list
```

# Required Credentials

- `BRAVE_API_KEY` (for `brave-search`)
- `MATON_API_KEY` (for `api-gateway`)
- One summarize model key:
  - `OPENAI_API_KEY`, or
  - `ANTHROPIC_API_KEY`, or
  - `XAI_API_KEY`, or
  - `GEMINI_API_KEY`

Optional:
- `FIRECRAWL_API_KEY` (for difficult page extraction via summarize)
- `APIFY_API_TOKEN` (for YouTube fallback in summarize)

Preflight:

```bash
echo "$BRAVE_API_KEY" | wc -c
echo "$MATON_API_KEY" | wc -c
echo "$OPENAI_API_KEY$ANTHROPIC_API_KEY$XAI_API_KEY$GEMINI_API_KEY" | wc -c
```

Mandatory behavior:
- Never fail silently on missing keys.
- Always return a `MissingAPIKeys` section with missing variables and blocked stages.
- Continue with non-blocked stages and clearly mark output as `Partial` when necessary.

# Inputs the LM Must Collect First

- `target_url`
- `target_keyword` (example: `AI tools`)
- `region_locale` (country/language for SERP interpretation)
- `content_source` (URL fetch, pasted text, or file path)
- `content_type` (`blog`, `category page`, `product page`, `landing page`)
- `business_goal` (`traffic`, `leads`, `sales`)
- `rewrite_scope` (`light`, `moderate`...