什么是 LocalRank？

LocalRank 是专为 SEO 机构和本地企业主设计的 Openclaw Skills 集成。它提供了一个技术接口，通过可视化网格地图和全面的排名数据来监控 Google 商家资料 (GBP) 的表现。

通过集成此技能，开发人员和 SEO 专业人员可以自动执行追踪本地可见性、识别排名下降以及生成客户报告的过程。该技能专注于可操作的见解，例如识别企业接近搜索结果首页的“快速获胜”机会。它简化了本地 SEO 管理的生命周期，从最初的潜在客户审计到持续的性能优化和客户留存。

下载入口:https://github.com/openclaw/skills/tree/main/skills/peterw/localrank-agent-skills

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

LocalRank 应用场景

• 自动化代理机构的每日例行检查，以划分客户任务的优先级。
• 为客户会议或更新邮件生成可视化排名报告。
• 通过在客户流失前检测到明显的排名下降来识别风险客户。
• 在销售过程中审计潜在客户的 Google 商家资料，以发现优化机会。
• 搜寻排名在 11-20 位之间的关键词，以展示即时的排名提升效果。

1. 通过配置 LocalRank API 密钥并验证 Node.js 要求来初始化环境。
2. 查询投资组合摘要，根据最近的排名变化确定哪些客户需要立即关注或优化。
3. 针对特定的企业 URL 执行详细的排名扫描或 GMB 审计，以收集跨地理网格的细粒度性能数据。
4. 分析返回的数据，包括平均排名和可视化网格坐标，以评估本地权威性和可见性。
5. 根据 Openclaw Skills 接口提供的综合性能指标，自动生成建议或撰写客户更新邮件。

LocalRank 配置指南

确保您已从 https://app.localrank.so/settings/api 获取 API 密钥。此 Openclaw Skills 工具需要 Node.js 18+。

安装

# 运行交互式设置
./scripts/localrank.js setup

# 或设置环境变量
export LOCALRANK_API_KEY=lr_your_key

配置优先级

1. LOCALRANK_API_KEY 环境变量
2. ./.localrank/config.json (项目局部)
3. ~/.config/localrank/config.json (用户全局)

LocalRank 数据架构与分类体系

该技能围绕业务、扫描和审计报告组织数据。关键指标包括：

排名解读为：1-3（本地包）、4-10（第 1 页）和 11-20（快速获胜）。数据以结构化 JSON 形式返回，便于其他 Openclaw Skills 工作流解析。

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

   • Get your key at https://app.localrank.so/settings/api
   • Run: /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:

   /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 

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 

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