⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Plausible API 使用指南：查询网站分析数据与管理站点 | 注重隐私的统计工具

plausible by vm0-ai/vm0-skills

67 周安装量

49 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vm0-ai/vm0-skills --skill plausible

隐私保护数据分析 API

🇨🇳中文介绍

Plausible Analytics API

使用 Plausible 注重隐私的分析平台查询网站分析数据并管理站点。

何时使用

查询访客统计数据和页面浏览量
分析流量来源和引荐来源
获取地理和设备细分数据
跟踪转化和目标
以编程方式管理分析站点

前提条件

export PLAUSIBLE_TOKEN=your-api-key

获取 API 密钥

登录 Plausible：https://plausible.io/login
进入账户设置（右上角菜单）
在侧边栏中导航至 "API Keys"
点击 "New API Key"
选择密钥类型：
- Stats API - 用于查询分析数据
- Sites API - 用于以编程方式管理站点
保存密钥（仅显示一次）

Stats API (v2)

基础查询 - 总访客数

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "7d"
}

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

带维度的查询（细分）

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews", "bounce_rate"],
  "date_range": "30d",
  "dimensions": ["visit:source"]
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "7d",
  "dimensions": ["event:page"],
  "order_by": [["pageviews", "desc"]],
  "pagination": {
    "limit": 10
  }
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors"],
  "date_range": "30d",
  "dimensions": ["visit:country_name", "visit:city_name"]
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

设备和浏览器统计

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors"],
  "date_range": "7d",
  "dimensions": ["visit:device"]
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

时间序列（每日）

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "30d",
  "dimensions": ["time:day"]
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

按页面路径筛选

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "7d",
  "filters": [["contains", "event:page", ["/blog"]]]
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

UTM 营销活动分析

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "conversion_rate"],
  "date_range": "30d",
  "dimensions": ["visit:utm_source", "visit:utm_campaign"]
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

自定义日期范围

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": ["2024-01-01", "2024-01-31"]
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Site Provisioning API

curl -s -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites"

写入 /tmp/plausible_request.json：

{
  "domain": "newsite.com",
  "timezone": "America/New_York"
}

curl -s -X POST "https://plausible.io/api/v1/sites" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites/<your-site-id>"

警告： 这将永久删除该站点及其所有数据。

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X DELETE -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites/<your-site-id>"

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "goal_type": "event",
  "event_name": "Signup"
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X PUT "https://plausible.io/api/v1/sites/goals" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "goal_type": "page",
  "page_path": "/thank-you"
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X PUT "https://plausible.io/api/v1/sites/goals" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites/goals?site_id=<your-site-id>"

写入 /tmp/plausible_request.json：

{
  "site_id": "<your-site-id>",
  "name": "Public Dashboard"
}

将 <your-site-id> 替换为您的实际站点 ID（通常是您的域名，如 "example.com"）：

curl -s -X PUT "https://plausible.io/api/v1/sites/shared-links" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

指标	类型	描述
`visitors`	int	独立访客数
`visits`	int	总会话数
`pageviews`	int	页面浏览量
`bounce_rate`	float	跳出率（%）
`visit_duration`	int	平均停留时长（秒）
`views_per_visit`	float	每次会话浏览页数
`conversion_rate`	float	目标转化率（需要配置目标）
`events`	int	总事件数

注意： conversion_rate 指标要求为您的站点至少配置一个目标。在查询转化率之前，请先使用 "Create Goal" 或 "Create Page Goal" 端点创建一个目标。

event:goal - 自定义目标
event:page - 页面路径
event:hostname - 主机名

visit:source - 流量来源
visit:referrer - 完整引荐来源 URL
visit:utm_source - UTM 来源
visit:utm_medium - UTM 媒介
visit:utm_campaign - UTM 营销活动
visit:country_name - 国家
visit:region_name - 地区/州
visit:city_name - 城市
visit:device - 设备类型
visit:browser - 浏览器名称
visit:browser_version - 浏览器版本
visit:os - 操作系统
visit:os_version - 操作系统版本

time - 自动粒度
time:hour - 每小时
time:day - 每日
time:week - 每周
time:month - 每月

运算符	描述
`is`	等于任何值
`is_not`	不等于
`contains`	包含子字符串
`matches`	正则表达式匹配

["and", [
  ["is", "visit:country_name", ["United States"]],
  ["contains", "event:page", ["/blog"]]
]]

值	描述
`day`	今天
`7d`	过去 7 天
`28d`	过去 28 天
`30d`	过去 30 天
`month`	当前月
`6mo`	过去 6 个月
`12mo`	过去 12 个月
`year`	当前年
`all`	所有时间
`["2024-01-01", "2024-12-31"]`	自定义范围

每个 API 密钥每小时 600 个请求

2026 年 1 月 23 日

🇺🇸English

Plausible Analytics API

Query website analytics and manage sites with Plausible's privacy-friendly analytics platform.

When to Use

Query visitor statistics and pageviews
Analyze traffic sources and referrers
Get geographic and device breakdowns
Track conversions and goals
Manage analytics sites programmatically

Prerequisites

export PLAUSIBLE_TOKEN=your-api-key

Get API Key

Log in to Plausible: https://plausible.io/login
Go to Account Settings (top-right menu)
Navigate to "API Keys" in sidebar
Click "New API Key"
Choose key type:

Stats API - For querying analytics data
Sites API - For managing sites programmatically

Save the key (shown only once)

Stats API (v2)

Basic Query - Total Visitors

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "7d"
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Docs: https://plausible.io/docs/stats-api

Query with Dimensions (Breakdown)

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews", "bounce_rate"],
  "date_range": "30d",
  "dimensions": ["visit:source"]
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Top Pages

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "7d",
  "dimensions": ["event:page"],
  "order_by": [["pageviews", "desc"]],
  "pagination": {
    "limit": 10
  }
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Geographic Breakdown

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors"],
  "date_range": "30d",
  "dimensions": ["visit:country_name", "visit:city_name"]
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Device & Browser Stats

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors"],
  "date_range": "7d",
  "dimensions": ["visit:device"]
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Time Series (Daily)

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "30d",
  "dimensions": ["time:day"]
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Filter by Page Path

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": "7d",
  "filters": [["contains", "event:page", ["/blog"]]]
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

UTM Campaign Analysis

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "conversion_rate"],
  "date_range": "30d",
  "dimensions": ["visit:utm_source", "visit:utm_campaign"]
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Custom Date Range

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "metrics": ["visitors", "pageviews"],
  "date_range": ["2024-01-01", "2024-01-31"]
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X POST "https://plausible.io/api/v2/query" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Site Provisioning API

List Sites

curl -s -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites"

Docs: https://plausible.io/docs/sites-api

Create Site

Write to /tmp/plausible_request.json:

{
  "domain": "newsite.com",
  "timezone": "America/New_York"
}

Then run:

curl -s -X POST "https://plausible.io/api/v1/sites" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Get Site Details

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites/<your-site-id>"

Delete Site

Warning: This will permanently delete the site and all its data.

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X DELETE -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites/<your-site-id>"

Create Goal

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "goal_type": "event",
  "event_name": "Signup"
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X PUT "https://plausible.io/api/v1/sites/goals" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Create Page Goal

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "goal_type": "page",
  "page_path": "/thank-you"
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X PUT "https://plausible.io/api/v1/sites/goals" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

List Goals

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites/goals?site_id=<your-site-id>"

Create Shared Link

Write to /tmp/plausible_request.json:

{
  "site_id": "<your-site-id>",
  "name": "Public Dashboard"
}

Replace <your-site-id> with your actual site ID (typically your domain like "example.com"):

curl -s -X PUT "https://plausible.io/api/v1/sites/shared-links" -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" -H "Content-Type: application/json" -d @/tmp/plausible_request.json

Available Metrics

Metric	Type	Description
`visitors`	int	Unique visitors
`visits`	int	Total sessions
`pageviews`	int	Page views
`bounce_rate`	float	Bounce rate (%)
`visit_duration`	int	Avg duration (seconds)

Note: The conversion_rate metric requires at least one goal to be configured for your site. Create a goal first using the "Create Goal" or "Create Page Goal" endpoints before querying conversion rates.

Available Dimensions

Event Dimensions

event:goal - Custom goals
event:page - Page path
event:hostname - Hostname

Visit Dimensions

visit:source - Traffic source
visit:referrer - Full referrer URL
visit:utm_source - UTM source
visit:utm_medium - UTM medium
visit:utm_campaign - UTM campaign
visit:country_name - Country
visit:region_name - Region/State
visit:city_name - City
visit:device - Device type
visit:browser - Browser name

Time Dimensions

time - Auto granularity
time:hour - Hourly
time:day - Daily
time:week - Weekly
time:month - Monthly

Filter Operators

Operator	Description
`is`	Equals any value
`is_not`	Not equals
`contains`	Contains substring
`matches`	Regex match

Complex Filters

["and", [
  ["is", "visit:country_name", ["United States"]],
  ["contains", "event:page", ["/blog"]]
]]

Date Range Options

Value	Description
`day`	Today
`7d`	Last 7 days
`28d`	Last 28 days
`30d`	Last 30 days
`month`	Current month
`6mo`	Last 6 months
`12mo`

Rate Limits

600 requests per hour per API key

API Reference

Stats API: https://plausible.io/docs/stats-api
Sites API: https://plausible.io/docs/sites-api
Main Docs: https://plausible.io/docs

Weekly Installs

Repository

vm0-ai/vm0-skills

GitHub Stars

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

gemini-cli55

opencode55

codex54

claude-code52

cursor51

github-copilot51

SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试

56,700 周安装

visit:browser_version - Browser version

visit:os - Operating system

visit:os_version - OS version

Plausible API 使用指南：查询网站分析数据与管理站点 | 注重隐私的统计工具

🇨🇳中文介绍

Plausible Analytics API

何时使用

前提条件

获取 API 密钥

Stats API (v2)

基础查询 - 总访客数

相关 Skills

带维度的查询（细分）

热门页面

地理细分

设备和浏览器统计

时间序列（每日）

按页面路径筛选

UTM 营销活动分析

自定义日期范围

Site Provisioning API

列出站点

创建站点

获取站点详情

删除站点

创建目标

创建页面目标

列出目标

创建共享链接

可用指标

可用维度

事件维度

访问维度

时间维度

筛选运算符

复杂筛选

日期范围选项

速率限制

API 参考

🇺🇸English

Plausible Analytics API

When to Use

Prerequisites

Get API Key

Stats API (v2)

Basic Query - Total Visitors

Query with Dimensions (Breakdown)

Top Pages

Geographic Breakdown

Device & Browser Stats

Time Series (Daily)

Filter by Page Path

UTM Campaign Analysis

Custom Date Range

Site Provisioning API

List Sites

Create Site

Get Site Details

Delete Site

Create Goal

Create Page Goal

List Goals

Create Shared Link

Available Metrics

Available Dimensions

Event Dimensions

Visit Dimensions

Time Dimensions

Filter Operators

Complex Filters

Date Range Options

Rate Limits

API Reference

最新 Skills