# Send Matomo Analytics to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "matomo", "name": "Matomo Analytics", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ivangdavila/matomo", "canonicalUrl": "https://clawhub.ai/ivangdavila/matomo", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/matomo", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=matomo", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "api.md", "memory-template.md", "reports.md", "setup.md" ], "downloadMode": "redirect", "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/matomo" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/matomo", "downloadUrl": "https://openagent3.xyz/downloads/matomo", "agentUrl": "https://openagent3.xyz/skills/matomo/agent", "manifestUrl": "https://openagent3.xyz/skills/matomo/agent.json", "briefUrl": "https://openagent3.xyz/skills/matomo/agent.md" } } ``` ## Documentation ### Setup On first use, read setup.md for integration guidelines. The skill stores configuration in ~/matomo/. ### When to Use User needs to query Matomo analytics, generate reports, track goals, or manage their self-hosted analytics. Agent handles API queries, data analysis, visitor insights, and conversion tracking. ### Architecture Memory lives in ~/matomo/. See memory-template.md for structure. ~/matomo/ ├── memory.md # Sites, credentials ref, preferences ├── reports/ # Saved report templates └── queries/ # Reusable API query templates ### Quick Reference TopicFileSetup processsetup.mdMemory templatememory-template.mdAPI referenceapi.mdReport templatesreports.md ### 1. Never Expose Credentials Token is stored in system keychain or env var, never in memory files Refer to credentials by reference name only If user pastes token in chat, warn and suggest secure storage ### 2. Use Reporting API for Reads # Base pattern curl -s "https://{matomo_url}/index.php?module=API&method={method}&idSite={site_id}&period={period}&date={date}&format=json&token_auth={token}" Common methods: VisitsSummary.get — visitors, visits, pageviews Actions.getPageUrls — top pages Referrers.getWebsites — traffic sources Goals.get — conversion data ### 3. Understand Date Ranges PeriodDate FormatExampledayYYYY-MM-DD2025-01-15weekYYYY-MM-DDWeek containing that datemonthYYYY-MM2025-01yearYYYY2025rangeYYYY-MM-DD,YYYY-MM-DD2025-01-01,2025-01-31 Special dates: today, yesterday, last7, last30, lastMonth, lastYear ### 4. Handle Multi-Site Setups Always confirm which site before querying Store site list in memory.md with idSite mappings Default to most-used site if configured ### 5. Format Data for Humans Round percentages to 1 decimal Use K/M suffixes for large numbers Compare periods when context helps (vs last week/month) Highlight significant changes (>10% delta) ### 6. Respect Rate Limits Batch related queries into single date range when possible Cache recent results in memory for follow-up questions Avoid querying same data repeatedly in conversation ### 7. Use Segments for Deeper Insights Segments filter data by visitor attributes. Add &segment= to any query: # Mobile visitors only &segment=deviceType==smartphone # From specific country &segment=countryCode==US # Returning visitors who converted &segment=visitorType==returning;goalConversionsSome>0 # Combine with AND (;) or OR (,) &segment=browserCode==CH;operatingSystemCode==WIN Common segment dimensions: deviceType — smartphone, tablet, desktop browserCode — CH (Chrome), FF (Firefox), SF (Safari) countryCode — ISO 2-letter code visitorType — new, returning referrerType — direct, search, website, campaign ### Matomo Traps Wrong idSite → querying wrong property, misleading data. Always confirm site first. Forgetting token_auth → 403 or empty response. Token required for all non-public methods. date vs period mismatch → confusing results. period=range requires date=start,end format. Expecting GA terminology → Matomo uses "visits" not "sessions", "actions" not "events". Translate mentally. Ignoring segments → missing the real insight. Segments filter data by visitor attributes. ### External Endpoints EndpointData SentPurpose{user_matomo_url}/index.phpAPI method, site ID, date range, auth tokenQuery analytics data No other data is sent externally. All requests go to user's own Matomo instance. ### Security & Privacy Data that leaves your machine: API queries sent to user's Matomo instance only Auth token included in requests (user-controlled) Data that stays local: Site configurations in ~/matomo/ Report templates No data sent to third parties This skill does NOT: Store auth tokens in plain text Send data to any service except user's Matomo Access files outside ~/matomo/ ### Related Skills Install with clawhub install if user confirms: analytics — general analytics patterns umami — privacy-focused analytics api — REST API integration ### Feedback If useful: clawhub star matomo Stay updated: clawhub sync ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ivangdavila - Version: 1.0.1 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/matomo) - [Send to Agent page](https://openagent3.xyz/skills/matomo/agent) - [JSON manifest](https://openagent3.xyz/skills/matomo/agent.json) - [Markdown brief](https://openagent3.xyz/skills/matomo/agent.md) - [Download page](https://openagent3.xyz/downloads/matomo)