核心用法
本技能为纯文档型API参考库，覆盖AI/ML、支付、通信、CRM、开发者工具等16个领域的147个服务。采用分类索引架构，每个领域独立成文件（如apis/ai-ml.md、apis/payments.md），内含多个服务的详细文档。
使用流程：
1. 通过API分类表定位服务所属文件
2. 读取文件顶部的索引表（含API名称与行号）
3. 按行号精确跳转至目标API章节（通常50-100行）
配套文档：
setup.md— 使用指南auth.md— 认证模式汇总pagination.md— 分页策略resilience.md— 错误处理与重试webhooks.md— Webhook集成模式
显著优点
- 覆盖广度：147个服务横跨16个垂直领域，从OpenAI、Stripe到Notion、Shopify一应俱全
- 结构化检索：索引+行号跳转机制，避免全文检索的低效
- 实战导向：每个API包含curl示例、认证细节、限流头信息、常见gotcha
- 维护活跃：版本1.3.1，持续同步各服务商API变更
局限与风险
- 文档-only：不提供运行时SDK封装，用户需自行管理请求构造与错误处理
- 密钥管理：所有API调用需用户自备并保管密钥，技能本身无密钥托管功能
- 时效依赖：第三方API迭代快，文档可能存在滞后（需
clawhub sync更新） - 无沙箱验证：示例未经实时测试，生产环境需自行验证
适合人群
- 需要快速查阅多服务商API规范的集成开发者
- 构建MVP或原型、不愿逐个翻阅官方文档的团队
- 运维/SRE人员排查第三方API异常时的速查手册
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | 示例中的占位符需替换为真实密钥，避免硬编码入库 |
| 限流触发 | 多数服务默认10-25条/页，未处理`X-RateLimit-Remaining`将导致429封禁 |
| 幂等性缺失 | 支付类操作未带Idempotency-Key可能造成重复扣款 |
| 误判成功 | 部分API返回HTTP 200但体内含错误码，需解析响应结构 |
建议配合http、webhook、json技能使用，完善请求构造与数据处理链路。