用途:通过内置的 --site x 桥接预设操作 X,可读取时间线、查看推文与对话、查看用户资料、发布推文或回复、发布 Markdown 文章,并在同一 X 登录会话中使用 Grok 对话。若需通用桥接设置或非 X 站点,应改用 $webmcp-bridge。
主要能力与用法:前置条件为 uxc 和 npx 已在 PATH 中,且可访问 https://x.com;全新机器或隔离 HOME 下需先执行 npx playwright install 安装 Playwright 浏览器。X 对认证敏感,配置未登录时会出现 bootstrap_then_attach 行为。先确保固定链接存在:command -v x-webmcp-cli;缺失或指向错误配置时运行 skills/x-webmcp/scripts/ensure-links.sh。调用前先查看帮助与工具架构,如 x-webmcp-cli -h、x-webmcp-cli timeline.home.list -h、x-webmcp-cli grok.chat -h、x-webmcp-cli article.publishMarkdown -h。新的或过期配置先检查认证状态:x-webmcp-cli bridge.session.status、x-webmcp-cli auth.get;未就绪时可用 bridge.session.bootstrap 或 bridge.session.mode.set '{"mode":"headed"}' 再 bridge.open。读取类工具示例:timeline.home.list limit=10、search.tweets.list '{"query":"playwright","mode":"latest","limit":10}'、tweet.get '{"url":"https://x.com/.../status/..."}'、tweet.conversation.get '{"id":"...","limit":10}'、user.get username=jack。写入类工具需先读帮助并确认用户意图,且可先用 dryRun,例如 tweet.create '{"text":"hello from webmcp","dryRun":true}'、tweet.reply、article.publishMarkdown。Grok 示例:grok.chat '{"prompt":"Summarize this thread","timeoutMs":180000}',上传需在 attachmentPaths 传绝对路径。输出按 JSON 解析:.ok 为 true 时看 .data,为 false 时看 .error.code 与 .error.message。
默认目标与限制:内置预设为 --site x,默认配置路径 ~/.uxc/webmcp-profile/x,可用 skills/x-webmcp/scripts/ensure-links.sh 刷新链接。X 配置应与其他站点隔离;在受管配置完成认证前,页面工具不可用;改变运行模式优先用 bridge.session.mode.set 而非重启命令;grok.chat 与文章发布可能耗时较长,应增大 timeoutMs 而非频繁重试;本地路径参数一律使用绝对路径;破坏性或公开写入优先用 dryRun;若手动关闭可见 X 窗口,headed 会话结束,需要时再次运行 bridge.open。参考文件包括 references/usage-patterns.md 与 scripts/ensure-links.sh。