X-use

社区

浏览器原生的X(Twitter)AI代理，支持多账户、兼容MCP，无需X API密钥。

分类: 浏览器自动化第 13 / 32
Stars: ★ 177 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · 预编译二进制
凭据: 可选 API Key
许可证: MIT
最近提交: 8 天前
工具数: 33

55FMRS · C

x-use是一个开源、MIT许可的MCP服务器，通过浏览器自动化实现X（Twitter）的无API密钥操作。它提供33个MCP工具，支持多账户、草稿审批、代理管理，并集成到Claude Desktop等客户端。主要风险是X账号封禁，适合个人和小团队。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

12/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 证据：项目包含599个测试和CI工作流（Python 3.10/3.11/3.12），这些测试覆盖了服务器的关键路径如MCP工具合同、会话和队列。测试不需要网络或浏览器，增加了可靠性的信心。扣分：静态审查期间未执行任何内容，因此实际运行时的错误和运行时行为未经证实。测试可能在模拟条件下通过，但真实浏览器自动化可能失败。分数上限为12，因此8相对较低。
安全与权限 10/20: 证据：服务器处理敏感cookie和代理凭据，但在资源中掩码并从accounts显示中剥离。写入工具默认在草稿模式下工作，需要明确的approve_draft审批，防止未确认的发布。环境变量标记为密钥（OPENAI_API_KEY）并在清单中明确。扣分：由于安全边界存在（如数据存储和外部网络访问）但未完全静态验证，完整的最小权限和安全范围难以从静态检查中确认。未发现红线违规。
维护活跃度 12/20: 证据：项目具有MIT许可证，README中标注了CI徽章，以及包含599个测试的测试套件。提到持续开发（路线图、贡献指南）。扣分：未见明确的发布节奏或维护者响应时间；依赖项更新未明确可见；版本控制存在但细节有限。因此低于满分。
文档质量 13/20: 证据：广泛的README涵盖了安装、配置、MCP工具、配置参考、最佳实践和常见问题。包含带示例的MCP指南。包括设置提示和技能。扣分：虽然文档详尽，但缺少关于限制（如速率限制、并发限制）的某些具体细节，且未提供故障排除的明确性。未验证文档与实际功能的一致性。
安装易用性 12/20: 证据：提供清晰的安装说明，包括从PyPI安装、一键安装程序以及手动方式。提供特定客户端的配置示例（claude_desktop_config.json）。包含初始化向导和doctor命令。扣分：由于静态审查，安装脚本未执行；需要外部依赖（Chrome、可能代理）可能使其脆弱。缺少明确的分步故障排除。因此低于最高分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据控制浏览器

适合谁

希望自动化X账号且不想支付X API费用的个人或小团队
使用Claude Desktop、Cursor等MCP客户端的开发者
需要管理多个X账号的用户

不适合谁

需要官方X API完整功能（如数据分析、广告）的企业用户
担心X账号被封禁的用户，因为浏览器自动化风险较高
需要在生产环境中大规模运行的用户，因为目前未提供Docker版本

所需权限

需要登录X账户的Cookie，用于浏览器会话
需要Chrome浏览器
可选：LLM API密钥（仅用于服务器端文本生成）
可选：代理（推荐用于多账户）

风险与副作用

X账号可能因违反服务条款而被暂停
浏览器自动化可能被X检测到，导致封禁
Cookie和凭据可能泄露，即使已掩码
草稿模式默认开启，但若手动关闭，发布操作将直接执行

安装接入

准备工作

运行环境：Python 3.10+ · 预编译二进制

OPENAI_API_KEY 可选密钥可选密钥，仅服务端文本生成（auto 回复、复合草稿工具、后台自动化）需要；交互式 MCP 使用无需。

其他可选配置项（1 个）

OPENAI_BASE_URL 可选可选的 OpenAI 兼容端点，如 OpenRouter 或本地 Ollama (http://localhost:11434/v1)，默认 api.openai.com。

使用 pip install x-use-mcp 安装。
运行 x-use init 进行交互式设置向导。
运行 x-use doctor 验证环境。
将 {"mcpServers": {"x-use": {"command": "x-use", "args": ["mcp"]}}} 添加到 MCP 客户端配置（如 Claude Desktop）。
重启客户端。

claude_desktop_config.json

{
  "mcpServers": {
    "x-use": {
      "command": "x-use",
      "args": [
        "mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "x-use": {
      "command": "x-use",
      "args": [
        "mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add x-use -- x-use mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

重启客户端后调用 list_accounts，能返回账户列表（或空列表）即说明 MCP 服务器连接成功；也可先运行 x-use doctor 检查环境。

常见排障

运行 x-use doctor 检查环境
确保Chrome已安装且版本兼容
检查config/settings.json中draft_mode设置
确保MCP客户端能找到x-use命令（PATH）
检查日志文件logs/accounts/<account_id>.jsonl

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我所有已配置的 X 账户及其健康状态
搜索关于 AI agents 的最新推文，并为其中一条准备回复草稿
帮我起草三条关于本地 AI 模型的帖子变体，先不发布
查看当前队列里有哪些待处理的定时操作

工具能力 33

list_accounts 只读

列出所有配置的账户。

get_account 只读

获取单个账户的完整掩码配置。

get_metrics 只读

获取指定账户的指标（如计数器）。

search_tweets 只读

使用关键词搜索推文。

search_profile 只读

搜索用户个人资料。

get_tweet 只读

获取推文详情，包括图片。

prepare_reply 只读

准备回复推文的草稿（需人工审批）。

list_queue 只读

列出计划中的操作队列。

展开其余 25 个工具

list_drafts 只读

列出待审批的草稿。

get_draft 只读

获取草稿详情。

reject_draft 写入

拒绝草稿。

get_run_status 只读

获取后台运行状态。

get_account_health 只读

检查账户健康状态。

list_proxies 只读

列出配置的代理池。

post_tweet 写入

发布推文（默认生成草稿）。

generate_and_post 写入

生成并发布推文（需LLM密钥，默认草稿）。

reply_to_tweet 写入

回复推文（默认草稿）。

engage 写入

执行互动操作，如点赞、转发等（默认草稿）。

run_cycle 写入

运行一个自动化周期（如关键词回复）。

approve_draft 写入

批准草稿并实际执行发布/互动。

queue_post 写入

将推文加入计划队列。

queue_engagement 写入

将互动操作加入计划队列。

cancel_queued_action 写入

取消队列中的操作。

process_queue 写入

处理队列中的待执行操作。

research_and_stage 写入

使用服务器端LLM进行调研并暂存草稿。

draft_post_variations 写入

使用服务器端LLM生成推文变体草稿。

add_account 写入

添加新账户。

update_account 写入

更新账户配置。

set_account_active 写入

激活或停用账户。

remove_account 破坏性

移除账户。

add_proxy 写入

添加代理。

remove_proxy 破坏性

移除代理。

test_proxy 只读

测试代理连通性。

使用场景

自动化发布和回复推文

多账户管理，每个账户有独立配置

关键词搜索、针对性地互动和内容策划

通过MCP客户端（如Claude Desktop）直接控制X账号

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

x-use 驱动一个真实的、经过防检测加固的浏览器，替代付费的X API。它可以发布、回复、搜索，并在您配置的多个账户之间进行互动。它使用您自己的LLM生成内容，并将所有功能作为MCP工具暴露，因此Claude Desktop、Claude Code、Cursor等MCP客户端可以直接管理您的X账号。默认情况下，写入操作会经过草稿审批步骤，代理可以在白天准备大量工作，但只有人工确认后才会真正发布到X。