Rankscale Geo Analytics

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

Security Scan

The skill's requested binaries, environment variables, runtime instructions, and code align with its stated purpose of calling the Rankscale API and generating GEO reports; nothing in the bundle appears to access unrelated systems or exfiltrate data to unknown endpoints.

Purpose & Capability

Name/description (Rankscale GEO analytics) match the declared requirements: node runtime, a single Rankscale API key, and .env for optional local persistence. The code and docs consistently call Rankscale endpoints (rankscale.ai) to fetch reports, citations, sentiment, and search-term data — all expected for this purpose.

Instruction Scope

SKILL.md instructs only to obtain a Rankscale PRO API key, set RANKSCALE_API_KEY (optionally RANKSCALE_BRAND_ID), and run node rankscale-skill.js. The code reads process.env and CLI args, makes HTTP(S) requests to rankscale.ai endpoints, and prints results. There are no instructions to read unrelated system files, harvest other credentials, or post data to unfamiliar external endpoints.

Install Mechanism

Install spec only lists 'node' as required/installed; this is proportional for a JS CLI skill. The install entry 'kind: node' / 'creates binaries: node' is slightly odd (installing Node itself may be a platform-level action), but there are no downloads from private URLs or archived extracts in the spec. Overall install behavior appears reasonable but platform integrators should confirm how 'node' is provisioned (package manager vs custom download).

Credentials

Only a single required secret (RANKSCALE_API_KEY) is declared and used as the primary credential. .env is suggested for local persistence (with chmod 600 guidance). The skill does not request unrelated tokens, passwords, or cloud credentials.

Persistence & Privilege

The skill is not force-installed (always: false). It does not request or modify other skills' configs. Autonomous invocation is allowed (platform default) but not combined with broad or unrelated credential access.

Assessment

This skill is internally coherent: it needs Node and your Rankscale PRO API key and then calls rankscale.ai to fetch GEO metrics. Before installing: (1) Confirm you trust rankscale.ai and that your API key has only the permissions you expect (the skill will send the key to Rankscale's API). (2) Prefer storing the key in your gateway's secret manager rather than a plaintext .env file; if you use .env follow the provided chmod guidance. (3) Check how your environment provisions Node (the install spec references installing node) so you know whether any system-level installer will run. (4) Review the small docs inconsistency around the base API path (some docs reference /api/v1 vs /v1/metrics/) — this is minor but you may want to verify network requests in a safe environment on first run. If you need stronger isolation, run the script in a sandboxed environment or inspect network traffic on first invocation.

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.