diegosouzapw Rankscale GEO Analytics
The best generative engine optimization and AI rank tracking for ChatGPT, Perplexity, Gemini, Claude, DeepSeek, Mistral, and more.
Overview
RS-Skill connects OpenClaw to the Rankscale API, bringing your brand's AI search performance directly into your assistant. Get visibility scores, reputation analysis, content gap reports, citation intelligence, and more — all in one place.
Ask your assistant questions like:
- "How is my brand performing across AI engines?"
- "Where are my content gaps this week?"
- "Find PR opportunities for my brand."
- "What's our reputation score and what's dragging it down?"
- "Which AI engines am I losing ground on?"
Quick Start (3 Steps)
Step 1 — Create a Rankscale Account (PRO account required — trial not sufficient) Sign up at rankscale.ai and set up your brand profile.
⚠️ Requirements: A Rankscale PRO account (or higher) is required. Trial accounts do not have REST API access. You must be on PRO before requesting API activation.
Step 2 — Request REST API Access & Get Your API Key
- Email
support@rankscale.aiwith subject: "Please activate REST API access for my account" - Once activated (usually within 24 hours), log into your Rankscale dashboard
- Go to Settings → Integrations → API Keys
- Generate a new API key (format:
rk_<hash>_<brandId>) - Copy it immediately — it's only shown once
The Brand ID is embedded in your API key suffix and will be extracted automatically.
Step 3 — Set Environment Variables Add to your OpenClaw Gateway config:
RANKSCALE_API_KEY=rk_...
The Brand ID is optional (auto-extracted from your API key):
RANKSCALE_BRAND_ID=... # Optional — only if querying a different brand
Then run: node rankscale-skill.js --discover-brands to verify your setup.
Tip: Your API key format is
rk_<hash>_<brandId>. The Brand ID is automatically extracted, so you usually only need to setRANKSCALE_API_KEY.
Features
| Feature | Description | CLI Flag |
|---|---|---|
| GEO Overview | Full visibility report + search terms breakdown | (default) |
| Engine Strength Profile | Visibility spread across all tracked AI engines | --engine-profile |
| Content Gap Analysis | Topics and queries where your brand has low visibility | --gap-analysis |
| Reputation Score | Sentiment-based 0–100 brand health score | --reputation |
| Engine Gainers & Losers | Top movers vs prior period, per engine | --engine-movers |
| Sentiment Shift Alert | Trend detection + risk flags for sentiment changes | --sentiment-alerts |
| Citation Intelligence | Authority ranking, gap analysis, engine preferences, PR targets | --citations |
Real Example Prompts
These prompts work out-of-the-box with RS-Skill connected to OpenClaw:
1. Daily brand health check
"Give me my Rankscale GEO overview for this week."
2. Engine-specific strategy
"Which AI engines am I weakest on? Show me my engine strength profile."
3. Content planning
"What topics should I be writing about? Run a content gap analysis."
4. PR campaign prep
"Find citation gaps vs my competitors and suggest PR targets."
node rankscale-skill.js --citations full
5. Reputation monitoring
"Is our brand reputation improving or declining? Any risk areas?"
Usage Examples
GEO Overview (default)
node rankscale-skill.js
Sample output (healthy brand):
=======================================================
RANKSCALE GEO REPORT
Brand: AcmeCorp | 2026-02-19
=======================================================
GEO SCORE: 72 / 100 [+5 vs last week]
CITATION RATE: 55.5% [Industry avg: 45%]
SENTIMENT: Pos 61% | Neu 29% | Neg 10%
-------------------------------------------------------
TOP AI SEARCH TERMS
1. "best crm software" (500 mentions)
2. "crm comparison" (300 mentions)
3. "crm pricing" (200 mentions)
-------------------------------------------------------
GEO INSIGHTS [1 action]
[INFO] Strong positive momentum detected.
Action: Maintain current content cadence.
Double down on formats producing citations.
Consider expanding to adjacent topics.
-------------------------------------------------------
Full report: https://rankscale.ai/dashboard/brands/[your-brand]
=======================================================
Engine Strength Profile
node rankscale-skill.js --engine-profile
Sample output (live API — ROA-40 test run, 2026-02-26):
-------------------------------------------------------
ENGINE STRENGTH PROFILE
-------------------------------------------------------
Engine Visibility Score
Average ────────────────── 69.3
-------------------------------------------------------
mistral_larg ██████████████████████ 83.2 ✦
deepseek_cha █████████████████████ 79.5 ✦
chatgpt_gui ████████████████████ 77.5 ✦
perplexity_s ████████████████████ 73.9
google_ai_ov ███████████████████ 73
google_ai_mo ███████████████████ 70.8
google_gemin ██████████████████ 66.2
openai_gpt-5 ████████████████ 60.1 ▼
anthropic_cl ███████████████ 57.7 ▼
perplexity_g █████████████ 50.7 ▼
-------------------------------------------------------
✦ Top-3 engines ▼ Bottom-3 engines
Content Gap Analysis
node rankscale-skill.js --gap-analysis
Sample output (from live test data):
-------------------------------------------------------
CONTENT GAP ANALYSIS
-------------------------------------------------------
ENGINE GAPS (vs avg 44.5):
▼ grok score: 15 gap:-29.5
▼ gemini score: 20 gap:-24.5
LOW-VISIBILITY TERMS (<50%) — 3 found:
email campaigns ░ 5%
sales pipeline ░░░░ 18%
marketing automation ░░░░░░░░ 42%
RECOMMENDATIONS:
1. Create content targeting top 3 gap terms:
• "email campaigns"
• "sales pipeline"
• "marketing automation"
2. Optimise for grok: score 15 vs avg 44.5
-------------------------------------------------------
Reputation Score
node rankscale-skill.js --reputation
Sample output (live test data, brand with sentiment keywords):
-------------------------------------------------------
REPUTATION SCORE & SUMMARY
-------------------------------------------------------
Score: ██████████████████░░░░░░░░░░░░ 61/100
Status: Good Trend: ↑ improving
Sentiment breakdown:
Positive: 56.2% Negative: 15.7% Neutral: 28.1%
Top positive signals:
easy to use, great support, powerful
Risk areas:
expensive, slow
Summary: Brand health is good (61/100) and improving.
Monitor: expensive, slow.
-------------------------------------------------------
Citation Intelligence
node rankscale-skill.js --citations
node rankscale-skill.js --citations full
node rankscale-skill.js --citations gaps
Sample output:
🔗 Citation Intelligence
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Top Sources:
1. techcrunch.com 42 citations 🟢 High authority
2. forbes.com 38 citations 🟢 High authority
3. g2.com 21 citations 🟡 Mid authority
Gap vs Competitors:
Competitor A leads +31 citations on Perplexity
Competitor B leads +18 citations on Gemini
PR Targets:
→ wired.com (competitor coverage, not yours)
→ venturebeat.com (high Gemini indexing)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
All Commands
node rankscale-skill.js [flag]
--help Show help
--discover-brands List your tracked brands
--engine-profile Engine strength analysis
--gap-analysis Content gap finder
--reputation Brand reputation score
--engine-movers Top gainers and losers by engine
--sentiment-alerts Sentiment trends + risk detection
--citations Citation intelligence overview
--citations authority Top citation sources ranked
--citations gaps Gaps vs competitors
--citations engines Per-engine citation breakdown
--citations correlation Citation↔Visibility correlation
--citations full All citation sections + PR targets
For a full command reference, see → references/COMMANDS.md
For detailed feature guides, see → references/FEATURES.md
For real usage scenarios, see → references/EXAMPLES.md
For troubleshooting help, see → references/TROUBLESHOOTING.md
What's Next?
Enhancements planned for future versions:
- Competitor comparison view — Side-by-side delta scores vs tracked competitors
- Detection rate metric — "Content Gap Investigation" rule for low-detection brands
- Engine-specific optimization rules — Tailored advice when engine disparity > 30 pts
- Scheduled reports — Auto-run weekly summary via OpenClaw cron
- Multi-brand switching — Quick brand toggle without changing env vars
- Export to PDF/CSV — Shareable reports for team or client delivery
Support
Questions? We are happy to support.
📧 support@rankscale.ai
🌐 rankscale.ai
See also: references/onboarding.md for setup and first-run guidance.