AI导哈

网站分析服务

MCP服务器用于Piwik PRO分析，可直接从Claude查询网站分析数据。

  • by aplaceforallmystuff
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 aplaceforallmystuff/mcp-piwik

使用说明

mcp-piwik

用于Piwik PRO分析的MCP服务器-直接从Claude查询您的网站分析数据。

特性

  • 列出站点 -查看您Piwik PRO帐户中跟踪的所有网站和应用程序
  • 分析摘要 -获取任何网站的会话、页面浏览量、访问者、跳出率
  • 首页 -查看您访问量最大的页面
  • 流量来源 -了解您的流量来源
  • 目标与转化 -跟踪目标完成情况和收入
  • 自定义查询 -使用任何维度/指标运行灵活的分析查询

安装

先决条件

  1. Piwik PRO帐户
  2. 来自的API凭据 Piwik PRO

设置

# Clone and build
git clone https://github.com/aplaceforallmystuff/mcp-piwik.git
cd mcp-piwik
npm install
npm run build

配置

克劳德代码

claude mcp add piwik -s user \
  --env PIWIK_ACCOUNT=your-account-name \
  --env PIWIK_CLIENT_ID=your-client-id \
  --env PIWIK_CLIENT_SECRET=your-client-secret \
  -- node /path/to/mcp-piwik/dist/index.js

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "piwik": {
      "command": "node",
      "args": ["/path/to/mcp-piwik/dist/index.js"],
      "env": {
        "PIWIK_ACCOUNT": "your-account-name",
        "PIWIK_CLIENT_ID": "your-client-id",
        "PIWIK_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

替换：

  • your-account-name -您的Piwik PRO子域（例如，如果您的URL是 example.piwik.pro，使用 example)
  • your-client-id -来自API凭据的OAuth客户端ID
  • your-client-secret -来自API凭据的OAuth客户端机密

可用工具

piwik_list_sites

列出您的Piwik PRO帐户中跟踪的所有网站和应用程序。

piwik_analytics_summary

获取网站的分析摘要（会话、页面浏览量、访问者、跳出率、平均会话时间）。

参数：

  • siteId （必填）-来自piwik_list_sites的站点/应用程序ID
  • dateFrom （可选）-开始日期YYYY-MM-DD（默认值：30天前）
  • dateTo （可选）-结束日期YYYY-MM-DD（默认值：今天）

piwik_top_pages

按页面浏览量获取首页。

参数：

  • siteId （必填）-站点/应用程序ID
  • dateFrom （可选）-开始日期
  • dateTo （可选）-结束日期
  • limit （可选）-结果数量（默认值：10）

piwik_traffic_来源

获取流量来源细分（来源/媒介、会话、访问者、跳出率）。

参数：

  • siteId （必填）-站点/应用程序ID
  • dateFrom （可选）-开始日期
  • dateTo （可选）-结束日期

piwik_goals

获取目标完成情况和转化数据。

参数：

  • siteId （必填）-站点/应用程序ID
  • dateFrom （可选）-开始日期
  • dateTo （可选）-结束日期

piwik_custom_query

使用指定的维度和指标运行自定义分析查询。

参数：

  • siteId （必填）-站点/应用程序ID
  • columns （必填）-列ID数组（例如。， ["sessions", "page_views", "country"])
  • dateFrom （可选）-开始日期
  • dateTo （可选）-结束日期
  • limit （可选）-结果数量（默认值：50）

piwik_available_columns

列出可用于查询的常见维度和指标。

示例用法

"Show me the top 10 pages on my site for the last 7 days"

"What are my traffic sources this month?"

"Give me an analytics summary for December"

"Run a custom query for sessions and visitors by country"

许可证

麻省理工学院

作者

吉姆·克里斯蒂安- https://jimchristian.net

相关 MCP