Roistat Mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.0.1更新于 Oct 27, 2026

MCP server for Roistat API — marketing analytics, visits tracking. API key auth.

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

面向 Roistat 营销分析 API 的 MCP 服务器，让助手获取线索、广告渠道 ROI、花费、访问和集成信息。

可以做什么
  • 获取按来源统计的访问、线索、收入和 ROI 分析
  • 列出带来源和 UTM 标记的访问记录
  • 按状态筛选获取线索
  • 比较广告渠道效果（ROI、CPL、收入）并按周期汇总广告花费
  • 列出已连接的 CRM 与分析集成
  • 使用内置提示词生成周期汇总或渠道对比
适用场景
适合需要向助手询问各渠道线索成本、把广告花费与销售数据核对，或无需手工做报表即可导出 Roistat 线索和渠道指标的场景。
运行要求
通过 npx 从 npm 包 @theyahia/roistat-mcp 本地运行（需要 Node.js）。需要 Roistat API 密钥（环境变量 ROISTAT_API_KEY）和项目 ID（ROISTAT_PROJECT_ID）。需要访问 Roistat 云 API 的网络。也可作为 Streamable HTTP 服务器在指定端口启动。
安装前请注意
需要 Roistat API 密钥（ROISTAT_API_KEY）和项目 ID，该密钥可访问你项目的营销数据。仓库已归档，开发已迁至另一个 monorepo，但说明 npm 包保持不变。README 中还包含与服务器功能无关的 Roistat 推荐计划内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Roistat Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

🗄 Репозиторий заархивирован

Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро @theyahia/mcp-core, единый CI, единый релизный конвейер.

Актуальная версия того, что лежало здесь: servers/roistat/

Пакет в npm прежний — @theyahia/roistat-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.

Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at servers/roistat/. The npm package @theyahia/roistat-mcp is unchanged. Please open issues and pull requests there.

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

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

[npm] [License: 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

Разработка

bash
npm installnpm test          # Vitestnpm run dev       # stdio (tsx)npm run start:http  # HTTP-сервер

Лицензия

MIT

Telegram: @vhodvai

来源：README.md，提交 403be06

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分