重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
plausible by vm0-ai/vm0-skills
npx skills add https://github.com/vm0-ai/vm0-skills --skill plausible使用 Plausible 注重隐私的分析平台查询网站分析数据并管理站点。
export PLAUSIBLE_TOKEN=your-api-key
写入 /tmp/plausible_request.json:
{
"site_id": "<your-site-id>",
"metrics": ["visitors", "pageviews"],
"date_range": "7d"
}
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
将 <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", "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
写入 /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
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 - 完整引荐来源 URLvisit: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"] | 自定义范围 |
每周安装数
67
代码仓库
GitHub 星标数
49
首次出现
2026 年 1 月 23 日
安全审计
安装于
gemini-cli55
opencode55
codex54
claude-code52
cursor51
github-copilot51
Query website analytics and manage sites with Plausible's privacy-friendly analytics platform.
export PLAUSIBLE_TOKEN=your-api-key
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
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
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
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
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
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
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
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
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
curl -s -H "Authorization: Bearer $(printenv PLAUSIBLE_TOKEN)" "https://plausible.io/api/v1/sites"
Docs: https://plausible.io/docs/sites-api
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
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>"
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>"
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
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
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>"
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
| 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_ratemetric 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.
event:goal - Custom goalsevent:page - Page pathevent:hostname - Hostnamevisit:source - Traffic sourcevisit:referrer - Full referrer URLvisit:utm_source - UTM sourcevisit:utm_medium - UTM mediumvisit:utm_campaign - UTM campaignvisit:country_name - Countryvisit:region_name - Region/Statevisit:city_name - Cityvisit:device - Device typevisit:browser - Browser nametime - Auto granularitytime:hour - Hourlytime:day - Dailytime:week - Weeklytime:month - Monthly| Operator | Description |
|---|---|
is | Equals any value |
is_not | Not equals |
contains | Contains substring |
matches | Regex match |
["and", [
["is", "visit:country_name", ["United States"]],
["contains", "event:page", ["/blog"]]
]]
| Value | Description |
|---|---|
day | Today |
7d | Last 7 days |
28d | Last 28 days |
30d | Last 30 days |
month | Current month |
6mo | Last 6 months |
12mo |
Weekly Installs
67
Repository
GitHub Stars
49
First Seen
Jan 23, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
gemini-cli55
opencode55
codex54
claude-code52
cursor51
github-copilot51
SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试
56,700 周安装
views_per_visit | float | Pages per session |
conversion_rate | float | Goal conversion rate (requires goal to be configured) |
events | int | Total events |
visit:browser_version - Browser versionvisit:os - Operating systemvisit:os_version - OS version| Last 12 months |
year | Current year |
all | All time |
["2024-01-01", "2024-12-31"] | Custom range |