Keitaro TDS API MCP プラグイン
説明
Keitaro TDS API と統合するための MCP サーバー。キャンペーン、ストリーム、オファー、およびその他の Keitaro エンティティを操作するためのツールを提供します。
インストール
カーソルにプラグインをインストールする
- リポジトリをクローンする
git clone <repository-url>
cd mcp-keitaro-tds
- 依存関係をインストールする
- パッケージをグローバルにインストールする
- カーソルにプラグインをインストールする
node install-cursor-plugin.js
- カーソルを再開
代替案: カーソルでの手動設定
また、Keitaro MCP サーバーを Cursor 構成に手動で追加することもできます。
- カーソル MCP 構成ファイルを開きます。
# On macOS
open ~/.cursor/mcp.json
# On Windows
notepad %USERPROFILE%\.cursor\mcp.json
# On Linux
nano ~/.cursor/mcp.json
- 「mcpServers」オブジェクトに次のエントリを追加します。
"Keitaro": {
"command": "mcp-keitaro-tds",
"args": []
}
- ファイルを保存してカーソルを再起動します
APIキーの設定
次のパラメータを使用して、プロジェクト ルートに.env
ファイルを作成します。
KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1
KEITARO_API_KEY=your-api-key
カーソルでの使用
- カーソルを起動
- コマンドパレットを開きます(macOSの場合はCmd+P、Windows/Linuxの場合はCtrl+P)
- 「Keitaro」を見つけて選択してください
- 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
}
})
発達
開発モードで実行中
MCPサーバーのテスト