roistat-mcp

🗄 仓库已归档

开发工作已迁移至 theYahia/WWmcp——一个面向非西方 API 的 MCP 服务单体仓库：独联体国家、中东北非、非洲、拉美、东南亚。共用核心 @theyahia/mcp-core、统一 CI 和统一发布流程。

此处内容的最新版本：servers/roistat/

npm 包仍是原来的——@theyahia/roistat-mcp，安装和使用方式与以前相同。 此处不再更新。请在 WWmcp 中提交问题和 pull request。

已归档——开发工作已迁移至 theYahia/WWmcp， 一个面向非西方 API 的 MCP 服务单体仓库。 此包的当前版本现位于 servers/roistat/。 npm 包 @theyahia/roistat-mcp 保持不变。 请在那里提交问题和 pull request。

Roistat MCP——在与神经网络的对话中进行端到端分析并了解每条线索的成本

如果你想知道如何询问 AI 每个渠道带来的线索成本、将广告支出与销售额汇总，或无需手动制作报告即可导出 Roistat 线索，这就是你要找的内容。基于 Roistat API 的 6 个工具：线索、广告渠道、支出、分析和集成。需要 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	是	Roistat 项目的 API 密钥
ROISTAT_PROJECT_ID	是	Roistat 中的项目 ID

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