Keitaro TDS API MCP 插件
描述
MCP 服务器与 Keitaro TDS API 集成,提供与活动、流、优惠和其他 Keitaro 实体协作的工具。
安装
在 Cursor 中安装插件
- 克隆存储库
git clone <repository-url>
cd mcp-keitaro-tds
- 安装依赖项
- 全局安装包
- 在 Cursor 中安装插件
node install-cursor-plugin.js
- 重启光标
替代方案:在 Cursor 中手动配置
您还可以手动将 Keitaro MCP 服务器添加到您的 Cursor 配置中:
- 打开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": []
}
- 保存文件并重新启动 Cursor
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
获取有关特定转换的信息
报告
域
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 服务器