X(Twitter) MCP Server

# 回复推文功能说明 ## 新增功能概述 本项目现已支持完整的推文回复功能，包括创建回复草稿和直接回复推文。 ## 新增的工具 (Tools) ### 1. `create_draft_reply` 创建一个回复推文的草稿。 **参数：** - `content` (string, 必需): 回复的内容 - `reply_to_tweet_id` (string, 必需): 要回复的推文ID **示例用法：** ```json { "name": "create_draft_reply", "arguments": { "content": "非常同意你的观点！感谢分享。", "reply_to_tweet_id": "1234567890123456789" } } ``` ### 2. `reply_to_tweet` 直接回复一条推文（不创建草稿）。 **参数：** - `content` (string, 必需): 回复的内容 - `reply_to_tweet_id` (string, 必需): 要回复的推文ID **示例用法：** ```json { "name": "reply_to_tweet", "arguments": { "content": "这个想法很棒！👍", "reply_to_tweet_id": "1234567890123456789" } } ``` ## 增强的现有功能 ### `publish_draft` 增强 现在支持发布回复草稿。系统会自动识别草稿类型： - 普通推文草稿 → 发布为新推文 - 推文串草稿 → 发布为推文串 - **回复草稿 → 发布为回复推文** (新功能) ### `list_drafts` 增强 现在会显示回复草稿的详细信息，包括： - 回复内容 - 要回复的推文ID - 草稿类型标识 ## 草稿数据结构 ### 回复草稿结构 ```json { "content": "回复的内容", "reply_to_tweet_id": "1234567890123456789", "timestamp": "2025-09-17T10:30:00.000000", "type": "reply" } ``` ## 使用场景 ### 场景1：创建回复草稿后发布 1. 用户：`"为推文 1234567890 创建一个回复草稿，内容是'很有启发性的观点！'"` 2. 系统调用 `create_draft_reply` 3. 用户：`"发布这个草稿"` 4. 系统调用 `publish_draft` ### 场景2：直接回复推文 1. 用户：`"回复推文 1234567890，说'完全同意！'"` 2. 系统直接调用 `reply_to_tweet` ## 错误处理 - **无效推文ID**: 如果提供的推文ID不存在或无法访问，Twitter API会返回错误 - **权限问题**: 如果账户没有回复权限或推文设置了回复限制，会返回相应错误 - **内容限制**: 回复内容仍需遵守Twitter的字符限制和内容政策 ### 🔧 草稿保留机制（重要修复） **发布失败时的草稿处理：** - ✅ **发布失败时草稿会被保留** - 用户可以重试或修改后再次发布 - ✅ **发布成功时草稿会被删除** - 避免重复发布 - ✅ **推文串部分失败处理** - 记录已发布的推文ID，便于用户了解发布状态 - ✅ **明确的错误信息** - 告知用户草稿已保留供重试 **错误信息示例：** ``` Twitter API error publishing draft draft_123.json: [API错误详情]. Draft preserved for retry. ``` ## 日志记录 所有回复操作都会记录详细日志： - 创建回复草稿：`Draft reply created: {draft_id}` - 发布回复：`Published reply tweet ID {tweet_id} to tweet {reply_to_tweet_id}` - 直接回复：`Published reply tweet ID {tweet_id} to tweet {reply_to_tweet_id}` ## 与现有功能的兼容性 新的回复功能完全兼容现有的所有功能： - 不影响现有的推文和推文串创建 - 草稿管理功能正常工作 - 所有现有的API调用保持不变