核心用法
Airtable Skill 是 Maton 提供的 Airtable API 代理网关，通过托管 OAuth 简化身份认证流程，支持对 Airtable 的 Base、Table、Record 进行完整的增删改查操作。
关键能力：
- 连接管理：通过
ctrl.maton.ai创建、查看、删除 OAuth 连接，支持多账户切换 - 元数据操作：获取 Base 列表、表结构 Schema
- 数据操作：支持过滤公式、字段筛选、排序、分页等高级查询
- 批量处理：单次最多 100 条记录创建/更新，10 条记录删除
典型调用模式：
1. 获取 Maton API Key 并设置环境变量
2. 创建 Airtable 连接并完成浏览器 OAuth 授权
3. 通过 gateway.maton.ai/airtable/{path} 调用原生 API
4. 多连接场景使用 Maton-Connection 头指定目标账户
显著优点
- OAuth 免维护：无需自行管理 refresh token，Maton 自动处理令牌生命周期
- 原生 API 透传：完整支持 Airtable 官方 API 的所有功能，包括复杂过滤公式
- 多账户支持：可通过 Connection ID 切换不同 Airtable 账户
- 开发友好：提供 JavaScript/Python 示例，curl 命令即拿即用
潜在缺点与局限性
- 速率限制：10 req/sec 每账户，高并发场景需自行限流
- 批量上限：创建/更新 100 条、删除 10 条，超大数据集需分块处理
- 网关依赖：Maton 服务可用性直接影响功能，存在单点故障风险
- Shell 兼容性问题：curl 管道到 jq 时环境变量可能无法正确展开
- URL 编码注意点：含
[]的参数需curl -g禁用 glob 解析
适合人群
- 需要将 Airtable 作为后端数据库的低代码开发者
- 构建自动化工作流（如 CRM、内容管理、项目跟踪）的技术团队
- 希望避免 OAuth 实现复杂度的全栈工程师
常规风险
- 数据隐私：业务数据流经 Maton 网关，需评估第三方托管风险
- 令牌安全：Maton API Key 泄露将导致所有连接账户暴露
- 功能锁定：深度依赖后迁移至自托管 OAuth 需重新开发
- Airtable 限制：仍受 Airtable 官方 API 配额与功能边界约束（如附件处理、实时同步）