Keitaro 管理平台

@GodzillaDancer/keitaro-mcp

0 Stars 311 次浏览 GodzillaDancer 更新于 2026-08-23

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

交流协作工具

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

Keitaro TDS API MCP 插件

说明

MCP 服务器用于与 Keitaro TDS API 集成，提供处理广告系列、流量流、报价和其他 Keitaro 实体的工具。

安装

在 Cursor 中安装插件

克隆仓库

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

安装依赖项

npm install

全局安装包

npm install -g .

在 Cursor 中安装插件

node install-cursor-plugin.js

重启 Cursor

替代方案：在 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

在 Cursor 中使用

启动 Cursor
打开命令面板（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
  }
})

开发

以开发模式运行

npm run dev

测试 MCP 服务器

npm run inspect

查看源码项目主页