English Français العربية

io.github.theYahia/roistat-mcp

السجل الرسمي مؤرشف التسويق والمبيعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/roistat-mcp
Claude Code 
claude mcp add roistat-mcp -e 'ROISTAT_API_KEY=<your roistat_api_key>' -- npx -y @theyahia/roistat-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "roistat-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/roistat-mcp@1.0.1"
            ],
            "env": {
                "ROISTAT_API_KEY": "<your roistat_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • ROISTAT_API_KEY إلزامي سري API key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. 🗄 Репозиторий заархивирован
  2. Roistat MCP — сквозная аналитика и стоимость лида в диалоге с нейросетью
  3. Установка
  4. Авторизация
  5. Инструменты (6)
  6. Скиллы (Prompts)
  7. Примеры запросов
  8. Реферальная программа Roistat
  9. Разработка
  10. Лицензия

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

Разработка переехала в 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 проекта.

Установка

Claude Desktop
{
  "mcpServers": {
    "roistat": {
      "command": "npx",
      "args": ["-y", "@theyahia/roistat-mcp"],
      "env": {
        "ROISTAT_API_KEY": "ваш_ключ",
        "ROISTAT_PROJECT_ID": "ваш_id_проекта"
      }
    }
  }
}
Claude Code
claude mcp add roistat \
  -e ROISTAT_API_KEY=ваш_ключ \
  -e ROISTAT_PROJECT_ID=ваш_id_проекта \
  -- npx -y @theyahia/roistat-mcp
Streamable HTTP
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

Разработка

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

Лицензия

MIT

Telegram: @vhodvai

الأسئلة الشائعة

ما هو io.github.theYahia/roistat-mcp؟

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

كيف أثبّت io.github.theYahia/roistat-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add roistat-mcp -e 'ROISTAT_API_KEY=<your roistat_api_key>' -- npx -y @theyahia/roistat-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/roistat-mcp إلى مفتاح API؟

نعم. يتطلب ROISTAT_API_KEY، وتضبطها في إعداداته.

هل io.github.theYahia/roistat-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/roistat-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.