Rankscale Geo Analytics

Fetch and interpret Rankscale GEO (Generative Engine Optimization) analytics. Pulls brand visibility score, citation rate, sentiment, and top AI search terms.

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

1. Email [e-mail] with subject: "Please activate REST API access for my account"
2. Once activated (usually within 24 hours), log into your Rankscale dashboard
3. Go to Settings → Integrations → API Keys
4. Generate a new API key (format: rk_<hash>_<brandId>)
5. 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 set RANKSCALE_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.

📧 [e-mail] 🌐 rankscale.ai

See also: references/onboarding.md for setup and first-run guidance.