Communityコーディング&開発github.com

D1DX/airtable-skill

AIエージェント向けAirtableスキル — MCP、REST API、内部Web API、Omni AI、スクリプティング、フォーミュラ、Webhook、自動化、そして注意点。

airtable-skill とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がAirtableと効果的に連携するための包括的な知識ベースです。MCP(Model Context Protocol)による直接操作、REST API経由のデータアクセス、Airtable内部のWeb APIやOmni AI、さらにスクリプティング、フォーミュラ、Webhook、自動化機能の使い方を網羅しています。各プラットフォームごとの具体的なコード例やCLIコマンド、環境変数設定が含まれており、実際の開発ワークフローに即座に活用できます。また、よくある落とし穴(gotchas)も明示されているため、初心者から上級者までトラブルを回避しながらAirtableの機能を最大限に引き出せます。開発者ツールとの統合に重点を置き、AIエージェントが自律的にAirtableを操作・管理するための実践的なリファレンスを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add D1DX/airtable-skill

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

airtable-skill は何をしますか?

AIエージェント向けAirtableスキル — MCP、REST API、内部Web API、Omni AI、スクリプティング、フォーミュラ、Webhook、自動化、そして注意点。

概要

このスキルは、AIエージェントがAirtableと連携するための知識と実装例を提供します。以下の機能に対応しています:

  • MCP (Model Context Protocol) を介した直接操作
  • REST API を使ったデータアクセス
  • 内部Web API の活用
  • Omni AI との統合
  • スクリプティング と フォーミュラ のベストプラクティス
  • Webhook と 自動化 の設定方法
  • よくある 注意点 とトラブルシューティング

対応プラットフォーム

  • Claude Code
  • Cursor
  • Codex
  • その他MCP対応AIエージェント

基本設定

環境変数

export AIRTABLE_API_KEY="your_api_key_here"
export AIRTABLE_BASE_ID="your_base_id"
export AIRTABLE_TABLE_NAME="your_table_name"

MCP設定例

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["-y", "@airtable/mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "${AIRTABLE_API_KEY}"
      }
    }
  }
}

使用例

レコードの取得 (REST API)

const response = await fetch(`https://api.airtable.com/v0/${baseId}/${tableName}`, {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});
const data = await response.json();

スクリプト例(Airtable Scripting)

let table = base.getTable('Your Table');
let records = await table.selectRecordsAsync({fields: ['Name', 'Status']});
for (let record of records.records) {
  console.log(record.getCellValue('Name'));
}

注意点

  • APIレート制限に注意:1秒あたり5リクエストまで
  • フォーミュラはAirtableの方言に従うこと
  • Webhookのペイロードサイズは10MBまで
  • 自動化スクリプトは1回の実行で30秒のタイムアウトあり

参考リンク

関連スキル