从你的代码发布。同样的流程,程序化完成。

控制台里的每个操作都是一个 REST 端点。发布、排期、账户、数据分析、Webhook。官方 TypeScript SDK。适用于 Claude Desktop、Cursor 和 ChatGPT 的 MCP 服务器。每个工作区独立且限定权限的 API 密钥,什么都不会泄露。

简洁的 REST API,资源结构清晰可预期
npm 上的 TypeScript SDK,外加一个独立的 MIT 许可 PHP 库
适用于 Claude、Cursor、ChatGPT 的 MCP 服务器(14 个工具)
每个工作区独立的 API 密钥,按操作限定权限
API 的真实样子

三行代码,三个平台完成排期。

一次发布调用的真实形态:选一个工作区,传入文案和平台,返回帖子 ID 和各平台的投递状态。TypeScript、PHP 或 curl 都是同样的调用。

POST/v1/posts
TypeScript
PHP
curl
import { 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 })),
});
响应200 OK · 142ms
帖子 IDpst_01H7K3MRGB8YZ4QVW
投递(3)
X已排期 · 周一上午 9:00 UTC
LinkedIn已排期 · 周一上午 9:00 UTC
Bluesky已排期 · 周一上午 9:00 UTC
官方 TypeScript SDK,由我们维护
按密钥划分权限:帖子、账户、数据分析
每个事件都有 Webhook 回调
自己拼接 33 个平台 API 的代价

你写好了 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 用于退避,而不是被悄悄丢弃或密钥被停用。

工作原理

生成。安装。发布。

01

生成 API 密钥

在你要发布的工作区中,创建一个带所需权限范围的 API 密钥(一开始有 posts 和 accounts 就够了)。它只显示一次,请复制保存。像对待机密一样对待它。

02

安装 SDK

npm install @fopost/sdk。也可以不用 SDK,直接调用 REST 端点。或者两者都不用,在 Claude 里使用 MCP 服务器。

03

发起调用

三行代码:导入、实例化、创建。发布调用会返回帖子 ID 和各平台的投递状态。帖子会进入你控制台的队列,在排定时间发出。

04

订阅 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

FoPost API + SDK + MCP

你真正想要的

  • 一套 REST 数据结构覆盖 32 个平台,浏览器扩展还覆盖了没有写入 API 的 Substack。
  • 由我们维护的 TypeScript SDK,外加一个 MIT 许可的 PHP 库。
  • MCP 服务器现已可用:npx -y @fopost/mcp 即可接入 Claude Desktop、Cursor、ChatGPT。
  • 每个工作区独立的限权密钥、签名 Webhook、内置重试。出问题我们来扛。

发布到所有主流网络

常见问题

API 包含在内吗?

是的,每个账户都有完整的读写权限。端点、权限范围和 SDK 对所有人都一样。随着你连接更多账户,请求上限会自动提高。

API 参考文档在哪里?

fopost.com/docs/api 提供完整的参考文档,每个端点都有 TypeScript、PHP 和 curl 代码示例。

SDK 收费吗?

不收费。TypeScript(@fopost/sdk)在 npm 上免费,对接的是这套 API,而 API 包含在每个账户中。PHP 库(composer require fopost/social-core,MIT 许可)免费且独立:它用你自己的凭据直接发布到 11 个平台,完全不需要 FoPost 账户。它也是我们 Laravel 包的底层。

适用于 Claude、Cursor 和 ChatGPT 的 MCP 呢?

现已在 npm 上以 @fopost/mcp 发布。运行 npx -y @fopost/mcp 即可得到一个 stdio MCP 服务器,把它指向任意兼容 MCP 的客户端(Claude Desktop、Cursor、ChatGPT 桌面版、Goose、Continue),用 FOPOST_API_KEY 认证,就能获得 14 个工具:发布、排期、列出帖子、获取数据分析、管理账户等。

API 密钥的权限范围是怎么运作的?

每个密钥绑定一个工作区,并带有你在创建时选择的操作权限范围列表:posts、workspaces、accounts、labels、publish、deliveries、webhooks、analytics、automations。没有 "accounts" 权限的密钥无法列出或修改账户,即使用户授权了这些操作也不行。每次调用都会在服务端检查权限范围。

我应该按什么速率限制来规划?

正常的发布流量在任何套餐下都远远碰不到上限。上限取决于你的密钥背后的套餐,Business 运行在最高一档,因为这一档对 API 的自动化调用最密集。像对待任何 API 一样处理 429 即可:每个响应都带有 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset,429 还会附带 Retry-After,所以退避后重试,你就再也不用操心了。我们不公布确切阈值,因为它是一项动态的防滥用控制,而不是一项承诺。

你们会对 Webhook 负载签名吗?

会。每个 Webhook POST 都带有一个由请求体和你的 Webhook 密钥生成的签名头,你可以在信任负载之前先验证它确实来自我们。文档里介绍了如何校验。投递失败时,我们会以指数退避重试多次后才放弃。