rankgoat

RankGoat CLI

RankGoat 官方命令行界面。RankGoat 是一个 SEO 反向链接交换平台，会为会员网站撰写并发布代写博客文章，并在网站之间建立真实的 dofollow 链接。

直接在终端或 CI 流水线中管理内容计划、生成文章、批准草稿，以及查看反向链接和 SEO 数据。基于公开的 RankGoat API 构建。

安装

npm install -g rankgoat

也可以直接运行，无需安装：

npx rankgoat whoami

需要 Node.js 20 或更高版本。运行时零依赖。

身份验证

在 rankgoat.app/app/settings#api 创建 API 密钥，然后：

rankgoat auth login rg_live_xxxxxxxx

密钥会保存在 ~/.rankgoat/config.json 中（仅文件所有者可读）。也可以在环境中设置 RANKGOAT_API_KEY，或在任意命令中传入 --api-key，这在 CI 中很方便。

export RANKGOAT_API_KEY=rg_live_xxxxxxxx
rankgoat whoami

用法

rankgoat <command> [args] [options]

账户和网站

rankgoat whoami                     # member + sites with credit balances
rankgoat sites                      # list your sites
rankgoat sites get 123              # one site, full detail
rankgoat sites credits 123          # credit balance by bucket

内容计划

月度计划是一份简报日历，AI 会根据简报撰写文章。

rankgoat plan list 123 --month 2026-06
rankgoat plan add 123 --auto                       # let AI plan a brief (async)
rankgoat plan add 123 --title "Notion vs Obsidian" --keyword "notion alternatives" --type comparison --hub 5
rankgoat plan edit 789 --title "Notion vs Obsidian (2026)" --type guide
rankgoat plan schedule 789 2026-06-22
rankgoat plan archive 789
rankgoat plan restore 789
rankgoat plan generate 789 --wait                  # write the post now (spends 1 credit)

文章

rankgoat posts list 123 --status draft
rankgoat posts get 456 --html                      # print the post body
rankgoat posts approve 456                          # approve a draft for publishing

反向链接和 SEO

rankgoat backlinks 123                              # inbound + outbound link graph
rankgoat mentions 123                               # brand mentions received + given
rankgoat seo authority 123                          # Domain Rating over time
rankgoat seo onpage 123
rankgoat seo sitemap 123
rankgoat seo gsc 123                                # Google Search Console performance
rankgoat seo equity 123                             # link-equity points: balances + ledger
rankgoat seo flywheel 123                           # unindexed-post fixes awaiting review

内容中心

月度规划器会从主题集群中提取简报，并按优先级加权。

rankgoat hubs list 123
rankgoat hubs add 123 --name "AI note-taking" --keywords "ai notes, ai note app" --priority high
rankgoat hubs edit 5 --priority low
rankgoat hubs archive 5                             # the planner stops drawing from it
rankgoat hubs restore 5

产品功能

产品的真实功能。这些功能为内容生成提供依据，确保文章不会虚构产品并不具备的功能。

rankgoat features list 123
rankgoat features add 123 --name "Offline sync" --description "Notes sync without a connection"
rankgoat features edit 7 --description "Now with conflict resolution"
rankgoat features archive 7                         # new posts stop mentioning it
rankgoat features restore 7

任务

某些操作（AI 规划、文章生成）会在后台运行并返回任务句柄。可以轮询任务状态，也可以在原始命令中传入 --wait：

rankgoat jobs plan-generate 789 --wait

选项

选项	说明
--api-key <key>	使用此密钥（覆盖环境变量和已保存的配置）
--api-url <url>	覆盖 API 基础 URL（默认为 https://rankgoat.app/api/v1）
--json	输出原始 JSON，非常适合使用 jq 编写脚本
--wait	阻塞，直到异步任务完成
-h, --help	显示帮助
-v, --version	显示 CLI 版本

编写脚本

每条命令都支持 --json，可输出机器可读的数据：

rankgoat sites --json | jq '.sites[] | select(.status=="active") | .domain'

发生任何 API 或用法错误时，退出码都非零，因此可以在 CI 中轻松组合使用。

面向 AI Agent

此 CLI 专为 Agent 驱动而构建：每条命令均提供结构化 JSON、支持通过环境变量进行身份验证，并在失败时返回非零退出码。可通过两种方式接入：

MCP 服务。 rankgoat mcp 会通过标准输入/输出运行 Model Context Protocol 服务，将全部 34 项功能（规划、生成、批准、反向链接、提及、DR、GSC、站点地图、内容中心、功能、链接权重、飞轮）作为类型化工具提供：

claude mcp add rankgoat -e RANKGOAT_API_KEY=rg_live_... -- npx -y rankgoat mcp

也可以在任意 MCP 客户端配置中使用：

{
  "mcpServers": {
    "rankgoat": {
      "command": "npx",
      "args": ["-y", "rankgoat", "mcp"],
      "env": { "RANKGOAT_API_KEY": "rg_live_..." }
    }
  }
}

Shell + SKILL.md。 能运行 shell 命令的 Agent 可以直接使用 CLI；随附的 SKILL.md 会介绍相关工作流，包括哪些调用会消耗点数，以及应在哪些环节保留人工参与。

更多信息请访问 rankgoat.app/agent。

RankGoat 的运作方式

RankGoat 会员付费获取代写博客文章，这些文章会发布在他们自己的网站上，并包含指向其他会员的 dofollow 出站链接。链接图谱不会互惠，且会按细分领域和 DR 进行匹配，因此能够建立真实的权威度，而不会被模式匹配识别为作弊方案。请访问 rankgoat.app 了解详情，或阅读 API 参考文档。

许可证

MIT © RedStudio