Claude Code 飞书云文档读写技能
- 读取/创建/编辑飞书云文档
- 搜索文档
- 操作多维表格(Bitable)
- 操作白板(Whiteboard)
- 操作知识库(Wiki)
~/.claude/skills/feishu-doc/
├── SKILL.md # 技能定义
├── scripts/
│ ├── feishu.py # CLI 入口
│ ├── auth.py # 授权配置
│ ├── crypto.py # AES-256-GCM 加解密
│ ├── feishu_client.py # MCP 客户端
│ └── url_parser.py # URL 解析
└── README.md
~/.feishu-claude/ # 密钥目录
├── key.bin # 加密密钥
└── secrets.json # 加密凭证
pip install cryptographyCMD中交互式配置:
cd ~/.claude/skills/feishu-doc/scripts
python auth.py setup按提示输入:
- App ID(飞书应用 ID)
- App Secret(飞书应用密钥)
- 在浏览器中完成飞书授权
python auth.py status在 Claude Code 中直接使用自然语言:
# 读取文档
分析这个飞书文档 https://xxx.feishu.cn/docx/ABC123
# 创建文档
创建一个飞书文档,标题叫"项目计划"
# 追加内容
在文档 ABC123 末尾添加"总结:本文已完成"
# 搜索文档
搜索飞书中关于"技术方案"的文档
# 查看评论
获取文档 ABC123 的评论
cd ~/.claude/skills/feishu-doc/scripts
# 读取文档
python orchestrator.py read "https://xxx.feishu.cn/docx/ABC123"
# 创建文档
python orchestrator.py create "文档标题"
# 搜索
python orchestrator.py search "关键词"
# 列出
python orchestrator.py list- 密钥存储在
~/.feishu-claude/key.bin - 凭证加密存储在
~/.feishu-claude/secrets.json - 敏感文件不提交到版本控制(已配置 .gitignore)
- 密钥和凭证仅本地存储,不上传到任何服务器
如需轮换密钥:
python -c "from crypto import rotate_key; rotate_key()"这将生成新密钥并重新加密所有凭证。
python auth.py setuppython auth.py refreshpython auth.py status在飞书开放平台申请以下权限:
docx:document- 文档权限docx:document:readonly- 查看文档docx:document:block:convert- 块转换drive:drive- 云空间wiki:wiki- 知识库board:whiteboard:node:*- 白板bitable:app:*- 多维表格