用途:通过终端 curl 直接调用 Airtable REST API,完成 Bases、Tables 与 Records 的读写操作,不依赖 MCP 服务器、OAuth 流程或 Python SDK。
主要能力:列出令牌可见的 bases 与表结构;查询、过滤、排序记录;创建、批量创建(每次最多 10 条)、更新、upsert 与删除记录;支持分页遍历、按视图读取、指定字段与最大条数。字段写入支持文本、长文本、数字、复选框、单选、多选、日期、日期时间、URL/邮箱/电话、附件、关联记录与用户等类型。
使用方式:先在 https://airtable.com/create/tokens 创建 PAT,至少授予 data.records:read、data.records:write、schema.bases:read 权限,并把目标 base 加入令牌的 Access 列表。将令牌写入 ${HERMES_HOME:-~/.hermes}/.env,键名为 AIRTABLE_API_KEY。端点 https://api.airtable.com/v0,认证头 Authorization: Bearer $AIRTABLE_API_KEY。请求用 JSON,建议用 python -m json.tool 美化输出。filterByFormula 必须 URL 编码,可用 Python 标准库 urllib.parse 处理,方括号参数需编码为 %5B/%5D。
适用场景:在智能体或脚本中做记录同步、幂等 upsert、按条件批量更新与查询等终端化操作。建议先读取 schema 确认字段名与主字段,再执行写入;更新优先用 PATCH,删除前先过滤并确认数量,因为 API 删除不可撤销。
限制:旧版 API key 已于 2024 年 2 月弃用,只能用 PAT 或 OAuth 令牌;PAT 按 base 授权,访问未授权 base 会返回 403。速率限制为每 base 每秒 5 次请求,超出返回 429 并需退避,批量接口每次最多 10 条,列表接口每页最多 100 条,需用 offset 循环翻页。单选字段写入不存在的选项会报 INVALID_MULTIPLE_CHOICE_OPTIONS,需传 typecast: true 自动创建;响应会省略空字段。其他细节如价格、平台支持等资料暂未提供。