feishu-cli-data

Manage Feishu spreadsheets and Bitable tables, fields, records, views, and dashboards via CLI.

1.4k|142|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-cli-data
Source: https://github.com/riba2534/feishu-cli/tree/main/skills/feishu-cli-data
Command: npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-data

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Working with Feishu spreadsheets and Bitable (multi-dimensional tables) through raw APIs requires handling tokens, identity modes, filter DSLs, and dozens of endpoints. This Skill routes AI agents to the correct feishu-cli commands for Sheet and Bitable operations so structured data tasks complete without manual API wrangling.

Core Features & Use Cases

  • Sheet operations: Read/write cells, create filter views with conditions, set dropdown validations, manage floating images, and apply batch styles.
  • Bitable operations: Create bases, tables, fields, and records; configure views (filter/sort/group), roles, collaborators, dashboards, forms, workflows, and data aggregation queries.
  • Identity control: Use --as bot|user|auto to run unattended cron jobs with App Tokens or act as a logged-in user.
  • Use Case: Given a /base/bascnxxx URL, create a select field, batch-insert records, then build a filtered kanban view — all via feishu-cli bitable commands with --base-token.

Quick Start

Ask the AI to use the feishu-cli-data skill to list all records from your Bitable table by providing the base token and table ID.

Frequently Asked Questions about feishu-cli-data

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and write Feishu spreadsheet cells from the command line?

Use feishu-cli sheet read and sheet write with the spreadsheet token and a range like Sheet1!A1:C10. Writes accept JSON 2D arrays, and V3 rich-text variants (read-rich, write-rich) support formatted content.

How do I create a field in a Feishu Bitable table?

Run feishu-cli bitable field create with --base-token, --table-id, and a --config JSON whose top level contains name, type, and type-specific attributes. Do not wrap the body in an extra field or property object, or the v3 API rejects it.

Should I use sheet or bitable commands for a Feishu URL?

Check the URL path: /sheets/ means a spreadsheet handled by feishu-cli sheet with spreadsheet token and sheet ID, while /base/ means Bitable handled by feishu-cli bitable with --base-token. The two command sets are not interchangeable.

Can feishu-cli bitable run unattended in cron jobs?

Yes, pass --as bot with FEISHU_APP_ID and FEISHU_APP_SECRET environment variables so commands use the App Token without login. The bot must be added as a collaborator on the base or you will get permission error 91403.

Why does my Bitable record filter return zero results?

Filter values must match field types: select fields need option-name arrays even for single select, dates use ExactDate or Today keywords, and person fields need object arrays with id. Also note record search requires both --keyword and --search-field.

What are the batch limits for Bitable record operations?

record batch-create and batch-update accept up to 200 records per call, while batch-delete accepts up to 500. Attachment upload and download operations handle at most 50 files per invocation.