Toprank

在数字营销中，我们往往淹没在数据仪表盘里，却难以获得明确的行动指令。Toprank 是来自 AdsAgent 的官方 Google Ads + SEO 插件，它不再仅仅展示数据，而是赋予 AI 代理直接访问 Google Search Console (GSC) 和 Google Ads 的权限。

Toprank 能分析你的流量，揭示损害排名的因素，发现浪费的广告支出，并准确告诉你需要修复什么。更强大的是，当你授予仓库访问权限时，它能进一步重写元标签、修复标题、添加结构化数据并提交更改。

这是一次从“看数据”到“做决策”再到“执行操作”的根本性转变。

为什么选择 Toprank？

Toprank 是 AdsAgent 的 CLI 端——一个在 Claude Code 内部运行的技能集合。其配套的 Web 应用 adsagent.org 提供免费的 API 密钥注册和浏览器 UI 审计。CLI 和 Web 端共享同一引擎，确保了一致的体验。

它旨在回答营销人员最核心的三个问题：

• “我现在在广告上浪费钱了吗？”
• “为什么我的流量下降了，我该如何修复？”
• “我怎样才能在不增加支出的情况下获得更多转化？”

免费、开源、30 秒安装。

实战演示：AI 如何优化你的账户

场景一：Google Ads 审计与自动执行

你： /toprank:ads-audit

Claude： 已连接到你的 Google Ads 账户（MyStore）。

账户概览：

• 3 个广告系列处于活动状态。
• 本月花费：$2,400。

健康评分卡：

┌──────────────────────┬──────────┬──────────────────────────────┐
│ 维度                 │ 状态     │ 摘要                         │
├──────────────────────┼──────────┼──────────────────────────────┤
│ 转化跟踪             │ ✅ 正常   │ 3 个操作正确触发             │
│ 关键词健康度         │ ❌ 严重   │ 8 个关键词在烧钱             │
│ 搜索词质量           │ ⚠️ 警告   │ 12 个不相关查询               │
│ 展示次数份额         │ ⚠️ 警告   │ 35% 因排名丢失               │
│ 支出效率             │ ❌ 严重   │ 每月浪费 $340                │
└──────────────────────┴──────────┴──────────────────────────────┘

建议的前 3 项操作：

1. 暂停 3 个关键词（每月 $210，零转化）
2. 添加 12 个否定关键词（每月 $130 浪费在不相关词上）
3. 将 2 个高转化关键词的出价提高 15%（正在失去展示份额）

业务场景已保存 — 后续可使用 /toprank:ads-copy 和 /toprank:ads 基于此上下文操作。

你： 全部执行。

Claude：

[✅ 已暂停 3 个浪费的关键词 — 每月节省 $210]
[✅ 已添加 12 个否定关键词 — 每月节省 $130]
[✅ 已提高 2 个高表现者的出价]

完成。 所有更改在 7 天内可逆。

每周自动回顾

你可以将其设置为重复任务，让 AI 在每周一早上汇报上周效果：

你： /toprank:ads — "review last week's changes"

Claude： 过去 7 天内有 12 项更改。其中 9 项已足够成熟以进行判断。

📈 成功（4 项）：

• 暂停“cheap seo services” → 点击率 +18%，转化 +2
• 添加“free”为否定词 → 每周浪费支出 -$84
• 将“b2b crm software”出价提高 15% → 转化 +3，每次转化成本持平
• “MyStore Brand”广告组上的新 RSA → 点击率 +24%

📉 失败（2 项）：

• 将“enterprise saas”出价提高 20% → 成本 +$210，转化持平
• 暂停“project management tool” → 每周损失 4 次转化

⏳ 太新无法判断（3 项） — 建议 5 天后复查。

注意：2 项更改在同一广告系列上在 7 天内有其他编辑，因此其方向为低置信度。

场景二：SEO 深度分析与行动计划

你： /toprank:seo-analysis

Claude： 在 mystore.com 找到你的网站 — 正在拉取 Search Console 数据。

[已加载 90 天的真实流量数据]
[已抓取页面以发现技术问题]

最影响你排名的三个问题：

1. 重复内容权重分散： 你的首页存在于两个地址。谷歌在你的两个地址之间分配排名权重。容易修复。
2. 内部竞争： 两个页面针对相同的搜索词 — 它们相互竞争，谁也无法获胜。
3. 标题不匹配意图： 一个页面每月获得 400 次展示但排名第 52。标题与实际搜索内容不匹配。

这是为你生成的 30 天行动计划，按影响力排序…

核心技能清单

Toprank 的所有技能均通过 /toprank:* 命令调用，涵盖 Google Ads、SEO 及跨模型验证。

Google Ads 技能

SEO 技能

跨模型验证

技术架构：灵活、开放、可扩展

1. MCP 服务器支持

Google Ads 接口也可作为独立的远程 MCP (Model Context Protocol) 服务器使用，无需安装 Toprank CLI 插件即可从任何 MCP 客户端调用。

• 注册表名称： io.github.nowork-studio/notfair
• 端点： https://notfair.co/api/mcp (Streamable HTTP)
• 认证： OAuth 2.1 配合动态客户端注册。首次使用时在浏览器登录 notfair.co，令牌存储在本地（如操作系统密钥链），安全便捷。

该服务器暴露了约 100 个 Google Ads 工具，涵盖读取（效果数据、搜索词、GAQL 查询等）和写入（暂停/启用、出价更新、关键词管理等），并支持并行发起最多 20 个 GAQL 查询以回答开放式分析问题。

2. 连接器抽象层

Toprank 技能使用 ~~category 占位符模式引用外部工具，实现了技能与工具的解耦。

如果某个连接器不可用，技能会优雅降级。例如，没有 GSC 数据时，seo-analysis 仍可通过技术抓取运行基础审计。

快速安装

Toprank 是一个 Claude Code 插件，支持一次性设置和自动更新。

方法一：Claude Code 命令行（推荐）

在 Claude Code 中运行以下两条命令：

/plugin marketplace add nowork-studio/toprank
/plugin install toprank@nowork-studio

安装完成后，所有技能即可通过 /toprank:* 命令使用。

Google Ads 授权： 当 Claude Code 首次连接到 NotFair MCP 服务器时，它会打开浏览器标签页要求你登录 notfair.co。授权一次后，令牌将安全存储在你的操作系统密钥链中，无需手动复制 API 密钥。

方法二：手动配置

如果你偏好直接编辑配置文件，可在 ~/.claude/settings.json 中添加：

{
  "extraKnownMarketplaces": {
    "nowork-studio": {
      "source": {
        "source": "github",
        "repo": "nowork-studio/toprank"
      }
    }
  },
  "enabledPlugins": {
    "toprank@nowork-studio": true
  }
}