Digital Marketer MCP

MCP服务器：Yandex。直接监视器

描述

MCP（模型上下文协议）用于分析和监视Yandex广告活动的服务器。直接。该服务器提供了一组工具，用于获取分析，评估效率，并生成优化广告活动的建议。

用途

服务器充当AI代理和Yandex数据之间的中间层。Direct通过提供结构化工具：

• 收集和分析活动有效性指标
• 业务目标符合性评估（CPA，预算）
• 生成优化建议
• 广告脚本规划

建筑

工艺堆栈

• 框架：FastMCP（模型上下文协议）
• 运输：流式HTTP（无状态）
• 语言：Python 3.13+
• 数据格式：JSON-RPC 2.0
• 认证：Yandex的Bearer Token。直接API

项目结构

digital-marketer-mcp/  
├── server.py                   # Главный файл запуска сервера  
├── mcp_instance.py             # Единый экземпляр FastMCP  
├── requirements.txt            # Зависимости Python  
├── .env.example                # Пример переменных окружения  
└── tools/                      # Каталог инструментов MCP  
    ├── __init__.py             # Инициализация модуля инструментов  
    ├── campaign_performance.py # Получение данных по кампании  
    ├── campaign_health.py      # Анализ здоровья кампании  
    ├── daily_report.py         # Генерация сводных отчетов  
    ├── scenarios.py            # Расчет сценариев бюджета  
    ├── cpa_calculator.py       # Калькулятор CPA  
    └── connection_test.py      # Проверка подключения  

可用工具

1. get_campaign_performance

接收并分析广告活动有效性报告。

参数：

• campaign_id （STR）：唯一的活动标识符
• days （int，optional）：以天为单位的分析周期（默认为7）

返回：

• 关键指标：成本、转换、点击、显示
• 估计值：CPA、CTR、CPC
• 数据趋势：improving/stable/worsening

使用示例：

# Получить данные за 7 дней
result = get_campaign_performance("123456789", days=7)

# Получить данные за 30 дней  
result = get_campaign_performance("123456789", days=30)

2. analyze_campaign_health

根据业务规则和目标分析活动健康状况。

参数：

• campaign_id （STR）：活动ID
• target_cpa （浮动）：目标转换成本（卢布）
• daily_budget_limit （浮动）：每日预算限额（卢布）

返回：

• 健康评估（0-100）
• Статус：健康/需求_关注/关键
• 查明的问题和建议
• 警告和要求采取的行动

业务规则：

• CPA关键：实际CPA>目标CPA×1.5
• CPA高：实际CPA>目标CPA×1.2
• 预算超支：每日平均支出>预算限额
• 无转换：点击>50，转换=0

3. generate_daily_report

生成多个活动的综合每日报告。

参数：

• campaign_ids （list\[str\]）：活动标识符列表

返回：

• Markdown格式的结构化报告
• 所有活动的统计摘要
• 管理者的优先事项
• 需要注意的关键问题

4. calculate_scenarios

计算实现目标转换的财务假设。

参数：

• campaign_id （STR）：活动ID
• target_conversions （int）：所需转换量

返回：

• 三个不同策略的场景
• 每种设想的估计预算
• 关于战略选择的建议

5. calculate_cpa

根据成本和转换计算客户参与成本（CPA）。

参数：

• cost （浮动）：总成本（卢布）
• conversions （int）：转换数

返回：

• 计算CPA值
• 成效评估
• 优化建议

6. test_connection

检查MCP服务器的运行状况和工具的可用性。

参数： 不

返回：

• 服务器状态和可用工具
• 配置信息

配置和启动

1. 建立依赖关系

pip install -r requirements.txt

1. 配置环境变量

基于.env.example创建.env文件：

# Обязательные для реального использования
YANDEX_API_TOKEN=your_yandex_direct_token
YANDEX_API_URL=https://api.direct.yandex.com/json/v501/reports

# Опциональные
HOST=0.0.0.0
PORT=8000
LOG_LEVEL=INFO

1. 启动服务器

python server.py

服务器将在以下地址可用：http://localhost:8000/mcp