核心用法
Kit (原 ConvertKit) Skill 是一个邮件营销自动化 API 网关，通过 Maton 平台提供托管式 OAuth 认证，让用户无需处理复杂的令牌刷新和权限管理即可调用 Kit API 的全部功能。
主要功能模块：
1. 订阅者管理 (Subscribers) - 完整的 CRUD 操作，支持状态筛选（active/inactive/bounced 等）、自定义字段、创建时间过滤，分页查询最高 1000 条/页
2. 标签系统 (Tags) - 创建/更新/删除标签，为订阅者打标签或移除标签，支持按标签查询订阅者列表
3. 表单与落地页 (Forms) - 管理嵌入表单和托管落地页，获取嵌入代码，向表单添加订阅者
4. 邮件序列 (Sequences) - 自动化邮件序列管理，添加订阅者到序列，查询序列成员
5. 邮件群发 (Broadcasts) - 单封邮件广播创建和管理，支持模板选择
6. 高级功能 - 自定义字段、购买记录、邮件模板、Webhook 事件订阅
认证方式：通过 MATON_API_KEY 环境变量 + Bearer Token，OAuth 连接在 ctrl.maton.ai 集中管理，支持多连接切换。
技术特点：
- 网关代理至
api.kit.com，自动注入 OAuth 令牌 - 支持 V4 API（V3 已废弃）
- 游标分页机制
- 批量操作异步处理
显著优点
- 零 OAuth 维护成本：Maton 托管令牌生命周期，包括刷新和失效处理
- 完整功能覆盖：涵盖 Kit 官方 API 的所有核心端点
- 多连接支持：可在同一账户管理多个 Kit 工作区
- 多语言示例：提供 Python、JavaScript、Bash 完整代码
- 详细错误码：400/401/403/429 等状态码有明确含义说明
潜在局限
- 依赖第三方网关：请求需经过
gateway.maton.ai，非直连 Kit，存在额外延迟和单点依赖 - 批量限制：超过 100 项的操作转为异步处理，需额外轮询确认
- 环境变量依赖：
MATON_API_KEY必须在 shell 环境中正确设置，文档特别指出 curl 管道中变量扩展可能失败 - 无实时数据推送：Webhook 需自行配置接收端，Skill 本身不提供事件推送
- API 版本锁定：仅支持 V4，若 Kit 发布 V5 需等待网关更新
适合人群
- 创作者经济从业者（博主、Newsletter 作者、课程卖家）使用 Kit 进行邮件营销
- 需要自动化订阅者管理、标签分群、序列营销的技术运营人员
- 希望将 Kit 数据与其他系统集成（CRM、数据分析）的开发者
- 需要管理多个 Kit 账户的代理机构或多品牌运营团队
常规风险
- 密钥泄露风险：
MATON_API_KEY若泄露，攻击者可访问所有已授权的 Kit 数据；应避免硬编码，使用环境变量或密钥管理服务 - OAuth 权限范围：连接创建时需确认 Kit 授权范围，过度授权可能导致数据暴露
- 误操作不可逆：删除标签、自定义字段等操作返回 204 无内容，无软删除机制
- 速率限制：Kit API 有请求频率限制，高频调用可能触发 429 错误
- 网关可用性：Maton 网关故障将中断所有 Kit 操作，需关注服务状态