三行代码,三个平台完成排期。
一次发布调用的真实形态:选一个工作区,传入文案和平台,返回帖子 ID 和各平台的投递状态。TypeScript、PHP 或 curl 都是同样的调用。
/v1/postsimport { FoPost } from '@fopost/sdk';
const client = new FoPost({ apiKey: process.env.FOPOST_API_KEY });
const accounts = await client.accounts.list({ workspaceId });
const post = await client.posts.create({
workspaceId,
status: 'scheduled',
scheduleAt: '2026-09-01T09:00:00Z',
content: [{ text: 'Stop launching on Tuesday.', position: 0 }],
accounts: accounts.map((a) => ({ id: a.id })),
});pst_01H7K3MRGB8YZ4QVW你写好了 Twitter 集成。然后 LinkedIn 全变了。
你一个周末就做好了 Twitter 发布。然后 LinkedIn 花了三天,OAuth 流程花了一周,Instagram 的 API 堪称世界最差,而 TikTok 你还没开始。
每个平台都会在同一天以不同方式出问题。Bluesky 改了速率限制。Threads 加了媒体类型限制。Hashnode 换了 GraphQL 版本。你的集成在着火,而你还要交付产品。
你为 5 个平台手写了 OAuth。你把刷新令牌存在自己的数据库里。现在你要负责令牌刷新、加密存储和 SOC 2 级别的密钥管理。这可不是你想做的生意。
API 适合你吗?
适合你,如果
- 你在打造一款需要代表用户发布到社交媒体的产品
- 你运营一条由 CI、CRM 或你自己的后端触发的内容运营流水线
- 你想通过 MCP 把 FoPost 接入 Claude Desktop、Cursor 或 ChatGPT,让智能体替你发布
- 你在为代理机构开发工具,想为自己的客户提供社交发布能力,又不想维护 33 个平台集成
不适合你,如果
- 你只在控制台里手动发帖。API 大材小用,编辑器才是合适的地方。
- 你需要完整的白标 API 托管(your-brand.api.com)。请联系我们洽谈企业方案。
一个 API。32 个平台。出问题我们来扛。
你只需对接一个数据结构。我们把它分发到 32 个平台,刷新令牌、处理速率限制、投递帖子、呈现错误。你专心交付功能。
简洁、可预期的 REST
资源结构清晰可预期(帖子、账户、工作区、投递、Webhook)。所有端点的请求和响应格式保持一致,版本统一在 /v1 下。
TypeScript SDK,外加一个独立的 PHP 库
TypeScript(npm install @fopost/sdk)封装了这套 REST API。PHP(composer require fopost/social-core,MIT 许可)是独立的:它用你自己的凭据直接发布到 11 个平台,无需 FoPost 账户。
面向 AI 助手的 MCP 服务器
npx -y @fopost/mcp 可以把你的 FoPost 工作区连接到 Claude Desktop、Cursor、ChatGPT 以及任何兼容 MCP 的智能体。提供 14 个工具:发布、排期、数据分析、账户管理。通过 API 密钥认证。
按工作区划分权限的密钥
每个工作区独立的密钥,带操作权限范围:posts、accounts、workspaces、labels、publish、deliveries、webhooks、analytics、automations。界面用 JWT,代码用 API 密钥。没有机构级的超级密钥。
每个事件都有外发 Webhook
订阅 publish.success、publish.failed、account.disconnected、account.reconnected、automation.triggered 等事件。每个负载都经过签名,你可以验证它确实来自我们,投递失败时会以指数退避重试。
为真实工作量设计的速率限制
这个限制远高于发布集成所需,而且随着你连接更多账户,上限会自动提高。一旦超出,你会收到清晰的 429 和 Retry-After 用于退避,而不是被悄悄丢弃或密钥被停用。
生成。安装。发布。
生成 API 密钥
在你要发布的工作区中,创建一个带所需权限范围的 API 密钥(一开始有 posts 和 accounts 就够了)。它只显示一次,请复制保存。像对待机密一样对待它。
安装 SDK
npm install @fopost/sdk。也可以不用 SDK,直接调用 REST 端点。或者两者都不用,在 Claude 里使用 MCP 服务器。
发起调用
三行代码:导入、实例化、创建。发布调用会返回帖子 ID 和各平台的投递状态。帖子会进入你控制台的队列,在排定时间发出。
订阅 Webhook(可选)
在工作区设置中添加一个 Webhook URL。订阅 publish.success 和 publish.failed。每次投递成功或失败时,你的端点都会收到一个签名 POST。这样你的系统就能保持同步。
为什么这比手写 33 个平台集成强。
如今开发者处理多平台发布通常有三种做法。只有一种是真正的 API,带 SDK、MCP 服务器,而且出问题有别人来扛。
自己动手:自己对接 33 个平台 API
技术型创始人会尝试的做法
- 每个平台一套 OAuth 流程。令牌存储。令牌刷新。加密的密钥管理。
- 每个平台的速率限制、错误格式、媒体限制都不一样。
- LinkedIn 一改 API,你就得改代码。Bluesky、Threads、Hashnode 也一样。
- 做完 Twitter 和 LinkedIn 你就不再加平台了。其余 29 个一直留在愿望清单上。
Buffer 或 Hootsuite API
老牌产品提供的方案
- 有公开 API,但感觉是事后才补上的。SDK 由社区维护,而且时有时无。
- 没有 MCP 服务器。接入 Claude 或 Cursor 得自己做定制集成。
- 按席位计价,让 API 成了代理机构的成本中心。
FoPost API + SDK + MCP
你真正想要的
- 一套 REST 数据结构覆盖 32 个平台,浏览器扩展还覆盖了没有写入 API 的 Substack。
- 由我们维护的 TypeScript SDK,外加一个 MIT 许可的 PHP 库。
- MCP 服务器现已可用:npx -y @fopost/mcp 即可接入 Claude Desktop、Cursor、ChatGPT。
- 每个工作区独立的限权密钥、签名 Webhook、内置重试。出问题我们来扛。
发布到所有主流网络