核心用法
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` 与实际查询存在时间差 | 注意响应中的时间戳，紧急场景需二次确认 |
| 认证技能风险 | 自动化筛查非绝对安全保证 | 高敏感环境建议叠加人工代码审计 |
| 隐私泄露 | 搜索关键词可能被服务端记录 | 避免在搜索词中包含敏感内部项目代号 |