Feishu Bitable

This lets you work with Feishu's Bitable (multi-dimensional tables) through their API without manually wrangling auth or pagination. It handles 15 field types including formulas, user references, and bidirectional links, plus batch operations for records, fields, and views. The skill includes a shared token script that caches credentials and auto-refreshes when expired. One thing to know: tables created via API are bot-only by default, so you need to explicitly add collaborators or nobody else will see your data. Useful if you're building workflows that treat Feishu tables like a lightweight database, especially for Chinese teams already in that ecosystem.

skills.sh installs: 864
GitHub stars: 64
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add alextangson/feishu_skills --skill feishu-bitable --agent claude-code

Installs into .claude/skills of the current project.

Files

飞书多维表格

通过 Bitable API 操作数据、字段、视图和权限。

Base URL: https://open.feishu.cn/open-apis/bitable/v1

认证与 Token 获取

从 feishu_skills 根目录执行共享脚本：

TOKEN="$(./scripts/get_feishu_token.sh)"

请求头统一使用 Authorization: Bearer ${TOKEN}。

如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：

TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

环境变量:

FEISHU_APP_ID
FEISHU_APP_SECRET

本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）

关键参数:

app_token: 多维表格 URL 中 /base/ 后的字符串
table_id: 调用列表 API 获取

记录操作

API	端点	说明
新增单条	`POST /apps/{app_token}/tables/{table_id}/records`	-
批量新增	`POST .../records/batch_create`	最多 500 条，支持 Upsert
更新	`PUT .../records/{record_id}`	-
批量更新	`POST .../records/batch_update`	最多 500 条
批量删除	`POST .../records/batch_delete`	最多 500 条
查询	`POST .../records/search`	支持 filter/sort/分页