К основному содержанию
скилл CX Codex

feishu — скилл для Claude Code: возможности и установка

Скилл для Claude Code читает и меняет документы Feishu через REST API. Запускается по запросам о документах, таблицах, календаре или сообщениях Feishu.

Apache-2.0 104 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill feishu -a claude-code
Открыть на GitHub

Что делает feishu

Скилл обращается к Feishu Open Platform REST API, чтобы читать и создавать документы, работать с таблицами и записями Base, просматривать файлы Drive, управлять событиями календаря и задачами, читать wiki и отправлять сообщения. Например, он извлекает текст документа или добавляет строки в таблицу.

Запросы выполняются от имени пользователя и ограничены его доступом и выданными при подключении разрешениями. Для работы нужны curl, jq и OAuth-токен пользователя в переменной $FEISHU_TOKEN; без токена запросы к API не пройдут. Перед остальными действиями скилл проверяет авторизацию, а ответы API — код результата.

Какие задачи решает

  • прочитать текст документа Feishu
  • добавить строки в таблицу
  • найти файлы в Drive
  • создать событие календаря
  • отправить сообщение Feishu

Примеры запросов агенту

  • Прочитай документ по этой ссылке Feishu и кратко перескажи его.
  • Добавь эти строки в таблицу Feishu.
  • Найди мои встречи в календаре Feishu на завтра.

Как установить feishu

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill feishu -a claude-code

2Вручную: положить файлы

~/.claude/skills/feishu/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/feishu/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о feishu

Как установить feishu в Claude Code?

Выполни npx skills add AceDataCloud/Skills --skill feishu -a claude-code. Скилл появится в ~/.claude/skills/feishu/SKILL.md.

Что делает feishu?

Скилл читает и изменяет документы, таблицы и записи Base, работает с файлами Drive, календарём и задачами, читает wiki и отправляет сообщения через Feishu Open Platform REST API.

Что нужно для работы feishu?

Нужны curl, jq и OAuth-токен пользователя в $FEISHU_TOKEN. Доступ к данным зависит от разрешений, выданных при подключении Feishu.

Исходный текст

SKILL.md · Apache-2.0
---
name: feishu
description: Read and write Feishu (飞书) docs, sheets, Base (bitable), Drive files, calendar events, tasks, wiki, and IM messages via the Feishu Open Platform REST API. Use when the user mentions 飞书 / Feishu / Lark, a Feishu document or sheet link, their Feishu calendar, or wants to send a Feishu message.
when_to_use: |
  Trigger when the user wants to read or write something in Feishu (飞书) —
  summarize / create / edit a doc, read or append to a spreadsheet, query
  or add Base (bitable) records, browse Drive files, look at or create
  calendar events, manage tasks, read wiki nodes, or send an IM message.
connections: [feishu]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

We drive the [Feishu Open Platform API](https://open.feishu.cn/document)
with `curl + jq`. The user's OAuth `user_access_token` is in
`$FEISHU_TOKEN`; every call sends it as `Authorization: Bearer
$FEISHU_TOKEN`. All endpoints live under `https://open.feishu.cn/open-apis`.

Calls run **in the user's context** (their docs, calendar, messages) — only
data the user can access and only the scopes they granted at connect time
(docs / sheets / base / drive / calendar / IM / wiki / task / contacts).

## Response shape & error handling

Every Feishu response is `{"code": 0, "msg": "success", "data": {…}}`.
**`code == 0` means success**; any non-zero `code` is an error — surface
`msg` to the user. Always check it:

```sh
resp=$(curl -sS … )
echo "$resp" | jq 'if .code == 0 then .data else error("Feishu \(.code): \(.msg)") end'
```

Common error codes:

| code | meaning | what to do |
|---|---|---|
| `99991663` / `99991668` | access token invalid / expired | tell the user to reconnect Feishu in 连接 settings |
| `99991661` | no permission (scope not granted) | the connect-time scope is missing — reconnect and grant it |
| `1254xxx` | resource not found / no access | the user can't see that doc / sheet / app — double-check the token/id |

## Recipes

### Verify auth (always run first)

```sh
curl -sS https://open.feishu.cn/open-apis/authen/v1/user_info \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then {name: .data.name, open_id: .data.open_id, email: .data.email} else . end'
```

### Docs (docx)

A Feishu doc URL looks like `https://…feishu.cn/docx/<document_id>`. The
`document_id` is the last path segment.

Read a document's plain text:

```sh
curl -sS "https://open.feishu.cn/open-apis/docx/v1/documents/DOCUMENT_ID/raw_content" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq -r 'if .code == 0 then .data.content else "ERR \(.code): \(.msg)" end'
```

List a document's blocks (structured content):

```sh
curl -sS "https://open.feishu.cn/open-apis/docx/v1/documents/DOCUMENT_ID/blocks?page_size=500" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.items[] | {block_id, block_type}] else . end'
```

Create a new empty document (optionally inside a folder):

```sh
curl -sS -X POST "https://open.feishu.cn/open-apis/docx/v1/documents" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc --arg title "会议纪要 2026-07-01" '{title: $title}')" \
  | jq 'if .code == 0 then {document_id: .data.document.document_id} else . end'
```

Append a text block to a document (insert at the end of the document body —
`DOCUMENT_ID` is also the root block id):

```sh
curl -sS -X POST "https://open.feishu.cn/open-apis/docx/v1/documents/DOCUMENT_ID/blocks/DOCUMENT_ID/children" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc --arg text "由助手追加的一段内容。" '
    {children: [{block_type: 2, text: {elements: [{text_run: {content: $text}}]}}]}')" \
  | jq 'if .code == 0 then "appended" else . end'
```

### Spreadsheets (sheets v2)

A sheet URL looks like `https://…feishu.cn/sheets/<spreadsheet_token>`.
A range is `<sheetId>!<A1:range>`, e.g. `abc123!A1:D10`. List sheet ids via
the metainfo endpoint first if you don't have one.

Read a range:

```sh
curl -sS "https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/SPREADSHEET_TOKEN/values/RANGE" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then .data.valueRange.values else . end'
```

Append rows after the last non-empty row:

```sh
curl -sS -X POST "https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/SPREADSHEET_TOKEN/values_append" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc '{valueRange: {range: "SHEET_ID!A1:B1", values: [["张三", 100], ["李四", 200]]}}')" \
  | jq 'if .code == 0 then .data.updates else . end'
```

### Base / 多维表格 (bitable v1)

A Base URL looks like `https://…feishu.cn/base/<app_token>`. Get `table_id`
from `…/bitable/v1/apps/APP_TOKEN/tables`.

List records:

```sh
curl -sS "https://open.feishu.cn/open-apis/bitable/v1/apps/APP_TOKEN/tables/TABLE_ID/records?page_size=100" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.items[] | {record_id, fields}] else . end'
```

Create a record:

```sh
curl -sS -X POST "https://open.feishu.cn/open-apis/bitable/v1/apps/APP_TOKEN/tables/TABLE_ID/records" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc '{fields: {"标题": "新任务", "状态": "待办"}}')" \
  | jq 'if .code == 0 then {record_id: .data.record.record_id} else . end'
```

### Drive files

List files in a folder (omit `folder_token` for the root):

```sh
curl -sS "https://open.feishu.cn/open-apis/drive/v1/files?folder_token=FOLDER_TOKEN&page_size=50" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.files[] | {name, type, token, url}] else . end'
```

### Calendar (v4)

List the user's calendars (the primary one has `type: "primary"`):

```sh
curl -sS "https://open.feishu.cn/open-apis/calendar/v4/calendars?page_size=50" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.calendar_list[] | {calendar_id, summary, type}] else . end'
```

List events in a time window (epoch-seconds strings):

```sh
curl -sS "https://open.feishu.cn/open-apis/calendar/v4/calendars/CALENDAR_ID/events?start_time=1751299200&end_time=1751385600&page_size=100" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.items[] | {summary, start: .start_time, end: .end_time, event_id}] else . end'
```

Create an event (times are epoch-seconds strings):

```sh
curl -sS -X POST "https://open.feishu.cn/open-apis/calendar/v4/calendars/CALENDAR_ID/events" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc '{summary: "项目评审", start_time: {timestamp: "1751302800"}, end_time: {timestamp: "1751306400"}}')" \
  | jq 'if .code == 0 then {event_id: .data.event.event_id} else . end'
```

### Tasks (v2)

List the user's tasks:

```sh
curl -sS "https://open.feishu.cn/open-apis/task/v2/tasks?page_size=50" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.items[] | {summary, completed_at, task_guid: .guid}] else . end'
```

Create a task:

```sh
curl -sS -X POST "https://open.feishu.cn/open-apis/task/v2/tasks" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc '{summary: "准备周会材料"}')" \
  | jq 'if .code == 0 then {task_guid: .data.task.guid} else . end'
```

### Wiki

List wiki spaces, then nodes within a space:

```sh
curl -sS "https://open.feishu.cn/open-apis/wiki/v2/spaces?page_size=50" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.items[] | {space_id, name}] else . end'

curl -sS "https://open.feishu.cn/open-apis/wiki/v2/spaces/SPACE_ID/nodes?page_size=50" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  | jq 'if .code == 0 then [.data.items[] | {title, node_token, obj_type}] else . end'
```

### Send an IM message

Send to a user by `open_id` (use `receive_id_type=chat_id` for a group
chat). `content` must be a JSON **string**, so it's double-encoded:

```sh
curl -sS -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
  -H "Authorization: Bearer $FEISHU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -nc --arg rid "ou_xxx" --arg text "你好,这是助手发送的消息。" '
    {receive_id: $rid, msg_type: "text", content: ({text: $text} | tostring)}')" \
  | jq 'if .code == 0 then {message_id: .data.message_id} else . end'
```

## Notes

- Confirm destructive or outward-facing actions (sending a message,
  creating a calendar invite, posting to a shared doc) with the user
  before running them.
- Pagination: list endpoints return `data.page_token` / `data.has_more`;
  pass `page_token=…` to fetch the next page.
- When the user pastes a Feishu link, extract the token/id from the URL
  path rather than asking them for it.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Документы и офис» →
feishu-perm m1heng Управляет правами доступа к файлам и документам Feishu через единственный инструмент feishu_perm. Включается, когда упоминают шаринг, коллабораторов или разрешения. CX Codex +1 264установок feishu-wiki m1heng Скилл feishu-wiki управляет базой знаний Feishu через агента. Позволяет смотреть список пространств, строить дерево узлов и создавать новые страницы. CX Codex +1 464установок feishu-drive openclaw Управляет файлами, папками и комментариями в Feishu Drive. Ищет, просматривает и перемещает документы, читает и добавляет комментарии. CX Codex +1 ★ 395 001звёзд репо feishu-doc-scraper daymade Скилл feishu-doc-scraper для Claude Code извлекает документы Feishu/Lark в локальный Markdown. Запускается, когда нужно сохранить содержимое по ссылке или преобразовать экспортированный .docx. CX Codex +1 683установок mila fbalzan20-5mxo MCP-сервер mila даёт агенту инструменты для работы с документами, таблицами и презентациями. С его помощью можно создавать файлы и менять уже существующие. CX Codex +1 187установок feishu-channel-rules larksuite Скилл feishu-channel-rules задаёт правила ответов бота в каналах Lark и Feishu: короткий разговорный тон без лишней бюрократии, отказ от списков там, где хватит фразы, и учёт особенностей Lark Markdown. CX Codex +1 161установок

Из того же набора67

Весь набор →
vercel Скилл проверяет сборки, читает логи ошибок и управляет доменами на Vercel через REST API прямо из чата с агентом. CX Codex +1 176установок bilibili Скилл читает статистику статей в Bilibili и помогает публиковать новые через ваш аккаунт. Для работы нужны cookies входа. CX Codex +1 175установок figma Читает файлы Figma через REST API: дерево документа, отдельные ноды, рендер в PNG и комментарии. Запускается при переводе макета в код. CX Codex +1 175установок google-docs Позволяет читать, создавать и редактировать документы Google Docs через официальный REST API с помощью curl и jq. CX Codex +1 175установок personal-wechat Скилл personal-wechat подключает Claude Code к личному WeChat через собственный сервер Wisdom: агент читает чаты и контакты, а перед отправкой сообщений запрашивает подтверждение. CX Codex +1 162установок tencent-docs Скилл открывает агенту доступ к вашему аккаунту Tencent Docs через открытый API: создавать файлы, читать содержимое, искать по диску и разбирать папки. CX Codex +1 157установок acedatacloud Управляет аккаунтом AceDataCloud через management API: балансом, API-ключами, заказами и каталогом сервисов. Подключается к задачам через Claude Code и другие IDE. CX Codex +1 127установок webextrator Скилл webextrator для Claude Code извлекает содержимое веб-страниц через API AceDataCloud. Запускается для получения HTML после рендеринга или структурированных данных по URL. CX Codex +1 107установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой