feishu-docx

feishu-docx is a professional-grade CLI and SDK tool designed to bridge the gap between Feishu (Lark) cloud workspaces and AI agent workflows. It enables seamless retrieval and modification of Feishu Docx, Sheets, Bitable, and Wiki content, making it an essential utility for developers and power users who rely on Feishu for knowledge management but need to leverage LLMs for analysis, automated reporting, or documentation maintenance. By converting structured cloud documents into clean, AI-ready Markdown, the tool allows agents to read entire wiki spaces, summarize meeting notes, or programmatically update document blocks.

• Full support for Feishu/Lark document formats including docx, sheets, bitable, and complex wiki hierarchies.

• Advanced export capabilities including browser-based rendering for public docs, batch processing of wiki spaces, and local asset downloading for images and attachments.

• Comprehensive write-back functionality to create new documents from Markdown, append content to existing files, or update specific document blocks using unique block IDs.

• Integrated cloud-space management to list files, manage permissions, and perform safe administrative operations via CLI or a built-in Textual-based TUI.

• WeChat article integration, allowing users to import external content into the Feishu ecosystem or export articles directly to Markdown.

• Configuration and Auth: Set up requires one-time app credentials or OAuth 2.0 flow, with automatic token refresh to ensure uninterrupted agent operations.

• Input/Output: Accepts standard Feishu/Lark URLs as input and produces high-quality Markdown. Supports stdout output for direct AI agent integration.

• Browser Export: Optional usage of Playwright for capturing content that requires a browser session (e.g., dynamic elements, private shared links).

• Constraints: Requires Python 3.11+ and optionally Playwright for advanced browser-based rendering. Optimized for developers familiar with CLI environments.