核心用法
API skill 是一份面向开发者的离线API参考文档库,覆盖147个第三方服务的REST API集成信息。用户询问API集成时,skill 会按以下流程响应:
1. 定位服务:通过分类表(AI/ML、支付、通信、数据库等17个类别)找到目标API所属文件
2. 索引导航:先读取文件顶部的索引表,再跳转到具体API章节(每节50-100行)
3. 输出参考:提供认证方式、curl示例端点、速率限制、分页模式及常见陷阱
关键文件包括 setup.md(使用指南)、auth.md(认证模式)、pagination.md(分页模式)、resilience.md(错误处理)、webhooks.md(Webhook模式)。
显著优点
- 覆盖面极广:147个服务横跨AI、支付、通信、CRM、营销、DevOps、数据库、媒体等全场景
- 结构化查询:分类索引+行号跳转设计,避免全文扫描,响应高效
- 实战导向:不仅罗列端点,更强调
Content-Type头、幂等键、429退避等工程细节 - 零配置即用:纯文档型skill,无需API密钥即可查询参考信息
潜在缺点与局限
- 文档静态性:API版本迭代快,文档可能存在滞后风险(需
clawhub sync更新) - 无执行能力:仅提供参考示例,用户需自行管理密钥、构造请求、处理响应
- 深度有限:每个API压缩在百行内,复杂场景(如OAuth2全流程、Webhook验证)需配合官方文档
- 语言偏好:示例以curl为主,用户需在
~/api/preferences.md配置偏好的编程语言
适合人群
- 快速验证某API是否支持特定功能("Stripe是否支持退款查询?")
- 需要对比同类服务接口差异(对比SendGrid vs Resend的认证头)
- 排查集成中的常见错误(429处理、分页参数缺失)
- 新成员上手技术栈时了解API生态全景
常规风险
- 密钥泄露风险:文档示例含占位符密钥,用户复制粘贴时可能误用真实密钥到不安全位置
- 端点变更:外部服务API版本升级可能导致示例失效,生产环境需以官方文档为准
- 速率限制误判:文档中的rate limit值可能过期,实际以响应头
X-RateLimit-Remaining为准 - 合规盲区:支付、医疗等敏感领域API需额外合规审查,本skill不覆盖合规建议