用途：seo-matomo 通过 Matomo Reporting API 获取分析报告，适用于希望摆脱 Google 依赖、自有分析数据或处于严格数据驻留边界内的场景。同一技能可对接 Matomo Cloud 与自托管实例。
前提条件：运行 extensions/matomo/install.sh 或 install.ps1；准备 Matomo 实例 URL（如 https://analytics.example.com）；准备对所分析站点有 view 权限的 API token_auth；可选设置默认 idSite，避免每次调用都传 --site-id。
主要命令：/seo matomo check 校验认证；/seo matomo organic [site-id] 查看自然流量；此外有 top-pages、device、country、referrers、keywords 报告。所有命令支持 --days（默认 28）、--limit、--site-id、--json；站点 ID 可回退到设置中的 MATOMO_SITE_ID。
适用场景：用户已有 Matomo 实例，或明确提到 Matomo、自托管分析、替换 GA4，想从 GA4 迁移并获得同类报告（自然流量趋势、落地页、设备/国家分布、引荐来源）。
跨技能分工：Google Search Console、CrUX、索引相关走 seo-google；AI Overview 与 GEO 可引用性走 seo-geo；本技能负责访问、页面、引荐等报告，不含搜索表现指标。在 /seo audit 中，若 matomo_auth.py --check 成功，编排器会启动 seo-matomo 智能体，可与 seo-google 同时运行。
自托管与安全限制：所有请求经过 SSRF 防护，实例 URL 会校验并 DNS 固定，跳转到实例外会被拒绝；私有、回环、链路本地地址默认拒绝。若实例位于私有地址，需在 CLAUDE_SEO_LOCAL_TARGETS 白名单中声明，例如：export CLAUDE_SEO_LOCAL_TARGETS="matomo.internal:8080"。条目为 host 或 host:port，逗号分隔，精确匹配；白名单仅覆盖顶级实例 URL，重定向目标与其他主机保持失败关闭，云元数据地址即使列出也被拒绝。不要建议关闭防护或修改 url_safety.py。
错误处理：SSRF 防护拒绝时，错误会指明 CLAUDE_SEO_LOCAL_TARGETS，按其给出的 host:port 配置；重定向被拒说明 MATOMO_URL 指向重定向器而非 Reporting API；缺少凭据时提示未设置的变量并运行安装或 matomo_auth.py --setup；HTTP 401/403 表示 token 对该站点缺少 view 权限；Matomo 返回 result=error 时原样呈现消息；连接、SSL、超时类错误需报告网络失败类别并确认 MATOMO_URL 可解析。技能不会记录 token。
输出格式：时间序列、设备、国家数据用表格；来自 Matomo 数据的跨技能行动按 Critical/High/Medium/Low 标注优先级；数据来源始终标注为 “Matomo Reporting API (live)”。关键词报告中需突出 anonymized_share_pct；受浏览器隐私与 Matomo 匿名化规则影响，许多关键词为 “(not provided)”，属正常现象。
未提供的信息：安装脚本内部细节、具体配置键名、MATOMO_SITE_ID 之外的设置项、支持的命令参数完整列表、价格与收费情况、性能表现等，资料中暂未提供。