xpost

为你的助手打造的 xpost

借助 AI Agent 发布到所有社交媒体：X、Instagram、LinkedIn、 Facebook、TikTok、YouTube、Threads、Bluesky 和 Pinterest。你可以使用 Claude、 ChatGPT、Cursor、Gemini CLI 或任何 MCP 客户端。想先审核再发布？开启 审批功能，在有人确认之前，内容不会发出。

这个仓库包含开源的 skill（Agent 应遵循的工作流），以及用于安装该 skill 的插件清单，还包含托管的 MCP 服务，地址为 https://xpost.to/api/mcp。只需在浏览器窗口中登录一次， 无需复制粘贴任何内容。

你需要一个 xpost 账户——首条内容免费，无需银行卡： https://xpost.to/signup

安装

任意 Agent——作为 skill 安装

npx skills add xpost-to/xpost-agent

这只会安装 skill。请按下文所述在客户端中添加 MCP 服务， 或者让该 skill 的 REST 回退机制使用 XPOST_API_KEY。

Claude Code——插件（skill + MCP 服务）

/plugin marketplace add xpost-to/xpost-agent
/plugin install xpost@xpost-agent

系统不会提示你登录：输入 /mcp，选择 xpost，然后 选择 Authenticate——浏览器会打开登录页面。也可以不安装插件：

claude mcp add --transport http xpost https://xpost.to/api/mcp

Gemini CLI——扩展（skill + MCP 服务）

gemini extensions install https://github.com/xpost-to/xpost-agent

Gemini 首次使用时会打开浏览器，让你登录 xpost；输入 /mcp auth xpost 可再次登录。

Cursor

一键安装：将 xpost 添加到 Cursor

或者在 Settings → Tools & Integrations → New MCP Server 中手动添加：

{ "mcpServers": { "xpost": { "type": "http", "url": "https://xpost.to/api/mcp" } } }

然后运行 npx skills add xpost-to/xpost-agent 安装 skill。该仓库还包含 Cursor 插件清单（.cursor-plugin/plugin.json）。

Grok Build

该仓库包含 Grok Build 插件清单（.grok-plugin/plugin.json， 含 skill + 托管的 MCP 服务），以及专属市场目录 （.grok-plugin/marketplace.json）。在 Grok Build 中，输入 /marketplace 浏览 目录；在 shell 中，来源获知后运行 grok plugin install xpost --trust。目前尚未加入 xAI 官方索引。

Muse Code（Meta）

将托管的服务添加到 ~/.config/muse/settings.json；Muse Code 会在你首次调用工具时提示 登录：

{
  "schema_version": 1,
  "mcp_servers": {
    "xpost": { "transport": "streamable_http", "url": "https://xpost.to/api/mcp" }
  }
}

Grok、Muse 和其他没有 MCP 设置的聊天助手

将以下内容粘贴到聊天中。助手会自行完成设置，并向你索要 API 密钥（在 xpost 中前往 Project → AI agent → Keys）：

设置 xpost，让你能发布到我的社交账户。REST API 地址为 https://xpost.to/api/v1（规范见 https://xpost.to/api/v1/openapi.json）， 使用 Authorization: Bearer YOUR_KEY 标头进行身份验证。如果你能运行 命令，npx xpost 可调用该 API，npx skills add xpost-to/xpost-agent 可安装工作流。向我索要 xpost API 密钥，并在执行任何操作之前将其设为 XPOST_API_KEY。从账户列表开始。创建帖子后会立即发布，除非我的项目将帖子设为待审批——在回执确认之前，绝不要说帖子已发布。

ChatGPT、Claude.ai、Claude Desktop

ChatGPT：xpost 已收录在插件目录中——找到它、添加并登录。 如果 Claude 已安装 xpost 插件：前往 Customize → Connectors，找到 xpost，点击 Connect 并登录——插件会添加连接器，但不会自动登录。 如果没有安装插件：前往 Customize → Connectors → Add → custom connector，粘贴 https://xpost.to/api/mcp，然后登录。

完全没有 MCP 客户端——使用 CLI

npx xpost login
npx xpost posts create -c "Shipped it." -a x:yourhandle

npm 上的 xpost 包包含 CLI、本地 MCP 服务（npx xpost mcp）和 skill 的回退机制。文档：https://xpost.to/docs/cli

该技能的教学内容

• 先查看账号：list_accounts 会列出所有目标账号及其可发布的内容。
• get_posting_rules 是每个账号的选项目录；其中没有的键不可使用。
• 创建帖子会直接发送；处于 copilot 模式的项目则会暂存（pending_approval）。这两种结果都属正常——说明是哪一种，并打印链接。
• 遇到防护规则拒绝时，会指出具体规则。只重写一次。切勿绕过规则。
• 不要想当然地认为帖子仍在等待处理，先使用 list_posts 检查——对方可能已经拒绝，并说明了原因。
• 回执按账号分别提供：“已发送至 X，在 Instagram 上失败：原因”。

完整文本：skills/xpost/SKILL.md。

文档

• 所有 MCP 工具：https://xpost.to/docs/mcp
• REST API（OpenAPI）：https://xpost.to/api/v1/openapi.json
• 各客户端的设置指南：https://xpost.to/docs

在自己的实例上自托管客户端

在 MCP 地址中将 https://xpost.to 替换为你的实例地址。使用 REST 备用方案时，设置 XPOST_URL 和 XPOST_API_KEY。

许可证

MIT。此处的技能和清单可自由复制和改编；xpost 本身是托管服务。