docs: add structured output guidance for AI agents

README.md

@@ -26,9 +26,11 @@ A terminal-first CLI for Twitter/X: read timelines, bookmarks, and user profiles
 - Tweet detail: view a tweet and its replies
 - List timeline: fetch tweets from a Twitter List
 - User lookup: fetch user profile, tweets, likes, followers, and following
-- JSON output: export any data for scripting
+- JSON output: export any data for scripting and AI agent integration
 - Optional scoring filter: rank tweets by engagement weights
 
+> **AI Agent Tip:** Always use `--json` for structured output instead of parsing the default rich-text display. Use `--max` to limit results.
+
 **Write:**
 - Post: create new tweets and replies
 - Delete: remove your own tweets
@@ -292,7 +294,9 @@ After installation, OpenClaw can call `twitter-cli` commands directly.
 - 推文详情：查看推文及其回复
 - 列表时间线：获取 Twitter List 的推文
 - 用户查询：查看用户资料、推文、点赞、粉丝和关注
-- JSON 输出：便于脚本处理
+- JSON 输出：便于脚本处理和 AI agent 集成
+
+> **AI Agent 提示：** 需要结构化输出时始终使用 `--json`，不要解析默认的富文本显示。用 `--max` 控制返回数量。
 
 **写入:**
 - 发推：发布新推文和回复