用途
Airtable 技能用于通过 Airtable Web API 构建集成与自动化,操作对象包括 bases、tables、records、fields、views、webhooks 与 OAuth。当任务涉及读写 Airtable 数据、自动化 Airtable 库或与 Airtable 进行 REST API 集成时适用。
认证
技能提供两种认证方式。其一为 Personal Access Token(最简单),在 https://airtable.com/create/tokens 生成,可限定到特定 base 与权限,使用时设置环境变量:export AIRTABLE_TOKEN="pat..."。其二为 OAuth 2.0,面向多用户应用,在 https://airtable.com/create/oauth 注册,支持 PKCE 用于公共客户端。技能给出 OAuth 2.0 with PKCE 的 Python 示例,包含生成带 PKCE challenge 的授权 URL(start_oauth),以及用授权码换取访问令牌(exchange_token),返回 access_token、refresh_token、expires_in。
主要能力
记录操作:技能提供 CRUD 的 Python 示例,包括 list_records(支持 view、filterByFormula、fields、sort 参数,并按 offset 自动分页)、create_records(每次最多 10 条,支持 typecast)、update_records(PATCH 局部更新)、delete_records(按 ID 删除)。API 基址为 https://api.airtable.com/v0。
公式筛选:技能列出常用公式模式,例如精确匹配 {Status} = 'Active'、多条件 AND({Priority} = 'High', {Status} != 'Done')、日期筛选 IS_BEFORE({Due Date}, DATEADD(TODAY(), 7, 'days'))、文本搜索 FIND('search term', LOWER({Name}))、关联记录检查 {Project} != ''、数值范围、空值与非空检查等,用于服务端筛选。
Schema 操作:get_base_schema 用于读取 base 中所有 tables、fields 与 views;create_field 用于向表添加字段,支持 singleLineText、multilineText、number、percent、currency、singleSelect、multipleSelects、date、checkbox 等类型及类型专属 options。
Webhooks:create_webhook 用于注册记录变更的 webhook(可指定整个 base 或特定 table),list_webhook_payloads 用于以轮询方式拉取 payload,支持 cursor 分页。
使用方式与限制
技能给出的实现要点包括:始终对列表请求分页,不要假设一次响应能容纳所有记录;使用 filterByFormula 在服务端减少数据量,而不是全部拉取后在客户端筛选;批量操作按 10 条一组并加入约 200ms 延迟;导入时若字段值需要转换可使用 typecast: true;附件字段需要 URL,需先上传到托管服务再传入 URL;链接记录字段接受记录 ID 而非显示值;公式与 rollup 字段只读,不能通过 API 写入;webhook payload 不包含完整记录数据,只表示发生了变更,需要再拉取详情。
速率限制方面:每个 base 每秒 5 次请求;创建/更新/删除每次最多 10 条记录;列表每页最多 100 条记录(用 offset 分页);遇到 429 响应需实现退避。速率限制按 base 计算而非按 token,同一 base 上的多个集成共享该限制。
字段类型参考
技能提供字段类型与 API 名称对照:Single line text(singleLineText)、Long text(multilineText,支持 markdown)、Number(number,整数或小数)、Single select(singleSelect)、Multiple select(multipleSelects,数组)、Date(date,ISO 8601 字符串)、Checkbox(checkbox,布尔)、URL(url)、Email(email)、Phone(phoneNumber)、Currency(currency)、Percent(percent,以百分比显示)、Attachment(multipleAttachments,带 URL 的文件对象数组)、Linked record(multipleRecordLinks,记录 ID 数组)、Lookup(multipleLookupValues,只读)、Rollup(rollup,只读聚合)、Formula(formula,只读计算值)。
适用场景
适用于需要以编程方式读写 Airtable 数据、构建多用户 OAuth 集成、按公式筛选记录、读取或修改 base 结构、以及通过 webhook 监听变更并同步数据的开发任务。
暂未提供
关于收费、价格、平台支持范围、具体效果或性能指标,资料中暂未提供。