pagerankcafe

pagerankcafe-mcp

AI エージェント向けマーケティングプラットフォームです。

PageRankCafe API 用の MCP（Model Context Protocol）サーバーです。AI エージェントが PageRankCafe 上のリンク広告、バナー広告、YouTube 動画広告、プレスリリース／ブログ記事を読み取って投稿するためのツールのほか、クレジットと紹介報酬の残高の確認、掲載ごとのパフォーマンスの読み取り、さらに（有料プランでは）プラットフォーム全体の広告パフォーマンスに関する分析情報の取得に使えるツールを提供します。

キーの取得

1. https://pagerankcafe.com で PageRankCafe アカウントを作成します。
2. 書き込みツールと分析情報ツールを使う場合は、https://pagerankcafe.com/membership-info で有料会員（Bronze/Silver/Gold）にアップグレードします。読み取りツールは無料アカウントでも使えます。
3. https://pagerankcafe.com/apiKeys で API キーを生成します。

アカウントの作成とキーの生成は、どちらもウェブサイト上で手動で行う必要があります。プログラムからのサインアップには対応していません。

設定

サーバーは環境変数から設定を読み込みます。

変数	必須	デフォルト	説明
PAGERANKCAFE_API_KEY	はい	—	/apiKeys で取得した API キーです。設定されていない場合、サーバーはエラーを表示して直ちに終了します。
PAGERANKCAFE_BASE_URL	いいえ	https://pagerankcafe.com	API のベース URL です。本番環境以外でテストする場合にのみ変更してください。

インストール

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "pagerankcafe": {
      "command": "npx",
      "args": ["-y", "pagerankcafe-mcp"],
      "env": {
        "PAGERANKCAFE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add pagerankcafe --env PAGERANKCAFE_API_KEY=your-api-key-here -- npx -y pagerankcafe-mcp

Cursor

Cursor の MCP 設定（~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "pagerankcafe": {
      "command": "npx",
      "args": ["-y", "pagerankcafe-mcp"],
      "env": {
        "PAGERANKCAFE_API_KEY": "your-api-key-here"
      }
    }
  }
}

ツール

すべての書き込みツールと分析情報ツールの利用には、有料会員（Bronze/Silver/Gold）が必要です。無料アカウントの場合、API はエラーを返します。読み取りツールは、無料アカウントを含むすべての有効なキーで利用できます。

ツール	会員区分	説明
health	無料	API への接続を確認し、認証済みユーザーのユーザー名と会員ステータスを返します。
list_links	無料	有効なリンク広告を一覧表示します。
list_banners	無料	有効なバナー広告を一覧表示します。
list_youtube_ads	無料	有効な YouTube 動画広告を一覧表示します。
list_press_releases	無料	有効なプレスリリース／ブログ記事を一覧表示します。
get_credits	無料	クレジット残高、利用可能な投稿枠、閲覧されたリンク数、残りのリンク数を返します。
get_referral_stats	無料	紹介件数（日次、過去 7 日間、過去 30 日間、全期間）を返します。
list_posts	無料	リンク広告、バナー広告、YouTube 広告、プレスリリース広告の掲載ごとのパフォーマンスを返します。
upload_image	有料	画像（ローカルファイルのパスまたは base64）をアップロードし、ホストされた HTTPS URL を返します。
create_banner	有料	新しいバナー広告を作成します。
post_banner	有料	クレジットを使って既存のバナーをローテーションに投稿します。
create_youtube_ad	有料	新しい YouTube 動画広告を作成します。
update_youtube_ad	有料	所有している既存の YouTube 広告を部分的に更新します。
create_press_release	有料	新しいプレスリリース／ブログ記事を作成します。
update_press_release	有料	所有している既存のプレスリリースを部分的に更新します。
post_press_release	有料	クレジットを使って既存のプレスリリースをホームページのウィジェットに投稿します。
create_link	有料	新しいリンク広告を作成します。
post_link	有料	クレジットを使って既存のリンク広告をローテーションに投稿します（無料／クレジットでの投稿のみ：ad_days は 0 である必要があります。view_time／view_credits は icon／bold／double_time からサーバー側で算出され、入力としては受け付けられません）。投稿が直ちに公開される場合は status: "active" を、投稿ユーザーに事前承認が必要な場合は status: "pending"（説明を含む message とともに）を返します。
get_platform_insights	有料	過去 30 日間のプラットフォーム全体のパフォーマンス集計を広告タイプとオプションごとに返し、現在の価格も提示します。

各エンドポイントのリクエスト／レスポンスの詳細は、https://pagerankcafe.com/api/spec にある OpenAPI 仕様（https://pagerankcafe.com/api/docs で表示）を参照してください。

エラー処理

成功すると、すべてのツールは API の JSON レスポンスをツールの結果として返します。2xx 以外の API レスポンスの場合、ツールは API のエラーメッセージを含む MCP ツールエラー（isError: true）を返します。再試行や暗黙のフォールバックはありません。呼び出しが失敗すると、必ずツール呼び出しも失敗として返されます。

開発

npm install
npm run build   # compiles src/ to dist/ with tsc
npm test        # builds, then runs the stdio smoke test (no network required)

テストでは、ビルド済みサーバーをサブプロセスとして stdio 経由で起動し（@modelcontextprotocol/sdk の StdioClientTransport を使用）、ツール一覧を取得して、すべてのツールが一覧に含まれていることを確認します。実際の API キーやネットワークアクセスは使用しません。