SurfRank MCPサーバー

AIエージェントに、SurfRankでのAI可視性レポートの実行、キーワード調査、競合他社の追跡をチャットウィンドウから直接行わせることができます。

このパッケージは、SurfRankのパブリックAPIをModel Context Protocol (MCP) ツールとして公開します。これにより、Claude Desktop、Claude Code、Cursor、Windsurf、ChatGPT MCPコネクタなど、MCP互換のあらゆるAIアシスタントが、あなたに代わってSurfRankを呼び出せるようになります。

SurfRankとは？

SurfRankは、AIの回答（ChatGPT、Perplexity、Gemini、Claude、Grok、DeepSeek、Meta AI）の中で、あなたのブランドがどれだけ可視化されているかを測定します。追跡対象のキーワードを各エンジンで実行し、競合他社と比較してあなたの言及をスコアリングし、成果につながるコンテンツの機会を明らかにします。

Related MCP server: DataForSEO MCP Server

MCPとは？

Model Context Protocolは、AIエージェントが外部ツールを発見して呼び出せるようにするためのAnthropicによるオープン標準です。このサーバーを一度インストールすれば、プラグインAPIやOAuthの複雑な手順、グルーコードなしで、エージェントに24種類の新しい能力を与えることができます。

接続後にエージェントに依頼できること

💬 「SaaS業界のsurfrank.ai用のSurfRankプロジェクトを作成し、これら10個のキーワードを追跡して…」

💬 「最新のAI可視性レポートは何を示していますか？どのエンジンで私のブランドが不足していますか？」

💬 「competitor.comのクイックテストを実行し、私のスコアと比較して。」

💬 「上位5つのコンテンツの機会をリストアップし、最もインパクトのあるものの記事をドラフトして。」

エージェントは適切なツールを選択し、あなたのキーを使用してSurfRank APIを呼び出し、自然言語で返答します。クレジットは、直接APIを呼び出す場合と同じレートで、あなたのSurfRankアカウントから消費されます。

要件

• Node.js 18以降 (MCP SDKで必須)。

• 従量課金プラン (Pay As You Go) の SurfRank APIキー。app.surfrank.ai/api-managementで生成してください。

• MCP互換クライアント（「設定」セクションを参照）。

インストール

npxを使用してアドホックに実行します（インストール不要）：

npx -y @surfrank/mcp-server

またはグローバルにインストールします：

npm install -g @surfrank/mcp-server

設定

以下のクライアントから選択し、スニペットをMCP設定ファイルに貼り付けてください。

Claude Desktop

Claude Desktopの設定ファイルを編集します：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Desktopを再起動します。MCPサーバーメニューに surfrank が表示されるはずです。

Cursor

~/.cursor/mcp.json を編集します（または「設定」→「MCP」→「サーバーを追加」を使用）：

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add surfrank -- npx -y @surfrank/mcp-server
export SURFRANK_API_KEY=sr_your_key_here

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します：

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": { "SURFRANK_API_KEY": "sr_your_key_here" }
    }
  }
}

利用可能なツール

このサーバーは、すべてのSurfRankパブリックAPIエンドポイントをツールとして公開します（合計24個）。エージェントはそれらを自動的に発見するため、プロンプトにリストアップする必要はありません。

各ツールは、https://api.surfrank.ai/api/v1/public/* 配下のRESTエンドポイントと1対1で対応しています。

スコープ付きAPIキー

プロジェクトスコープのAPIキーを生成した場合、MCPサーバーはそのプロジェクトに対してのみ操作可能です。異なるプロジェクトIDを参照するツール呼び出しは、SurfRank APIから 403 エラーが返され、そのエラーがそのままエージェントの回答に表示されます。

これは、単一のワークスペースやチームメンバーを単一のブランドに接続する場合に推奨される設定です。

クレジットの消費

クレジットは、直接APIを呼び出す場合と同じ価格設定でSurfRankアカウントから差し引かれます：

すべてのツール応答には credits オブジェクトが含まれているため、エージェント（およびあなた）はリアルタイムで消費状況を追跡できます。

環境変数

デバッグ

公式のMCPインスペクターを使用してサーバーを直接操作できます。新しいクライアントのオンボーディングや接続の問題を診断する際に便利です：

SURFRANK_API_KEY=sr_your_key_here \
  npx @modelcontextprotocol/inspector npx @surfrank/mcp-server

インスペクターはブラウザUIを開き、AIエージェントが実行するのと全く同じように、ツールをリストアップして手動で呼び出すことができます。

セキュリティに関する注意

• APIキーは作成時に一度だけ表示され、SurfRankのサーバーにはSHA-256ハッシュとして保存されます。キーを紛失した場合は、取り消して再生成してください（復元はできません）。

• 認証情報はローカルのMCP設定ファイル内に留まります。このパッケージがそれらをディスクに書き込んだり、外部に送信したりすることはありません。

• 各APIキーは 1分間に60リクエスト のレート制限があります。これを超えるとHTTP 429 が返されます。

リンク

• 🌐 SurfRank — surfrank.ai

• 🔑 API管理 — app.surfrank.ai/api-management

• 📘 パブリックAPIドキュメント — API管理 → ドキュメントタブ内

• 🐛 問題報告 — github.com/SurfRankAI/mcp-server/issues

• 📦 npm — @surfrank/mcp-server

ライセンス

MIT © SurfRank Pte. Ltd. — LICENSE を参照してください。