Keitaro TDS API MCP Plugin

Keitaro TDS API MCP プラグイン

説明

Keitaro TDS API と連携する MCP サーバーです。キャンペーン、ストリーム、オファーなど、Keitaro のエンティティを操作するツールを提供します。

インストール

Cursor へのプラグインのインストール

1. リポジトリをクローンします

git clone <repository-url>
cd mcp-keitaro-tds

2. 依存関係をインストールします

npm install

3. パッケージをグローバルにインストールします

npm install -g .

4. Cursor にプラグインをインストールします

node install-cursor-plugin.js

5. Cursor を再起動します

代替方法：Cursor での手動設定

Keitaro MCP サーバーを Cursor の設定に手動で追加することもできます。

1. Cursor の MCP 設定ファイルを開きます。

# On macOS
open ~/.cursor/mcp.json

# On Windows
notepad %USERPROFILE%\.cursor\mcp.json

# On Linux
nano ~/.cursor/mcp.json

2. "mcpServers" オブジェクトに次の項目を追加します。

"Keitaro": {
  "command": "mcp-keitaro-tds",
  "args": []
}

3. ファイルを保存して、Cursor を再起動します

API キーの設定

プロジェクトのルートに、次のパラメーターを含む .env ファイルを作成します。

KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1
KEITARO_API_KEY=your-api-key

Cursor での使用方法

1. Cursor を起動します
2. コマンドパレットを開きます（macOS では Cmd+P、Windows/Linux では Ctrl+P）
3. "Keitaro" を検索して選択します
4. Cursor を通じて Keitaro API を使用できるようになります

使用可能なツール

キャンペーン

• list_campaigns - キャンペーンの一覧を取得します
• get_campaign - 特定のキャンペーンの情報を取得します
• create_campaign - 新しいキャンペーンを作成します
• update_campaign - 既存のキャンペーンを更新します
• delete_campaign - キャンペーンを削除します

トラフィックストリーム

• list_streams - キャンペーンのトラフィックストリーム一覧を取得します
• get_stream - 特定のストリームの情報を取得します

トラフィックソース

• list_traffic_sources - トラフィックソースの一覧を取得します
• get_traffic_source - 特定のトラフィックソースの情報を取得します

オファー

• list_offers - オファーの一覧を取得します
• get_offer - 特定のオファーの情報を取得します

クリックとコンバージョン

• list_clicks - クリックの一覧を取得します
• get_click - 特定のクリックの情報を取得します
• list_conversions - コンバージョンの一覧を取得します
• get_conversion - 特定のコンバージョンの情報を取得します

レポート

• get_report - 指定したパラメーターでレポートを生成します

ドメイン

• list_domains - ドメインの一覧を取得します
• get_domain - 特定のドメインの情報を取得します

使用例

キャンペーンの一覧を取得する

list_campaigns({
  limit: 10,
  page: 1,
  search: "search query"
})

新しいキャンペーンを作成する

create_campaign({
  name: "New Campaign",
  type: "position",
  cost_type: "CPC",
  cost_value: 1.5,
  group_id: 1,
  state: "active",
  traffic_source_id: 1
})

レポートを取得する

get_report({
  from: "2025-01-01",
  to: "2025-01-31",
  group: "campaign",
  filters: {
    campaign_id: 123
  }
})

開発

開発モードで実行する

npm run dev

MCP サーバーをテストする

npm run inspect