用途:查询已经发生过的 Zyte API 历史用量统计,不用于预测、仪表盘搭建、文档或配置帮助。
主要能力:通过随技能附带的封装脚本调用 Zyte Stats API,返回原始 JSON 响应;脚本自行处理鉴权、项目查找与重试,避免向模型暴露 API 密钥。智能体负责把返回的 JSON 整理后呈现给用户,且结论不得超出 JSON 明确给出的数据。
使用方式:先用项目查找助手解析 organization_id:uv run --no-project "${CLAUDE_SKILL_DIR}/scripts/project_org_lookup.py"。根据返回的 JSON 状态分支处理:resolved_project_with_organization 直接使用 organization_id;multiple_projects_found 时让用户在组织列表中按返回的 organization_id 选择,并用 --project 重跑助手(如 --project 2);no_project_configured 或 organization_lookup_failed 时提示用户使用 /scrape-zyte-login 配置项目与凭据后重试。随后以 JSON 对象传入参数运行封装脚本:uv run --no-project "${CLAUDE_SKILL_DIR}/scripts/zyte_api_stats.py" --params '{"organization_id": 3}'。参数名需直接依据 Stats API 文档构建,封装不做翻译或校验。需要确认鉴权时用 --check-key。
窗口与分页:用户指定最近 7 天、30 天或本月等相对窗口时,计算一个 UTC 的 start_time/end_time 传入;未指定窗口则不传,使用 API 默认范围。可用 page、page_size、total_result_count 判断是否还有更多页,翻页时只递增 page。返回 results 为空时告知用户无数据,不要编造。
限制:状态码如 520 有 Zyte 特定含义,除非响应或文档明确说明否则不得重新标注。不得依据费用、响应时间或状态码构成推断缓存、文章大小、站点可用性或故障原因。不得直接读取或打印凭据值。支持的参数、筛选、分组与响应字段以 https://docs.zyte.com/zyte-api/usage/stats.md 的 Reference 部分为准。