\r \r

Feishishu document operations using useru User\r

\r Fe access token authentication. Call Feishu Open API directly via REST API.\r \r

Install Dependencies\r

\r

pip install requests\r
```\r
\r
## Quick Start\r
\r
```python\r
from feishu_client import FeishuClient\r
\r
# Initialize client\r
client = FeishuClient(user_access_token="u-xxx")\r
```\r
\r
## Get User Access Token\r
\r
### Step 1: Get App Credentials from Feishu Open Platform\r
\r
Prepare the following:\r
- **APP_ID** - App ID (from Feishu Open Platform app settings)\r
- **APP_SECRET** - App Secret (from Feishu Open Platform app settings)\r
- **REDIRECT_URI** - Authorization callback URL\r
\r
Enable these permissions:\r
- `docx:document` - Document operations\r
- `drive:drive.search:readonly` - Cloud drive search\r
- `search:docs:read` - Document search\r
\r
### Step 2: Generate Authorization URL\r
\r
```\r
https://accounts.feishu.cn/open-apis/authen/v1/authorize?client_id={YOUR_APP_ID}&response_type=code&redirect_uri={YOUR_REDIRECT_URI}&scope=docx%3Adocument%20drive%3Adrive.search%3Areadonly%20search%3Adocs%3Aread\r
```\r
\r
### Step 3: Exchange for Token\r
\r
```bash\r
curl -X POST "https://open.feishu.cn/open-apis/authen/v1/access_token" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "grant_type": "authorization_code",\r
    "code": "{YOUR_CODE}",\r
    "app_id": "{YOUR_APP_ID}",\r
    "app_secret": "{YOUR_APP_SECRET}"\r
  }'\r
```\r
\r
The returned `access_token` is your `user_access_token`.\r
\r
---\r
\r
## Usage Examples\r
\r
```python\r
from feishu_client import FeishuClient\r
\r
# Initialize\r
client = FeishuClient(user_access_token="u-xxx")\r
\r
# Read document\r
content = client.read_doc("doc_token")\r
print(content)\r
\r
# Create document\r
new_token = client.create_doc("My New Document")\r
print(f"New document: {new_token}")\r
\r
# Write document\r
client.write_doc("doc_token", "# Title\
\
Content")\r
\r
# Append content\r
client.append_doc("doc_token", "## New Section\
\
More content")\r
\r
# List all blocks\r
blocks = client.list_blocks("doc_token")\r
for block in blocks:\r
    print(block)\r
\r
# Get specific block\r
block = client.get_block("doc_token", "block_id")\r
\r
# Update block\r
client.update_block("doc_token", "block_id", "New content")\r
\r
# Delete block\r
client.delete_block("doc_token", "block_id")\r
```\r
\r
---\r
\r
## Convenience Functions\r
\r
Don't want to create a client? Use functions directly:\r
\r
```python\r
from feishu_client import read_document, create_document, write_document, append_document\r
\r
# Read\r
content = read_document("doc_token", user_access_token="u-xxx")\r
\r
# Create\r
new_token = create_document("Title", user_access_token="u-xxx")\r
\r
# Write\r
write_document("doc_token", "# Content", user_access_token="u-xxx")\r
\r
# Append\r
append_document("doc_token", "## More", user_access_token="u-xxx")\r
```\r
\r
---\r
\r
## API Reference\r
\r
### FeishuClient\r
\r
| Method | Description |\r
|--------|-------------|\r
| `read_doc(doc_token)` | Read document content |\r
| `create_doc(title, folder_token)` | Create new document |\r
| `write_doc(doc_token, content)` | Write document (overwrite) |\r
| `append_doc(doc_token, content)` | Append content to end |\r
| `list_blocks(doc_token)` | List all blocks |\r
| `get_block(doc_token, block_id)` | Get specific block |\r
| `update_block(doc_token, block_id, content)` | Update block content |\r
| `delete_block(doc_token, block_id)` | Delete block |\r
\r
---\r
\r
## Notes\r
\r
1. `user_access_token` has an expiration time, needs periodic refresh\r
2. The `scope` in authorization URL must be enabled in Feishu Open Platform\r
3. This skill accesses personal cloud documents using user identity\r
\r
---\r
\r
## Related Links\r
\r
- Feishu Open Platform: https://open.feishu.cn\r
- Document API: https://open.feishu.cn/document/ukTMukTMukTM/uADOwUjLwgDMzCM4ATm\r
\r
---\r
\r
## Token Auto Refresh\r
\r
Use `feishu_token.py` script for automatic token refresh.\r
\r
### Install Dependencies\r
\r
```bash\r
pip install requests\r
```\r
\r
### First Authorization\r
\r
```bash\r
# 1. Generate authorization URL\r
python feishu_token.py --app-id YOUR_APP_ID --app-secret YOUR_SECRET --redirect-uri YOUR_REDIRECT_URI --url\r
```\r
\r
After user authorizes, will callback to `YOUR_REDIRECT_URI?code=XXX`\r
\r
```bash\r
# 2. Use authorization code to get token\r
python feishu_token.py --app-id YOUR_APP_ID --app-secret YOUR_SECRET --code AUTH_CODE\r
```\r
\r
Token is automatically saved to `~/.config/claw-feishu-user/config.json`\r
\r
### Refresh Token\r
\r
```bash\r
python feishu_token.py --app-id YOUR_APP_ID --app-secret YOUR_SECRET --refresh\r
```\r
\r
### In Code\r
\r
```python\r
import json\r
import os\r
\r
# Read cached token\r
config_path = os.path.expanduser("~/.config/claw-feishu-user/config.json")\r
with open(config_path) as f:\r
    config = json.load(f)\r
\r
# Use token\r
client = FeishuClient(user_access_token=config["access_token"])\r
```\r