用途:通过 Yandex Metrica API 获取网站分析数据,包括流量统计、转化报表、目标与原始日志导出。
主要能力:管理 API 用于计数器、目标、筛选器、授权、分段;Reporting API 用于聚合统计、维度与指标;Logs API 用于导出原始访问/点击数据。脚本包括 check_connection.sh(验证令牌并列出计数器)、counters.sh(列出/查看计数器)、stats.sh(按预设或自定义指标维度拉取报表,支持过滤、排序、时间序列、CSV 导出)、goals.sh(列出/获取目标)、logs.sh(评估、创建、查询状态、下载、清理日志请求)。
使用方式:需在 config/.env 配置 YANDEX_METRICA_TOKEN,令牌需 OAuth 权限 metrika:read、metrika:write。脚本须用 bash 前缀和技能目录下的绝对路径运行,不要直接 source scripts/common.sh。示例:bash scripts/get_token.sh --client-id YOUR_CLIENT_ID;bash scripts/check_connection.sh;bash scripts/counters.sh --action list;bash scripts/stats.sh --counter 12345678 --preset traffic;bash scripts/logs.sh --action create --counter 12345678 --date1 2025-01-01 --date2 2025-01-31。API 基础地址 https://api-metrika.yandex.net,认证头 Authorization: OAuth TOKEN。
适用场景:网站流量与来源分析、落地页与内容表现、目标转化统计、地域/设备/浏览器维度分析、原始日志导出用于深度处理。
限制:受速率限制约束(通用 API 30 请求/秒/IP,Logs API 10 请求/秒/IP,并行请求 3/用户,每日 5000 请求,Reports API 200 请求/5 分钟)。脚本依赖 bash 特性,不适用于 zsh。令牌与权限配置细节见 config/README.md,完整 API 参考见 references/api-reference.md。