x-use

这个 Agent 能做什么，适合哪些场景？

x-use 是一个开源的 Python MCP 服务器与 CLI，把 X（Twitter）接到了 Claude、Codex、Cursor、Windsurf 等本地 MCP 客户端上。它不依赖官方 X API，而是用 Patchright 驱动的 Chromium 复用你已登录的浏览器会话，因而无需申请 API 密钥。项目当前版本 3.2.0 提供 82 个工具、7 个提示、4 种资源模式和 7 个内置技能，覆盖资料与帖子调研、收件箱与通知读取、书签与帖子编辑删除、草稿审核发布、私信外联、线索与活动管理、账号健康检查与代理测试。执行模型是本地的：配置、cookie、草稿、队列和操作日志都放在你指定的 X_USE_HOME 目录下，支持多账号独立上下文与可选代理。发布默认走草稿模式，消息、关注和长帖起始都需要逐条批准，只有当你有意切换策略时才会直接执行。

安装后运行 x-use init 向导导入你自己的 X 会话 cookie，再用 x-use mcp 或 x-use-mcp 启动一个 stdio MCP 服务器，客户端即可调用工具。调研链路是 get_account_health → get_profile_context → prepare_reply → reply_to_tweet → get_draft：先检查账号就绪状态，再读取可见资料、帖子和有限长度的讨论串上下文，生成回复草稿并取回草稿 ID 与确切文本，只有调用 approve_draft 才会真正发布。收件箱侧用 get_inbox、search_conversations、get_conversation、get_notifications 读取可见会话与通知，用 manage_conversation 处理请求、静音等受支持操作。发布与账号侧还提供 get_bookmarks、edit_tweet、delete_tweet、unfollow_profile、post_tweet、prepare_thread、queue_post、process_queue、resolve_action_outcome 以及 test_proxy。外联和活动管理通过 prepare_outreach、send_message、follow_profile、upsert_lead、create_campaign、prepare_campaign_messages、opt_out_lead 在本地维护线索、退订与批量草稿。所有浏览器读取都受限于 X 页面上实际可见的内容。

1. 社交媒体运营者在回复潜在客户前，先让 AI 调研对方资料与近期帖子，再生成一条有上下文的回复草稿并人工确认。
2. 客服或多账号运营者需要在一个流程里查看多个 X 账号的收件箱、未读消息、请求和通知，并做初步分类。
3. 内容创作者先让 AI 起草单条帖子或多帖长帖，检查确切文本后再批准发布，避免误发。
4. 增长或销售团队希望在本机维护线索列表、退订名单和活动草稿，并跟踪发送情况。
5. 开发者想把 X 调研与发布能力接入 Claude Code、Codex、Cursor 等本地 MCP 客户端，作为自动化工作流的一环。
6. 使用者发现账号会话异常或代理不通时，通过 get_account_health、get_session_status、test_proxy 做运行前诊断。

如何安装或部署这个 Agent？

需要 Python 3.11+ 和 Chromium，CI 覆盖 Python 3.11–3.14 及 Windows、macOS、Linux。先安装包与浏览器：

python -m pip install --upgrade x-use-mcp
python -m patchright install chromium

然后设定一个私有数据目录并初始化（macOS / Linux 示例）：

export X_USE_HOME="$HOME/.local/share/x-use"
x-use init
x-use doctor

Windows PowerShell 对应写法：

$env:X_USE_HOME = "$env:LOCALAPPDATA\x-use"
x-use init
x-use doctor

向导会配置账号并从本地 JSON 导出文件导入你自己的 X 会话 cookie。若要从源码安装，可执行：

git clone https://github.com/ihuzaifashoukat/x-use.git
cd x-use
python scripts/setup_uv.py --dev

使用 uvx 的客户端可直接 uvx x-use-mcp 或固定版本 uvx x-use-mcp==3.2.0。

如何使用这个 Agent？

在 Claude Desktop 等接受 mcpServers 对象的客户端里，把两个路径替换为你的实际绝对路径：

{
  "mcpServers": {
    "x-use": {
      "command": "/absolute/path/to/x-use",
      "args": ["mcp"],
      "env": {
        "X_USE_HOME": "/absolute/path/to/x-use-data"
      }
    }
  }
}

Windows 使用 x-use.exe 路径并在 JSON 中写正斜杠。Claude Code、Codex、Cursor、Windsurf 各有注册方式，按 SKILL.md 配置后重载客户端。首次使用时让客户端先调用 list_accounts，再执行一条带审核的流程，例如要求“检查账号健康、调研指定资料、准备一条回复草稿并显示 ID 与确切文本，等我批准后再发布”。命令对应为 get_account_health → get_profile_context → prepare_reply → reply_to_tweet → get_draft，最后仅在获授权时调用 approve_draft。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v3.2.0 x-use 3.2.0 2026-10-13
   发布说明摘录

   X-Use 3.2.0 is a maintenance release. It moves the MCP server to the MCP Python SDK v2 line and refreshes dependencies. The 82 tools, their schemas, annotations and result envelopes are unchanged. What changed - MCP Python SDK v2: the server now runs on mcp>=2.3,<3; v1 is no longer supported. Existing clients still negotiate handshake protocol versions 2024-11-05 through 2025-11-25 over stdio, and serverInfo reports the x-use package version. - Dependencies: openai 3.27, twine 7 for release checks, a setuptools 84 build floor and Python 3.14 in the Docker image. …

   在 GitHub 查看 ↗
2. v3.1.0 x-use 3.1.0 2026-10-12
   发布说明摘录

   X-Use 3.1.0 adds 12 MCP tools, bringing the total to 82, with reviewed publishing and inbox controls, stronger account isolation, and operational account-health scoring. What changed - Publishing and inbox controls: bookmarks, unlike/undo repost, unfollow, own-post edit/delete, conversation capabilities and supported request/mute/deletion drafts. - Account health: a transparent 0–100 readiness score with evidence gaps and recovery suggestions. Local-only checks can score at most 90; this is not a prediction of X enforcement. …

   在 GitHub 查看 ↗
3. v3.0.0 x-use 3.0.0 - reviewed outreach, inbox and threads 2026-10-09
   发布说明摘录

   x-use 3.0.0 adds reviewed X outreach, structured inbox and notification workflows, and resumable threads to the MCP server. - 70 MCP tools, seven prompts, four resources and seven bundled agent skills, including the new inbox skill. - Claude Code plugin and GitHub marketplace installation. - Async Patchright sessions with isolated accounts, stable proxy routes, bounded action budgets and durable recovery for uncertain writes. - Structured profile, thread, media, message and notification reads, plus reviewed leads, campaigns and multi-post workflows. …

   在 GitHub 查看 ↗

常见问题