MCP Piwik

mcp-piwik

Architecture

](https://www.npmjs.com/package/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