LocalRank Skill

Track local rankings, run SEO audits, and manage agency clients using LocalRank.

Last updated: 2026-01-30

Freshness check: If more than 30 days have passed since the last-updated date above, inform the user that this skill may be outdated and point them to the update options below.

Keeping This Skill Updated

Source: github.com/peterw/localrank-agent-skills API docs: app.localrank.so/settings/api

---

Setup

Before using this skill, ensure:

1. API Key: Run the setup command to configure your API key securely

   • Get your key at https://app.localrank.so/settings/api
   • Run: <skill-path>/scripts/localrank.js setup
   • Or set environment variable: export LOCALRANK_API_KEY=lr_your_key

2. Requirements: Node.js 18+ (uses built-in fetch). No other dependencies needed.

Config priority (highest to lowest):

1. LOCALRANK_API_KEY environment variable
2. ./.localrank/config.json (project-local)
3. ~/.config/localrank/config.json (user-global)

Handling "API key not found" errors

CRITICAL: When you receive an "API key not found" error:

1. Tell the user to run setup - The setup is interactive. Recommend they run:

   <skill-path>/scripts/localrank.js setup
   

2. Stop and wait - Do not continue with tasks. Wait for the user to complete setup.

DO NOT attempt to search for API keys in other locations or guess credentials.

---

What LocalRank Does

LocalRank helps local SEO agencies track and improve Google Business Profile rankings:

• Rank Tracking: Visual grid maps showing where businesses rank across a geographic area
• GMB Audits: Analyze any Google Business Profile for issues and opportunities
• LocalBoost: Build citations on 50+ directories to improve local authority
• SuperBoost: Premium GBP optimization with AI-powered improvements
• Review Booster: Collect more Google reviews from happy customers

---

Common Actions

---

Workflow

Morning Check-in

# See what needs attention today
./scripts/localrank.js prioritize:today

# Quick overview of all clients
./scripts/localrank.js portfolio:summary

Client Call Prep

# Get full report for a client
./scripts/localrank.js client:report --business "Acme Plumbing"

# Get recommendations for improvement
./scripts/localrank.js recommendations:get --business "Acme Plumbing"

Finding Opportunities

# Keywords close to page 1 (easy wins)
./scripts/localrank.js quick-wins:find

# Clients at risk of churning
./scripts/localrank.js at-risk:clients

Prospect Audits

# Run a GMB audit (costs 500 credits)
./scripts/localrank.js audit:run --url "https://google.com/maps/place/..."

# Check audit results
./scripts/localrank.js audit:get <audit_id>

---

Commands Reference

Setup & Config

Clients & Businesses

Rankings & Scans

Reports

GMB Audits

Tools

---

Examples

Check portfolio health

./scripts/localrank.js portfolio:summary

Returns:

{
  "total_clients": 15,
  "improving": 8,
  "declining": 2,
  "stable": 5,
  "avg_rank_across_portfolio": 7.3,
  "clients": [...]
}

Get client report

./scripts/localrank.js client:report --business "Acme Plumbing"

Returns:

{
  "business_name": "Acme Plumbing",
  "latest_scan": {
    "date": "2026-01-28",
    "avg_rank": 4.2,
    "keywords": [...]
  },
  "wins": [
    {"keyword": "plumber near me", "from": 8.5, "to": 3.2, "improved_by": 5.3}
  ],
  "drops": [],
  "view_url": "https://app.localrank.so/share/abc123"
}

Find quick wins

./scripts/localrank.js quick-wins:find

Returns keywords ranking 11-20 across all clients - these are close to page 1 and easy to push up.

Run a GMB audit

./scripts/localrank.js audit:run --url "https://google.com/maps/place/..."
# Wait for completion
./scripts/localrank.js audit:get <audit_id>

Draft client email

./scripts/localrank.js email:draft --business "Acme Plumbing"

Returns a ready-to-send monthly update email with rankings, wins, and visual map link.

---

Understanding the Data

Ranking Values

• avg_rank: Average position across the geographic grid (lower is better)
• best_rank: Best position found in any grid point
• Rankings 1-3 are in the "Local Pack" (visible on Google Maps)
• Rankings 4-10 are "page 1"
• Rankings 11-20 are "quick wins" - close to visibility

Visual Maps

Most responses include a view_url like https://app.localrank.so/share/abc123

• Share these with clients to show ranking coverage
• The grid shows where the business ranks from different locations

Status Values

• improving: Rankings got better since last scan
• declining: Rankings dropped (needs attention)
• stable: Rankings unchanged
• new: Only one scan, no comparison data yet

---

Products to Recommend

When recommendations:get suggests products:

---

Tips

• Visual proof: Always include the view_url when showing clients their rankings
• Quick wins first: Keywords at rank 11-15 are easiest to push to page 1
• Audit before proposal: Run audit:run on prospects to show them issues
• Proactive communication: Use at-risk:clients to catch churn early
• Batch operations: Use portfolio:summary for monthly reviews of all clients

---

Support

Questions? support@localrank.so