mcpField
F
feishu-cli-data

feishu-cli-data

github.com/riba2534Data & databases1.4k142 installsUpdated 3w ago
Repository

About feishu-cli-data

A workflow skill for working with Feishu Sheets and Bitable. It routes tasks to the relevant procedures and sets rules for URL recognition, identity selection, write previews, and image cells.

Key features

  1. 01Routes Sheet and Bitable tasks
  2. 02Covers spreadsheet reads, writes, and styling
  3. 03Manages fields, records, and views
  4. 04Supports dry-run for write operations
  5. 05Specifies native image cell workflows

Use cases

  1. 01Choose a workflow based on a Feishu URL
  2. 02Validate field types before batch Bitable edits
  3. 03Preview writes before applying them
  4. 04Write images to native Sheet image cells

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-data

After installing, type/feishu-cli-datain Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
evals.json
evals/fixtures/
select-field.json
references/workflows/bitable/
workflow.md
references/workflows/sheet/
workflow.md
references/workflows/sheet/references/
basic-commands.md

Details

From the project README

飞书表格与多维表格

加载工作流后，将其中 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

意图读取文件
Sheet 创建、读写、样式、筛选视图、下拉、图片、导入导出references/workflows/sheet/workflow.md
Bitable/Base 表、字段、记录、视图、权限、表单、工作流references/workflows/bitable/workflow.md

执行规则

  1. 先识别 URL：/sheets/ 是 Sheet，/base/ 是 Bitable。
  2. Sheet 使用 spreadsheet token + sheet ID；Bitable 统一使用 --base-token，身份通过 --as bot|user|auto 控制。
  3. 写操作先用 --dry-run（命令支持时），批量操作先用少量记录验证字段类型。
  4. 不要把 Bitable field create 的 body 额外包进 field 对象；直接使用命令帮助要求的字段 JSON。
  5. Sheet 写入单元格图片规则：单个图片使用 sheet image write-image <spreadsheet_token> <sheet_id> --range <cell> --image <path|url>；批量图片统一使用 sheet image write-batch <spreadsheet_token> <sheet_id> --manifest <file|-|json>。严禁用 V2 sheet write 写 =IMAGE(...) 字符串公式，也严禁在 sheet import-md 中使用 Markdown 图片语法 ![]()，两者均无法生成可渲染的原生图片单元格。命令统一支持本地路径与 HTTPS URL，写入原生图片单元格后均自动通过 V3 read-rich 回读验证 image_token。

Comments

Markdown supported