SuperAPI AI 工具集

x-mcp

智能体与模型

查看项目

更新于 10-16 01:28

技能介绍

用途:让智能体以用户自己的 X 账号和应用身份操作 X。读取走官方托管 MCP(https://api.x.com/mcp,24 个工具,覆盖帖子/用户/新闻搜索、时间线、提及、趋势、书签);写入走 X v2 REST(https://api.x.com/2/...),支持发布、删除、回复、点赞、转发、关注、私信,其中发布与删除已测试。

为什么用 BYOK:X 写入按应用限流、按使用计费到应用所有者,责任也由应用所有者承担,因此每个用户自带应用与 OAuth 令牌,令牌只保存在本机 ~/.xurl(符号链接到持久工作区),不经代理。

使用方式:先在 developer.x.com 创建应用并启用用户认证,权限选 Read and write(需要私信再加 DM),类型选 Web App/Automated App or Bot → Confidential client,回调地址填 http://localhost:8080/callback。凭据通过 request_env_input 收集。安装 npm install -g @xdevplatform/xurl,把 ~/.xurl 持久化并注册应用:xurl auth apps add starchild-x --client-id "$X_OAUTH_CLIENT_ID" --client-secret "$X_OAUTH_CLIENT_SECRET" --redirect-uri "http://localhost:8080/callback"。授权用无头流程 xurl auth oauth2 --headless,需保持单一进程存活,用户把回调 URL 粘回。之后在 agent.yaml 的 defaults.mcp_servers 下以映射形式添加 xmcp(transport: streamable-http,url: https://api.x.com/mcp,Authorization Bearer 头),再用 /mcp 确认工具注册。访问令牌约 2 小时过期,需用刷新流程重写 bearer,refresh_token 每次轮换必须持久化。

限制:读取依赖构建包含原生 MCP 客户端,且需具备每轮热重载以自动重连;创建应用与开通 v2 访问(Pay-per-use/Production)必须在门户手动完成,可能出现 client-not-enrolled 需重新开通;不适用仅需读取公开推文的场景(应用 twitter 技能)。其他细节资料未提供。