name: LocalRank
description: Track local rankings, run SEO audits, and manage agency clients using LocalRank
author: LocalRank
repository: https://github.com/peterw/localrank-agent-skills

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
2. Get your key at https://app.localrank.so/settings/api
3. Run: <skill-path>/scripts/localrank.js setup

4. Or set environment variable: export LOCALRANK_API_KEY=lr_your_key

5. 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? [email protected]