Top ClawHub Skills

核心用法

Top ClawHub Skills 是一个数据查询类工具，通过调用 https://topclawhubskills.com/api 提供 ClawHub 技能市场的实时洞察。支持八大核心场景：

1. 热门发现：/api/top-downloads 与 /api/top-stars 分别按下载量和收藏数排序，快速定位社区最受欢迎的技能
2. 新品追踪：/api/newest 获取最新上架技能，适合抢先体验前沿工具
3. 安全筛选：/api/certified 专供通过多层安全审查的技能，比标准 VirusTotal 检测更深入，涵盖代码模式、网络行为和权限分析
4. 历史追溯：/api/deleted 保留已下架技能记录，支持研究废弃工具或规避潜在风险
5. 精准搜索：/api/search?q=TERM 支持跨 slug、名称、摘要和作者的全文检索
6. 宏观洞察：/api/stats 提供平台总量、认证率、删除率等关键指标；/api/health 监控 API 可用性

返回数据自动格式化为 Markdown 表格，包含智能数字缩写（K/M）、相对时间、认证标识及直达安装链接，显著降低信息获取成本。

显著优点

• 实时权威：直接对接官方 API，数据新鲜度高，避免第三方镜像延迟
• 安全导向：独有的认证技能筛选机制，满足企业级安全合规需求
• 多维排序：下载量、收藏数、时间、安全状态四维度交叉筛选
• 零配置使用：纯 HTTP GET 调用，无需鉴权，跨平台兼容（macOS/Linux/Windows）
• 结构化输出：自动表格生成与链接嵌入，减少手动整理工作

潜在缺点与局限性

• 只读权限：仅支持查询，无法执行安装、评分或反馈等交互操作
• API 依赖：功能完全依赖外部服务可用性，无离线缓存或降级方案
• 搜索精度：全文搜索未说明是否支持布尔逻辑或模糊匹配，复杂查询可能受限
• 地域隐私：API 调用会暴露查询 IP，敏感行业用户需注意
• 认证盲区：安全认证为自动化筛查，可能存在误报或漏报，不含人工审计背书

适合人群

• ClawHub 新用户：快速建立对技能生态的认知
• 企业管理员：批量筛选安全认证技能，制定内部白名单
• 开发者与研究者：分析热门趋势、追踪竞品动态、研究下架技能历史
• 内容创作者：获取结构化数据用于榜单制作或技术博客

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| API 服务中断 | 第三方服务故障导致数据不可用 | 关键决策前调用 `/api/health` 验证状态 |

| 数据时效误差 | `generated_at` 与实际查询存在时间差 | 注意响应中的时间戳，紧急场景需二次确认 |

| 认证技能风险 | 自动化筛查非绝对安全保证 | 高敏感环境建议叠加人工代码审计 |

| 隐私泄露 | 搜索关键词可能被服务端记录 | 避免在搜索词中包含敏感内部项目代号 |

核心用法

Top ClawHub Skills 是一款面向 ClawHub 技能市场的数据查询与发现工具，通过集成官方及第三方 API 服务，为用户提供实时的技能生态洞察。该技能支持八大核心查询场景：获取下载量 Top N 的热门技能、按星级排序的口碑技能、最新上架的新发技能、通过安全认证的可信技能列表、已下架技能的历史存档、关键词全文搜索、平台整体统计数据以及 API 健康状态检测。

用户可通过自然语言发起查询请求，技能会自动调用对应端点（如 /api/top-downloads、/api/search 等），并将返回的 JSON 数据格式化为易读的 Markdown 表格，包含技能名称、作者、下载量（自动转换为 K/M 单位）、星级、安全认证状态及直达安装链接。特别地，安全认证技能会标注"Certified"标识，并附带说明其通过了超越 VirusTotal 的多层自动化安全筛查。

显著优点

数据维度丰富：覆盖 popularity（下载量）、quality（星级）、freshness（新发时间）、trust（安全认证）四大评估维度，满足多样化选型需求。

格式化输出友好：自动将原始数据转换为带超链接的表格，下载量智能缩写，时间显示相对化（如"2 days ago"），大幅降低信息获取成本。

安全导向设计：单独提供认证技能筛选端点，并在展示时强化安全 messaging，帮助用户规避潜在风险技能。

历史可追溯：支持查询已删除技能，保留 deleted_at 时间戳，对于研究技能生态变迁或寻找替代方案具有独特价值。

零代码依赖：作为纯文档型技能，本身不含可执行代码，完全依靠 LLM 的函数调用能力实现数据获取与呈现，架构简洁透明。

潜在缺点与局限性

外部 API 依赖：核心数据来源于第三方服务（topclawhubskills.com），非 ClawHub 官方直连，存在服务可用性、数据时效性与官方不一致的风险。API 若变更或下线，技能将失效。

安全认证权威性存疑：技能获取的"安全认证"标签来自第三方 API 的评估体系，可能与 ClawHub 官方安全标准存在差异，用户需以官方信息为准。

功能边界受限：仅支持数据查询与展示，无法直接执行技能安装、对比分析或个性化推荐等深度操作。

无实时更新机制：依赖用户主动发起查询，不具备推送通知或监控变更的能力。

适合的目标群体

• ClawHub 新用户：快速了解平台热门技能，建立初始工具箱
• 效率工具猎手：定期追踪新发技能，抢占早期使用红利
• 企业/团队管理员：筛选安全认证技能，制定团队白名单策略
• 技能开发者：研究竞品表现，分析市场趋势与用户需求
• 安全敏感型用户：优先使用认证技能，降低供应链风险

使用风险说明

服务稳定性风险：第三方 API 无 SLA 保障，高峰期可能出现延迟或超时，建议关键决策时交叉验证官方渠道。

数据准确性风险：API 缓存策略、统计口径可能导致数据与 ClawHub 实时状态存在小时级偏差，星级/下载量为时点快照。

隐私与合规考量：虽然技能本身不收集用户数据，但通过该工具访问外部 API 时，查询关键词、IP 等信息可能被第三方服务记录，敏感行业用户需注意。

技能生态变化：已删除技能的存档信息仅作参考，部分技能可能因违规、作者主动下架等原因消失，链接可能失效。

来源可信度：发布者为个人开发者（sdrabent, T3 等级），非 ClawHub 官方出品，长期维护承诺与功能迭代存在不确定性。