Publish Api

核心用法

本技能为纯文档型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技能使用，完善请求构造与数据处理链路。

核心用法

API Skill 是一款纯文档型技术参考工具，覆盖 147个主流服务（Stripe、OpenAI、Notion、Anthropic、Twilio 等）的 REST API 文档。用户通过自然语言查询特定 API 的集成方式，Skill 会返回对应的认证模式、端点结构、curl 示例、分页策略及常见错误规避指南。

使用路径：
1. 通过 API Categories 表格定位服务所属文件（如 OpenAI 在 apis/ai-ml.md）
2. 阅读文件顶部的索引表，获取目标 API 的行号范围
3. 精准读取对应章节（约50-100行），获取完整参考信息

文档结构：每个 API 包含：认证方式（Bearer Token、API Key、OAuth 2.0）、核心端点（含 HTTP 方法和 curl 示例）、Rate Limit 头信息（X-RateLimit-Remaining）、分页模式（cursor/offset/time-based）、幂等性键使用建议。

显著优点

• 零执行风险：纯 Markdown 文档（T-MD 类型），无可执行代码，Agent 不会运行任何命令
• 覆盖面极广：17个类别、147个服务，从 AI/ML 到支付、从 CRM 到实时通信一网打尽
• 实用导向：聚焦"常见错误"（如 POST 请求漏写 Content-Type、API Key 放 URL 参数），直接减少开发踩坑
• 高效检索：索引+行号跳转机制，避免全文检索的低效
• 多语言偏好：支持在 ~/api/preferences.md 中设置首选示例语言

潜在缺点与局限性

• T3 来源可信度：来自 clawic.com 社区市场，无企业/组织背书，需用户自行验证文档准确性
• 文档时效性依赖人工维护：API 服务商更新端点或认证方式时，依赖 Skill 维护者同步，建议用户对照官方文档二次确认
• 无交互式调试：仅提供参考文档，不包含 API 调用测试、响应格式化等交互功能
• curl 示例需手动适配：示例中的 $API_KEY 等占位符需用户自行替换，无自动化凭证注入

适合人群

• 后端开发者：快速集成第三方服务，查询认证和分页细节
• 全栈工程师：在构建 MVP 时需要同时对接支付（Stripe）、AI（OpenAI）、通信（Twilio）等多类 API
• 技术写作者：参考 API 文档结构，学习如何编写清晰的端点说明
• DevOps/平台工程师：查阅开发者工具类 API（Vercel、Cloudflare、GitHub Actions 等）的配置方式

常规风险

| 风险类型 | 等级 | 说明 |

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

| 代码执行风险 | 无 | 纯文档，无可执行文件 |

| 数据外泄风险 | 极低 | 无网络调用代码，但用户复制 curl 命令时可能误用真实 API Key |

| 凭证泄露风险 | 低 | Skill 建议环境变量管理（如 `STRIPE_PROD_API_KEY`），但执行层面依赖用户自律 |

| 信息过时风险 | 中 | 147个服务的 API 变动频繁，文档可能与官方最新版存在滞后 |

核心安全建议：使用 Skill 提供的 curl 示例时，务必通过环境变量注入 API Key，禁止直接粘贴密钥到命令行历史或日志中。