# Send Rankscale Geo Analytics to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "rs-geo-analytics",
    "name": "Rankscale Geo Analytics",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Mathias-RS/rs-geo-analytics",
    "canonicalUrl": "https://clawhub.ai/Mathias-RS/rs-geo-analytics",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/rs-geo-analytics",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=rs-geo-analytics",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "API_ENDPOINT_CLARIFICATION.md",
      "assets/onboarding.md",
      "docs/API_ENDPOINT_CLARIFICATION.md",
      "docs/ARCHITECTURE.md",
      "rankscale-skill.js",
      "README.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/rs-geo-analytics"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/rs-geo-analytics",
    "downloadUrl": "https://openagent3.xyz/downloads/rs-geo-analytics",
    "agentUrl": "https://openagent3.xyz/skills/rs-geo-analytics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/rs-geo-analytics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/rs-geo-analytics/agent.md"
  }
}
```
## Documentation

### 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.ai with 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 set RANKSCALE_API_KEY.

### Features

FeatureDescriptionCLI FlagGEO OverviewFull visibility report + search terms breakdown(default)Engine Strength ProfileVisibility spread across all tracked AI engines--engine-profileContent Gap AnalysisTopics and queries where your brand has low visibility--gap-analysisReputation ScoreSentiment-based 0–100 brand health score--reputationEngine Gainers & LosersTop movers vs prior period, per engine--engine-moversSentiment Shift AlertTrend detection + risk flags for sentiment changes--sentiment-alertsCitation IntelligenceAuthority 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?"

### 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Mathias-RS
- Version: 1.0.11
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/rs-geo-analytics)
- [Send to Agent page](https://openagent3.xyz/skills/rs-geo-analytics/agent)
- [JSON manifest](https://openagent3.xyz/skills/rs-geo-analytics/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/rs-geo-analytics/agent.md)
- [Download page](https://openagent3.xyz/downloads/rs-geo-analytics)