topmind X / Twitter

分清两个平面：

平面	接入	能力
Agent 宿主	官方 MCP https://api.x.com/mcp + xurl mcp	搜索/用户/书签等（随 scope）
Desktop 只读	App-only Bearer → API v2	搜索/时间线 → 归档笔记
Desktop 发帖	本机 xurl（用户 OAuth）	发布；失败草稿进 Inbox

文档：https://docs.x.com/tools/mcp

When NOT to use

• 微信读书 → topmind-weread
• 非 X 的剪藏 → topmind-capture
• 长文交付（非推文）→ topmind-write

认证

• Bearer：只读；不能发帖
• xurl OAuth：Desktop 发帖
• 官方 MCP：Agent 宿主；Desktop 不内嵌 OAuth 桥

npx -y @xdevplatform/xurl mcp https://api.x.com/mcp
brew install --cask xdevplatform/tap/xurl && xurl auth oauth2

与笔记整合

类别解析：`../topmind/references/connector-resolution.md`。

推文笔记：source_type: external-capture，含链接与可选 AI 摘要分隔。

发布工作流

起草（可 write）→ 用户确认（即使 writeback_mode: auto）→ xurl 或 MCP 发布 → 可选归档。

Desktop RPC

x.getStatus · probeTools · testConnection · searchTweets · getTimeline · syncToNotes · postTweet。

设置：x.enabled · bearerToken · mcpEndpoint（仅 Agent 文档）· syncCategory: auto · autoArchivePosts。

Desktop 实现约定

• 读：Bearer → 官方 GET https://api.x.com/2/tweets/search/recent / GET /2/users/by/username/{handle} + /2/users/{id}/tweets。无 Bearer 时走本机 xurl 同一 REST 路径（不是自造 timeline --user）。
• 写：xurl -X POST /2/tweets -d '{"text":…}'（官方）；快捷 xurl post "…" 作回退。App-only Bearer 不能发帖。
• 归档：预览勾选后写入 {类别}/{YYYY-主题}/；append 时按 tweet_ids / status/{id} 跳过已有推文。create/update 不备份（仅 locked 等高影响）。
• Desktop 不内嵌官方 MCP OAuth 桥；mcpEndpoint 给 Agent 宿主配置。

降级

1. 无 Bearer → 不能搜索/时间线
2. 无 xurl → 不能发帖（草稿 Inbox）
3. Agent 完整能力 → 宿主接 MCP
4. 无通道 → 仅编辑器起草

安全

Bearer 加密存储；不自动关注/点赞/转发；遵守 X API 规则。

保存设置

• 自动保存 (auto)：直接写入并返回路径回执（path receipt）
• 需要审阅 (confirm)：先进入目标路径/内容审阅入口再保存
• Host 可编码为 writeback_mode: auto | confirm。详见 `../shared/writeback-receipt.md`。

发布动作始终二次确认（即使 auto）。