{ "schemaVersion": "1.0", "item": { "slug": "plausible", "name": "Plausible", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ivangdavila/plausible", "canonicalUrl": "https://clawhub.ai/ivangdavila/plausible", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/plausible", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plausible", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "memory-template.md", "setup.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/plausible" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/plausible", "agentPageUrl": "https://openagent3.xyz/skills/plausible/agent", "manifestUrl": "https://openagent3.xyz/skills/plausible/agent.json", "briefUrl": "https://openagent3.xyz/skills/plausible/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Setup", "body": "On first use, read setup.md for integration guidelines." }, { "title": "When to Use", "body": "User needs website traffic data from Plausible. Agent queries visitors, pageviews, referrers, goals, and custom events through the Plausible API." }, { "title": "Architecture", "body": "Memory lives in ~/plausible/. See memory-template.md for structure.\n\n~/plausible/\n├── memory.md # Sites + preferences (no secrets stored)\n└── queries/ # Saved query templates (optional)" }, { "title": "Quick Reference", "body": "TopicFileSetup processsetup.mdMemory templatememory-template.md" }, { "title": "1. API Key from Environment", "body": "API key comes from PLAUSIBLE_API_KEY environment variable. Never hardcode or ask user to paste keys in chat." }, { "title": "2. Site ID Required", "body": "Every query needs a site_id (domain). Check memory.md for configured sites before asking." }, { "title": "3. Time Periods", "body": "Default to 30d unless user specifies. Valid periods: day, 7d, 30d, month, 6mo, 12mo, custom (requires date/date_range)." }, { "title": "4. Metrics Available", "body": "MetricDescriptionvisitorsUnique visitorsvisitsTotal sessionspageviewsTotal page viewsviews_per_visitPages per sessionbounce_rateSingle-page visits %visit_durationAvg session length (seconds)eventsCustom event countconversion_rateGoal conversion % (requires goal filter)" }, { "title": "5. Breakdown Dimensions", "body": "DimensionDescriptionevent:pagePagesevent:nameCustom eventsvisit:sourceTraffic sourcesvisit:referrerFull referrer URLsvisit:utm_sourceUTM sourcevisit:utm_mediumUTM mediumvisit:utm_campaignUTM campaignvisit:deviceDesktop/Mobile/Tabletvisit:browserBrowser namevisit:osOperating systemvisit:countryCountry codevisit:cityCity name" }, { "title": "6. Filters Syntax", "body": "Filters use format: dimension==value or dimension!=value. Multiple filters with ; (AND).\n\nvisit:source==Google\nevent:page==/pricing;visit:country==US" }, { "title": "7. Rate Limits", "body": "600 requests/hour per API key. Cache results in memory when doing multiple queries." }, { "title": "Common Traps", "body": "Forgetting site_id → API returns 400\nUsing wrong date format for custom range → use YYYY-MM-DD\nRequesting conversion_rate without goal filter → returns null\nQuerying breakdown without metrics → defaults to visitors only" }, { "title": "External Endpoints", "body": "EndpointData SentPurposehttps://plausible.io/api/v1/stats/realtime/visitorssite_idRealtime counthttps://plausible.io/api/v1/stats/aggregatesite_id, metrics, period, filtersAggregate statshttps://plausible.io/api/v1/stats/timeseriessite_id, metrics, period, intervalTime serieshttps://plausible.io/api/v1/stats/breakdownsite_id, property, metrics, filtersBreakdown by dimension\n\nSelf-hosted instances use custom base URL from memory.md.\n\nNo other data is sent externally." }, { "title": "Security & Privacy", "body": "Data that leaves your machine:\n\nSite ID (domain) and query parameters sent to Plausible API\nAPI key sent as Bearer token\n\nData that stays local:\n\nQuery results cached in memory\nSite configurations in ~/plausible/\n\nThis skill does NOT:\n\nStore API keys in plain text (uses environment variable)\nSend user data beyond what's needed for queries\nAccess files outside ~/plausible/" }, { "title": "Trust", "body": "By using this skill, your site analytics queries are sent to Plausible (plausible.io or your self-hosted instance).\nOnly install if you trust Plausible with your domain data." }, { "title": "Related Skills", "body": "Install with clawhub install if user confirms:\n\nanalytics — general analytics guidance\numami — alternative privacy analytics\nmixpanel — product analytics" }, { "title": "Feedback", "body": "If useful: clawhub star plausible\nStay updated: clawhub sync" } ], "body": "Setup\n\nOn first use, read setup.md for integration guidelines.\n\nWhen to Use\n\nUser needs website traffic data from Plausible. Agent queries visitors, pageviews, referrers, goals, and custom events through the Plausible API.\n\nArchitecture\n\nMemory lives in ~/plausible/. See memory-template.md for structure.\n\n~/plausible/\n├── memory.md # Sites + preferences (no secrets stored)\n└── queries/ # Saved query templates (optional)\n\nQuick Reference\nTopic\tFile\nSetup process\tsetup.md\nMemory template\tmemory-template.md\nCore Rules\n1. API Key from Environment\n\nAPI key comes from PLAUSIBLE_API_KEY environment variable. Never hardcode or ask user to paste keys in chat.\n\n2. Site ID Required\n\nEvery query needs a site_id (domain). Check memory.md for configured sites before asking.\n\n3. Time Periods\n\nDefault to 30d unless user specifies. Valid periods: day, 7d, 30d, month, 6mo, 12mo, custom (requires date/date_range).\n\n4. Metrics Available\nMetric\tDescription\nvisitors\tUnique visitors\nvisits\tTotal sessions\npageviews\tTotal page views\nviews_per_visit\tPages per session\nbounce_rate\tSingle-page visits %\nvisit_duration\tAvg session length (seconds)\nevents\tCustom event count\nconversion_rate\tGoal conversion % (requires goal filter)\n5. Breakdown Dimensions\nDimension\tDescription\nevent:page\tPages\nevent:name\tCustom events\nvisit:source\tTraffic sources\nvisit:referrer\tFull referrer URLs\nvisit:utm_source\tUTM source\nvisit:utm_medium\tUTM medium\nvisit:utm_campaign\tUTM campaign\nvisit:device\tDesktop/Mobile/Tablet\nvisit:browser\tBrowser name\nvisit:os\tOperating system\nvisit:country\tCountry code\nvisit:city\tCity name\n6. Filters Syntax\n\nFilters use format: dimension==value or dimension!=value. Multiple filters with ; (AND).\n\nvisit:source==Google\nevent:page==/pricing;visit:country==US\n\n7. Rate Limits\n\n600 requests/hour per API key. Cache results in memory when doing multiple queries.\n\nCommon Traps\nForgetting site_id → API returns 400\nUsing wrong date format for custom range → use YYYY-MM-DD\nRequesting conversion_rate without goal filter → returns null\nQuerying breakdown without metrics → defaults to visitors only\nExternal Endpoints\nEndpoint\tData Sent\tPurpose\nhttps://plausible.io/api/v1/stats/realtime/visitors\tsite_id\tRealtime count\nhttps://plausible.io/api/v1/stats/aggregate\tsite_id, metrics, period, filters\tAggregate stats\nhttps://plausible.io/api/v1/stats/timeseries\tsite_id, metrics, period, interval\tTime series\nhttps://plausible.io/api/v1/stats/breakdown\tsite_id, property, metrics, filters\tBreakdown by dimension\n\nSelf-hosted instances use custom base URL from memory.md.\n\nNo other data is sent externally.\n\nSecurity & Privacy\n\nData that leaves your machine:\n\nSite ID (domain) and query parameters sent to Plausible API\nAPI key sent as Bearer token\n\nData that stays local:\n\nQuery results cached in memory\nSite configurations in ~/plausible/\n\nThis skill does NOT:\n\nStore API keys in plain text (uses environment variable)\nSend user data beyond what's needed for queries\nAccess files outside ~/plausible/\nTrust\n\nBy using this skill, your site analytics queries are sent to Plausible (plausible.io or your self-hosted instance). Only install if you trust Plausible with your domain data.\n\nRelated Skills\n\nInstall with clawhub install if user confirms:\n\nanalytics — general analytics guidance\numami — alternative privacy analytics\nmixpanel — product analytics\nFeedback\nIf useful: clawhub star plausible\nStay updated: clawhub sync" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ivangdavila/plausible", "publisherUrl": "https://clawhub.ai/ivangdavila/plausible", "owner": "ivangdavila", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/plausible", "downloadUrl": "https://openagent3.xyz/downloads/plausible", "agentUrl": "https://openagent3.xyz/skills/plausible/agent", "manifestUrl": "https://openagent3.xyz/skills/plausible/agent.json", "briefUrl": "https://openagent3.xyz/skills/plausible/agent.md" } }