mcp-redtrack

mcp-redtrack

RedTrackのアフィリエイトトラッキング API 用 MCP サーバーです。MCP 対応クライアント（Claude Code、Claude Desktop、Cursor など）から、キャンペーン、クリック、コンバージョン、レポートを照会できます。

クイックスタート

npx mcp-redtrack setup YOUR_API_KEY

MCP クライアント用の設定スニペットが出力されます。

Claude Code

claude mcp add redtrack -e REDTRACK_API_KEY=YOUR_API_KEY -- npx mcp-redtrack

Claude Desktop / Cursor

MCP 設定 JSON に追加します。

{
  "mcpServers": {
    "redtrack": {
      "command": "npx",
      "args": ["mcp-redtrack"],
      "env": {
        "REDTRACK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

ツール（18）

すべてのツールは読み取り専用（readOnlyHint で注釈）です。このサーバーが RedTrack アカウントを変更することはありません。

キャンペーン

ツール	説明
get_campaigns	タイトル、ステータス、ソース、タグ、日付範囲で絞り込んでキャンペーンを一覧表示します
get_campaign	ID を指定して、完全な設定を含む単一のキャンペーンを取得します
get_campaigns_v2	v2 エンドポイント経由でキャンペーンを一覧表示します

ログ

ツール	説明
get_clicks	IP、国、デバイス、キャンペーン詳細を含むクリック単位のログ（1 ページ最大 10k 件）
get_conversions	報酬、コスト、収益、アトリビューションを含むコンバージョンログ（1 ページ最大 10k 件）

レポート

ツール	説明
get_report	1 つ以上のディメンション（キャンペーン、オファー、国、日付、sub1-20 など）でグループ化した集計統計を、並べ替え付きで取得します

エンティティ

ツール	説明
get_offers	タイトル、ネットワーク、国、ステータス、タグで絞り込んでオファーを一覧表示します
get_offer	ID を指定して単一のオファーを取得します
get_sources	トラフィックソースを一覧表示します
get_source	ID を指定して単一のソースを取得します
get_networks	アフィリエイトネットワークを一覧表示します
get_network	ID を指定して単一のアフィリエイトネットワークを取得します
get_landings	ランディングページとプレランディングページを一覧表示します
get_landing	ID を指定して単一のランディングページを取得します
get_streams	ストリームを一覧表示します
get_domains	トラッキングドメインを一覧表示します
get_dictionary	国、通貨、タイムゾーン、ブラウザー、OS、デバイス、ISP などの参照リスト
get_settings	アカウント設定（タイムゾーン、通貨、コンバージョンタイプ）

環境変数

変数	必須	デフォルト	説明
REDTRACK_API_KEY	はい	—	RedTrack API キー
REDTRACK_ENV_FILE	いいえ	.env	.env ファイルへのパス

開発

bun install          # install deps
bun run dev          # run MCP server
bun test             # run tests
bun run lint         # check formatting & lint
bun run inspect      # open MCP inspector
bun run build        # compile standalone binary
bun run build:npm    # bundle for Node.js / npm

ライセンス

MIT