rankgoat

RankGoat CLI

RankGoat の公式コマンドラインインターフェイスです。RankGoat は、メンバーサイト間で実際の dofollow リンクを含むブログ記事を代行作成・公開する SEO バックリンク交換サービスです。

コンテンツプランの管理、記事の生成、下書きの承認、バックリンクや SEO データの確認を、ターミナルや CI パイプラインから直接行えます。公開されている 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 エージェント向け

この CLI はエージェントによる操作を想定して構築されています。すべてのコマンドで構造化 JSON を出力し、環境変数による認証に対応し、失敗時にはゼロ以外の終了コードを返します。連携方法は次の 2 つです。

MCP サーバー。 rankgoat mcp を実行すると、stdio 上で Model Context Protocol サーバーが起動します。プラン作成、生成、承認、バックリンク、メンション、DR、GSC、サイトマップ、ハブ、機能、リンクエクイティ、フライホイールなど、34 の機能すべてを型付きツールとして公開します。

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_..." }
    }
  }
}

シェルと SKILL.md。 シェルコマンドを実行するエージェントは、CLI を直接使用できます。同梱の SKILL.md では、クレジットを消費する呼び出しや、人間が確認すべき箇所も含め、ワークフローについて説明しています。

詳しくは rankgoat.app/agent をご覧ください。

RankGoat の仕組み

RankGoat のメンバーは、自分のサイトに公開されるブログ記事の作成を依頼できます。記事には、ほかのメンバーへの dofollow の外部リンクが含まれます。リンクグラフは相互リンクではなく、ニッチと DR が一致するよう調整されているため、仕組みとしてパターン認識されることなく、実際のオーソリティを築けます。詳しくは rankgoat.app をご覧いただくか、API リファレンス をお読みください。

ライセンス

MIT © RedStudio