关于 mcp-redtrack
mcp-redtrack 是用于查询 RedTrack 联盟跟踪数据的只读 MCP 服务，为兼容 MCP 的客户端提供广告系列、活动日志、报告和账户实体工具。
主要功能
- 01读取广告系列列表与详情
- 02查询点击和转化日志
- 03分组并排序绩效报告
- 04浏览优惠与跟踪实体
- 05查看设置和参考数据
适用场景
- 01检查广告系列配置与状态
- 02分析点击和转化归因
- 03比较不同国家或日期的绩效
MCP 相关
向 MCP 客户端提供 18 个只读工具，用于查询 RedTrack API；不会修改账户。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
工具
13收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | string | 否 | |
| per | number | 否 | |
| page | number | 否 | |
| tags | string | 否 | |
| title | string | 否 | |
| status | string | 否 | |
| date_to | string | 否 | |
| sources | string | 否 | |
| timezone | string | 否 | |
| date_from | string | 否 | |
| total_stat | boolean | 否 |
详细介绍
mcp-redtrack
适用于 RedTrack 联盟跟踪 API 的 MCP 服务。可通过任何兼容 MCP 的客户端（Claude Code、Claude Desktop、Cursor 等）查询广告系列、点击、转化和报告。
快速开始
npx mcp-redtrack setup YOUR_API_KEY
此命令会打印 MCP 客户端的配置片段。
Claude Code
claude mcp add redtrack -e REDTRACK_API_KEY=YOUR_API_KEY -- npx mcp-redtrack
Claude Desktop / Cursor
将以下内容添加到 MCP 设置 JSON 中：
{
"mcpServers": {
"redtrack": {
"command": "npx",
"args": ["mcp-redtrack"],
"env": {
"REDTRACK_API_KEY": "YOUR_API_KEY"
}
}
}
}
工具（18 个）
所有工具均为只读（标注了 readOnlyHint）；该服务不会修改你的 RedTrack 账户。
广告系列
| 工具 | 描述 |
|---|---|
get_campaigns | 列出广告系列，可按标题、状态、来源、标签和日期范围筛选 |
get_campaign | 按 ID 获取单个广告系列的完整配置 |
get_campaigns_v2 | 通过 v2 端点列出广告系列 |
日志
| 工具 | 描述 |
|---|---|
get_clicks | 点击级别日志，包含 IP、国家/地区、设备和广告系列详情（每页最多 10k 条） |
get_conversions | 转化日志，包含支出、成本、收入和归因信息（每页最多 10k 条） |
报告
| 工具 | 描述 |
|---|---|
get_report | 按一个或多个维度（广告系列、优惠、国家/地区、日期、sub1-20 等）分组的汇总统计数据，并支持排序 |
实体
| 工具 | 描述 |
|---|---|
get_offers | 列出优惠，可按标题、联盟网络、国家/地区、状态和标签筛选 |
get_offer | 按 ID 获取单个优惠 |
get_sources | 列出流量来源 |
get_source | 按 ID 获取单个来源 |
get_networks | 列出联盟网络 |
get_network | 按 ID 获取单个联盟网络 |
get_landings | 列出落地页和预落地页 |
get_landing | 按 ID 获取单个落地页 |
get_streams | 列出流 |
get_domains | 列出跟踪域名 |
get_dictionary | 参考列表：国家/地区、货币、时区、浏览器、操作系统、设备、ISP 等 |
get_settings | 账户设置（时区、货币、转化类型） |
环境变量
| 变量 | 必需 | 默认值 | 描述 |
|---|---|---|---|
REDTRACK_API_KEY | 是 | — | 你的 RedTrack API 密钥 |
REDTRACK_ENV_FILE | 否 | .env | .env 文件路径 |
开发
bun install # install deps
bun run dev # run MCP server
bun test # run tests
bun run lint # check formatting & lint
bun run inspect # open MCP inspector
bun run build # compile standalone binary
bun run build:npm # bundle for Node.js / npm
许可证
MIT
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。