> ## 🗄 Репозиторий заархивирован
>
> Разработка переехала в **[theYahia/WWmcp](https://github.com/theYahia/WWmcp)** — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро `@theyahia/mcp-core`, единый CI, единый релизный конвейер.
>
> Актуальная версия того, что лежало здесь: [`servers/roistat/`](https://github.com/theYahia/WWmcp/tree/main/servers/roistat)
>
> Пакет в npm прежний — [`@theyahia/roistat-mcp`](https://www.npmjs.com/package/@theyahia/roistat-mcp), ставится и работает как раньше.
> Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.
>
> **Archived — development moved to [theYahia/WWmcp](https://github.com/theYahia/WWmcp),** a monorepo of MCP servers for non-Western APIs.
> The current version of this package now lives at [`servers/roistat/`](https://github.com/theYahia/WWmcp/tree/main/servers/roistat).
> The npm package [`@theyahia/roistat-mcp`](https://www.npmjs.com/package/@theyahia/roistat-mcp) is unchanged.
> Please open issues and pull requests there.

# Roistat MCP — сквозная аналитика и стоимость лида в диалоге с нейросетью

Если вы искали, как спросить у ИИ, сколько стоит лид с каждого канала, свести расходы на рекламу с продажами или выгрузить лиды Roistat без ручных отчётов — это оно. 6 инструментов поверх API Roistat: лиды, рекламные каналы, затраты, аналитика и интеграции. Требуется API-ключ и ID проекта.

[![npm](https://img.shields.io/npm/v/@theyahia/roistat-mcp)](https://www.npmjs.com/package/@theyahia/roistat-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Установка

### Claude Desktop

```json
{
  "mcpServers": {
    "roistat": {
      "command": "npx",
      "args": ["-y", "@theyahia/roistat-mcp"],
      "env": {
        "ROISTAT_API_KEY": "ваш_ключ",
        "ROISTAT_PROJECT_ID": "ваш_id_проекта"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add roistat \
  -e ROISTAT_API_KEY=ваш_ключ \
  -e ROISTAT_PROJECT_ID=ваш_id_проекта \
  -- npx -y @theyahia/roistat-mcp
```

### Streamable HTTP

```bash
npx @theyahia/roistat-mcp --http --port 3000
# POST /mcp — MCP endpoint
# GET  /health — health check
```

### Smithery

Конфиг в `smithery.yaml`. Требуемые параметры: `ROISTAT_API_KEY`, `ROISTAT_PROJECT_ID`.

## Авторизация

| Переменная | Обязательна | Описание |
|------------|-------------|----------|
| `ROISTAT_API_KEY` | Да | API-ключ проекта Roistat |
| `ROISTAT_PROJECT_ID` | Да | ID проекта в Roistat |

Base URL: `https://cloud.roistat.com/api/v1/`

## Инструменты (6)

| Инструмент | Описание |
|------------|----------|
| `get_analytics` | Аналитика: визиты, заявки, выручка, ROI по источникам |
| `get_visits` | Список визитов с источниками и UTM-метками |
| `get_leads` | Лиды (заявки) с фильтрацией по статусам |
| `get_channels` | Эффективность рекламных каналов: ROI, CPL, выручка |
| `get_costs` | Затраты на рекламу с группировкой по периодам |
| `get_integrations` | Список подключённых интеграций (CRM, аналитика) |

## Скиллы (Prompts)

| Скилл | Описание |
|-------|----------|
| `skill-analytics` | Аналитика за период — сводка по ключевым метрикам с топ-3 источниками |
| `skill-channels` | Эффективность рекламных каналов — сравнение ROI, рекомендации по бюджету |

## Примеры запросов

```
Какой ROI у рекламных каналов за последний месяц?
Покажи визиты за сегодня
Сколько лидов пришло за неделю?
Какие интеграции подключены?
Сравни затраты по каналам за март
```

## Реферальная программа Roistat

| Тип | Комиссия |
|-----|----------|
| Юридические лица | 25% от оплат клиента |
| ИП | 50% от оплат клиента |

Подробнее: [roistat.com/referral](https://roistat.com/referral/)

## Разработка

```bash
npm install
npm test          # Vitest
npm run dev       # stdio (tsx)
npm run start:http  # HTTP-сервер
```

## Лицензия

MIT

---

Telegram: [@vhodvai](https://t.me/vhodvai)