Keitaro TDS API MCP Plugin

Keitaro TDS API MCP插件

描述

MCP服务器，用于与Keitaro TDS API集成，提供与活动、流、优惠和其他Keitaro实体合作的工具。

安装

在Cursor中安装插件

1. 克隆存储库

git clone 
cd mcp-keitaro-tds

1. 安装依赖项

npm install

1. 全局安装软件包

npm install -g .

1. 在Cursor中安装插件

node install-cursor-plugin.js

1. 重新启动游标

替代方案：在Cursor中手动配置

您还可以手动将Keitaro MCP服务器添加到您的Cursor配置中：

1. 打开光标MCP配置文件：

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

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

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

1. 将以下条目添加到“mcpServers”对象中：

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

1. 保存文件并重新启动Cursor

API密钥配置

创建一个 .env 项目根目录中的文件，具有以下参数：

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

游标中的用法

1. 启动光标
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