飞书全通道自动化

使用 lark-mcp 工具实现飞书平台的全面自动化操作。

核心功能

1. 多维表格（Bitable）

• 创建多维表格和数据表
• 添加、修改、删除字段
• 增删改查记录数据
• 批量导入导出数据
• 数据筛选和排序

2. 消息发送

• 发送文本、富文本、卡片消息
• 群组消息和私聊消息
• 消息模板和交互式卡片
• 文件和图片发送

3. 文档管理

• 搜索云文档
• 创建新文档
• 编辑文档内容
• 文档权限管理
• 文档协作者管理

4. 群组管理

• 创建群组
• 添加/移除成员
• 获取群组列表
• 群组信息查询

5. 知识库（Wiki）

• 搜索知识库节点
• 获取节点详情
• 创建和管理知识库内容

6. 日历和任务

• 创建和查询日历事件
• 创建和管理任务
• 任务分配和跟踪

快速开始

检查 MCP 可用性

// 检查 lark-mcp 工具是否可用
// 可用工具前缀：mcp__lark-mcp_

发送测试消息

// 发送文本消息到群组
await mcp__lark-mcp_sendMessage({
  receive_id: "oc_xxxxxxxxx",
  msg_type: "text",
  content: JSON.stringify({
    text: "Hello from Clawdbot!"
  })
});

工作流程

数据同步流程

1. 连接数据源
2. 转换数据格式
3. 创建/更新多维表格
4. 批量写入数据
5. 发送通知

消息推送流程

1. 触发事件（定时/事件驱动）
2. 构建消息内容
3. 获取接收者 ID
4. 发送消息
5. 记录日志

文档自动化流程

1. 获取文档模板
2. 填充内容
3. 创建新文档
4. 设置权限
5. 分享给团队

API 工具参考

多维表格相关

• createBitable - 创建多维表格
• createTable - 创建数据表
• addRecord - 添加记录
• updateRecord - 更新记录
• deleteRecord - 删除记录
• searchRecords - 搜索记录
• getRecord - 获取记录详情

消息相关

• sendMessage - 发送消息
• getMessages - 获取消息历史
• replyMessage - 回复消息

文档相关

• searchDocs - 搜索文档
• createDoc - 创建文档
• getDoc - 获取文档内容
• updateDoc - 更新文档
• setDocPermission - 设置文档权限

📄 Markdown 导入云文档（推荐方式）

最佳实践：将本地 Markdown 文件直接导入为飞书云文档，格式完整保留。

# 1. 获取 access_token
TOKEN=$(curl -s -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
  -H 'Content-Type: application/json' \
  -d '{"app_id":"YOUR_APP_ID","app_secret":"YOUR_APP_SECRET"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin).get('tenant_access_token',''))")

# 2. 上传 md 文件到飞书云盘
FILE_TOKEN=$(curl -s -X POST 'https://open.feishu.cn/open-apis/drive/v1/files/upload_all' \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_name=document.md" \
  -F "parent_type=explorer" \
  -F "parent_node=" \
  -F "size=$(stat -c%s /path/to/document.md)" \
  -F "file=@/path/to/document.md" \
  | python3 -c "import sys,json; print(json.load(sys.stdin).get('data',{}).get('file_token',''))")

# 3. 导入为飞书云文档
TICKET=$(curl -s -X POST 'https://open.feishu.cn/open-apis/drive/v1/import_tasks' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file_extension": "md",
    "file_token": "'"$FILE_TOKEN"'",
    "type": "docx",
    "point": {"mount_type": 1, "mount_key": ""}
  }' | python3 -c "import sys,json; print(json.load(sys.stdin).get('data',{}).get('ticket',''))")

# 4. 等待导入完成，获取文档链接
sleep 2
curl -s -X GET "https://open.feishu.cn/open-apis/drive/v1/import_tasks/$TICKET" \
  -H "Authorization: Bearer $TOKEN" \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('data',{}).get('result',{}).get('url',''))"

支持的导入格式：

• md → Markdown
• docx → Word 文档
• xlsx → Excel 表格

注意事项：

• 导入是异步操作，需要轮询 import_tasks/{ticket} 获取结果
• mount_type: 1 表示导入到"我的空间"
• 导入后的文档 URL 格式：https://xxx.feishu.cn/docx/{token}

📤 完整输出云文档流程（标准操作）

每次输出云文档时，必须完成以下步骤：

1. 生成本地 Markdown 文件
2. 上传到飞书云盘 → drive/v1/files/upload_all
3. 导入为云文档 → drive/v1/import_tasks
4. 设置权限为组织内可编辑 → drive/v1/permissions/{token}/public
5. 发送链接到目标群

# 完整流程脚本
TOKEN=$(curl -s -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
  -H 'Content-Type: application/json' \
  -d '{"app_id":"APP_ID","app_secret":"APP_SECRET"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin).get('tenant_access_token',''))")

# 1. 上传文件
FILE_TOKEN=$(curl -s -X POST 'https://open.feishu.cn/open-apis/drive/v1/files/upload_all' \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_name=document.md" \
  -F "parent_type=explorer" \
  -F "parent_node=" \
  -F "size=$(stat -c%s document.md)" \
  -F "[email protected]" \
  | python3 -c "import sys,json; print(json.load(sys.stdin).get('data',{}).get('file_token',''))")

# 2. 导入为云文档
TICKET=$(curl -s -X POST 'https://open.feishu.cn/open-apis/drive/v1/import_tasks' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"file_extension":"md","file_token":"'"$FILE_TOKEN"'","type":"docx","point":{"mount_type":1,"mount_key":""}}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin).get('data',{}).get('ticket',''))")

sleep 2

# 3. 获取文档 token
DOC_RESULT=$(curl -s -X GET "https://open.feishu.cn/open-apis/drive/v1/import_tasks/$TICKET" \
  -H "Authorization: Bearer $TOKEN")
DOC_TOKEN=$(echo "$DOC_RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin).get('data',{}).get('result',{}).get('token',''))")
DOC_URL=$(echo "$DOC_RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin).get('data',{}).get('result',{}).get('url',''))")

# 4. 设置权限：组织