Skill Trend Analysis

当用户需要分析 ClawHub Skills 的增长趋势、排行变化、时间范围表现或相关接口数据时使用。支持增速榜、榜单对比、搜索筛选、统计、标签、作者、时间范围与导出等 API 查询与结果解读。

何时使用

当用户提出以下需求时使用本 skill：

• 分析技能下载量或 Star 的增长趋势
• 查找近期上升最快的技能、作者或标签相关线索
• 对比不同时间窗口内的榜单、搜索结果或统计结果
• 生成或执行 curl / jq API 调用，并解释返回数据
• 调试趋势分析相关参数，如 start_date、end_date、days、metric、rank_limit

基础信息

• 线上站点：http://skills.easytoken.cc/
• API 前缀：http://skills.easytoken.cc/api
• 接口限流：同一 IP 对同一接口约 3 秒 1 次，触发时返回 429

工作流程

1. 先明确分析目标：增长榜、榜单对比、搜索筛选、作者或标签观察。
2. 再确定时间窗口与指标：优先确认 start_date / end_date 或 days，以及 metric=downloads|stars。
3. 优先使用只读接口（/skills/growth、/skills/top、/skills/search、/stats、/tags、/authors）。
4. 用 curl -sS 请求，用 jq 提取关键字段，必要时只保留前几项用于结论展示。
5. 回答用户时先给趋势结论，再给支撑数据和关键参数。
6. 若出现 429，等待 3 秒后重试。

常用命令模板

BASE_URL="http://skills.easytoken.cc/api"

# 1) 下载增速榜
curl -sS "$BASE_URL/skills/growth?start_date=2026-03-01&end_date=2026-03-30&metric=downloads&rank_limit=1000&limit=20" | jq .

# 2) Star 增速榜
curl -sS "$BASE_URL/skills/growth?days=7&metric=stars&rank_limit=1000&limit=20" | jq .

# 3) 当前 TOP 榜单
curl -sS "$BASE_URL/skills/top?limit=20&order=downloads" | jq .

# 4) 搜索某类技能并观察表现
curl -sS "$BASE_URL/skills/search?q=python&limit=50" | jq .

# 5) 时间范围查询
curl -sS "$BASE_URL/skills/time-range?start_date=2026-03-01&end_date=2026-03-30&date_field=updated_at&order=updated_at&limit=20" | jq .

# 6) 汇总统计
curl -sS "$BASE_URL/stats" | jq .

输出要求

• 默认输出简短结论，不只贴原始 JSON。
• 说明使用的时间范围、指标和排序方式。
• 如果是增速榜，优先指出增长最快的技能及其增长值。
• 如果是搜索或榜单对比，优先总结共同特征，再补充样本数据。
• 若数据不足以支持结论，明确说明限制。

更多接口

详细端点与参数说明见：references/api-endpoints.md

脚本工具

可直接使用脚本：

• scripts/call_api.sh：快速请求任意 API 端点

示例：

bash scripts/call_api.sh skills/top "limit=10&order=stars"
bash scripts/call_api.sh skills/growth "start_date=2026-03-24&end_date=2026-03-30&rank_limit=1000&limit=20"