Đăng bài từ mã của bạn. Cùng quy trình, bằng lập trình.

Mọi thao tác trên bảng điều khiển đều là một endpoint REST. Đăng bài, lên lịch, tài khoản, phân tích, webhook. Một SDK TypeScript chính chủ. Một máy chủ MCP cho Claude Desktop, Cursor và ChatGPT. Khóa API có phạm vi riêng cho từng không gian làm việc để không gì lọt ra ngoài.

REST API gọn gàng với tài nguyên dễ đoán
SDK TypeScript trên npm, cùng một thư viện PHP độc lập theo giấy phép MIT
Máy chủ MCP cho Claude, Cursor, ChatGPT (14 công cụ)
Khóa API có phạm vi theo từng không gian làm việc và từng thao tác
API trông thực tế ra sao

Ba dòng code. Ba nền tảng đã lên lịch.

Hình dáng thật của một lệnh đăng bài: chọn không gian làm việc, truyền chú thích và nền tảng, nhận lại id bài đăng và trạng thái gửi theo từng nền tảng. Cùng một lệnh từ TypeScript, PHP hoặc 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 })),
});
Phản hồi200 OK · 142ms
ID bài đăngpst_01H7K3MRGB8YZ4QVW
Lượt gửi (3)
Xđã lên lịch · 9:00 sáng thứ Hai UTC
LinkedInđã lên lịch · 9:00 sáng thứ Hai UTC
Blueskyđã lên lịch · 9:00 sáng thứ Hai UTC
SDK TypeScript chính chủ, do chúng tôi duy trì
Phạm vi theo từng khóa: bài đăng, tài khoản, phân tích
Webhook callback cho mọi sự kiện
Cái giá của việc tự chắp nối API của 33 nền tảng

Bạn đã viết xong tích hợp Twitter. Rồi LinkedIn thay đổi mọi thứ.

Bạn làm xong tính năng đăng lên Twitter trong một cuối tuần. Rồi LinkedIn mất ba ngày, luồng OAuth mất một tuần, Instagram có API tệ nhất thế giới, và bạn còn chưa bắt đầu với TikTok.

Mỗi nền tảng hỏng một kiểu vào cùng một ngày. Bluesky đổi giới hạn tần suất. Threads thêm hạn chế loại phương tiện. Hashnode đổi phiên bản GraphQL. Tích hợp của bạn đang cháy trong khi bạn đang phải ra mắt sản phẩm.

Bạn tự viết OAuth cho 5 nền tảng. Bạn lưu refresh token trong cơ sở dữ liệu. Giờ bạn phải chịu trách nhiệm làm mới token, lưu trữ mã hóa và quản lý khóa kiểu SOC 2. Không phải lĩnh vực kinh doanh bạn muốn theo đuổi.

Có phù hợp với bạn không?

API có dành cho bạn?

Phù hợp với bạn nếu

  • Bạn đang xây một sản phẩm cần đăng lên mạng xã hội thay cho người dùng của mình
  • Bạn vận hành một pipeline nội dung chạy từ CI, CRM hoặc backend của riêng bạn
  • Bạn muốn kết nối FoPost với Claude Desktop, Cursor hoặc ChatGPT qua MCP và để agent đăng bài thay bạn
  • Bạn xây công cụ cho agency và muốn cung cấp tính năng đăng mạng xã hội cho khách hàng của mình mà không phải quản lý tích hợp với 33 nền tảng

Không phù hợp nếu

  • Bạn chỉ đăng thủ công từ bảng điều khiển. API là quá mức cần thiết, trình soạn mới là nơi phù hợp.
  • Bạn cần lưu trữ API white-label đầy đủ (your-brand.api.com). Hãy trao đổi với chúng tôi về một thỏa thuận doanh nghiệp.
Có gì bên trong

Một API. 32 nền tảng. Chúng tôi lo phần trục trặc.

Bạn viết theo một schema. Chúng tôi phân phối nó tới 32 nền tảng, làm mới token, xử lý giới hạn tần suất, gửi bài và báo lỗi. Bạn lo ra mắt tính năng.

REST gọn gàng, dễ đoán

Tài nguyên dễ đoán (posts, accounts, workspaces, deliveries, webhooks). Một cấu trúc request và response nhất quán trên mọi endpoint, có phiên bản dưới /v1.

SDK TypeScript, cùng một thư viện PHP độc lập

TypeScript (npm install @fopost/sdk) bao bọc REST API này. PHP (composer require fopost/social-core, giấy phép MIT) là thư viện độc lập: nó đăng trực tiếp lên 11 nền tảng bằng thông tin xác thực của riêng bạn, không cần tài khoản FoPost.

Máy chủ MCP cho trợ lý AI

npx -y @fopost/mcp kết nối không gian làm việc FoPost của bạn với Claude Desktop, Cursor, ChatGPT và mọi agent tương thích MCP. Có 14 công cụ: đăng bài, lên lịch, phân tích, quản lý tài khoản. Xác thực bằng khóa API.

Khóa có phạm vi theo từng không gian làm việc

Khóa riêng cho từng không gian làm việc với phạm vi thao tác: posts, accounts, workspaces, labels, publish, deliveries, webhooks, analytics, automations. JWT cho giao diện, khóa API cho mã. Không có siêu khóa toàn agency.

Webhook gửi đi cho mọi sự kiện

Đăng ký nhận publish.success, publish.failed, account.disconnected, account.reconnected, automation.triggered và nhiều sự kiện khác. Mọi payload đều được ký để bạn xác minh nó đến từ chúng tôi, và các lần gửi thất bại được thử lại với thời gian chờ tăng theo cấp số nhân.

Giới hạn tần suất đủ cho công việc thật

Giới hạn cao hơn nhiều so với nhu cầu của một tích hợp đăng bài, và mức trần tự động tăng khi bạn kết nối thêm tài khoản. Vượt quá thì bạn nhận một mã 429 rõ ràng kèm Retry-After để lùi lại, chứ không bị âm thầm bỏ qua hay khóa key.

Cách hoạt động

Tạo khóa. Cài đặt. Đăng bài.

01

Tạo khóa API

Trong không gian làm việc bạn muốn đăng bài, tạo một khóa API với các phạm vi bạn cần (posts và accounts là đủ để bắt đầu). Sao chép nó một lần. Hãy giữ nó như một bí mật.

02

Cài đặt SDK

npm install @fopost/sdk. Hoặc bỏ qua SDK và gọi thẳng các endpoint REST. Hoặc bỏ qua cả hai và dùng máy chủ MCP từ Claude.

03

Gọi lệnh

Ba dòng: import, khởi tạo, tạo bài. Lệnh đăng trả về id bài đăng và trạng thái gửi theo từng nền tảng. Bài đăng vào hàng đợi trên bảng điều khiển của bạn và được đăng đúng giờ đã lên lịch.

04

Đăng ký webhook (tùy chọn)

Thêm URL webhook trong cài đặt không gian làm việc. Đăng ký publish.success và publish.failed. Endpoint của bạn nhận một POST có chữ ký mỗi khi một lần gửi thành công hoặc thất bại. Giờ hệ thống của bạn luôn đồng bộ.

So với các lựa chọn khác

Vì sao cách này hơn hẳn việc tự viết tích hợp cho 33 nền tảng.

Ba cách lập trình viên đang tiếp cận việc đăng bài đa nền tảng. Chỉ một cách là API thật sự, có SDK, máy chủ MCP và có người khác lo phần trục trặc.

Tự làm: tự tích hợp API của 33 nền tảng

Cách các nhà sáng lập rành kỹ thuật thử làm

  • Luồng OAuth cho từng nền tảng. Lưu token. Làm mới token. Quản lý bí mật được mã hóa.
  • Mỗi nền tảng một giới hạn tần suất, một kiểu lỗi, một ràng buộc phương tiện khác nhau.
  • Khi LinkedIn đổi API, bạn phải sửa mã. Bluesky, Threads, Hashnode cũng vậy.
  • Bạn ngừng thêm nền tảng sau Twitter và LinkedIn. 29 nền tảng còn lại nằm mãi trong danh sách mong muốn.

API của Buffer hoặc Hootsuite

Thứ các ông lớn cung cấp

  • Có API công khai nhưng giống như làm cho có. SDK do cộng đồng duy trì, lúc có lúc không.
  • Không có máy chủ MCP. Kết nối với Claude hay Cursor phải tự tích hợp riêng.
  • Giá tính theo chỗ ngồi khiến API trở thành khoản chi phí với agency.
FoPost

FoPost API + SDK + MCP

Điều bạn thực sự muốn

  • Một schema REST bao trọn 32 nền tảng, và tiện ích trình duyệt lo phần Substack, nền tảng không có API ghi.
  • SDK TypeScript do chúng tôi duy trì, cùng một thư viện PHP theo giấy phép MIT.
  • Máy chủ MCP có ngay hôm nay: npx -y @fopost/mcp vào Claude Desktop, Cursor, ChatGPT.
  • Khóa có phạm vi theo từng không gian làm việc, webhook có chữ ký, thử lại tích hợp sẵn. Chúng tôi lo phần trục trặc.

Đăng lên mọi mạng xã hội lớn

Câu hỏi thường gặp

API có được bao gồm không?

Có, mọi tài khoản đều có toàn quyền đọc và ghi. Endpoint, phạm vi và SDK giống hệt nhau cho tất cả. Mức trần request tự động tăng khi bạn kết nối thêm tài khoản.

Tài liệu tham chiếu API ở đâu?

fopost.com/docs/api có tài liệu tham chiếu đầy đủ kèm mã mẫu bằng TypeScript, PHP và curl cho mọi endpoint.

SDK có mất phí không?

Không. TypeScript (@fopost/sdk) miễn phí trên npm và giao tiếp với API này, vốn có sẵn trong mọi tài khoản. Thư viện PHP (composer require fopost/social-core, giấy phép MIT) miễn phí và độc lập: nó đăng trực tiếp lên 11 nền tảng bằng thông tin xác thực của riêng bạn và hoàn toàn không cần tài khoản FoPost. Nó cũng là nền tảng cho gói Laravel của chúng tôi.

Còn MCP cho Claude, Cursor và ChatGPT thì sao?

Có ngay hôm nay dưới tên @fopost/mcp trên npm. npx -y @fopost/mcp cho bạn một máy chủ MCP qua stdio, trỏ nó tới bất kỳ client tương thích MCP nào (Claude Desktop, Cursor, ChatGPT desktop, Goose, Continue), xác thực bằng FOPOST_API_KEY, và bạn có 14 công cụ: đăng bài, lên lịch, liệt kê bài đăng, lấy số liệu phân tích, quản lý tài khoản và hơn thế nữa.

Phạm vi của khóa API hoạt động thế nào?

Mỗi khóa gắn với một không gian làm việc, cùng danh sách phạm vi thao tác bạn chọn khi tạo: posts, workspaces, accounts, labels, publish, deliveries, webhooks, analytics, automations. Một khóa không có phạm vi "accounts" không thể liệt kê hay sửa tài khoản, kể cả khi người dùng đã cho phép các thao tác đó. Phạm vi được kiểm tra phía máy chủ ở mọi lệnh gọi.

Tôi nên tính đến giới hạn tần suất nào?

Lưu lượng đăng bài thông thường sẽ không chạm gần giới hạn ở bất kỳ gói nào. Mức trần phụ thuộc vào gói gắn với khóa của bạn, và Business có mức cao nhất, vì đó là gói tự động hóa mạnh nhất qua API. Xử lý mã 429 như với bất kỳ API nào: mọi response đều có X-RateLimit-Limit, X-RateLimit-Remaining và X-RateLimit-Reset, mã 429 thêm Retry-After, nên chỉ cần lùi lại rồi thử lại và bạn sẽ không phải nghĩ đến chuyện này nữa. Chúng tôi không công bố ngưỡng chính xác, vì đó là một cơ chế chống lạm dụng thay đổi theo thời gian chứ không phải một cam kết.

Các bạn có ký payload webhook không?

Có. Mỗi POST webhook đều có header chữ ký được tạo từ nội dung và webhook secret của bạn, để bạn xác minh payload đến từ chúng tôi trước khi tin dùng. Tài liệu hướng dẫn cách kiểm tra. Các lần gửi thất bại được thử lại vài lần với thời gian chờ tăng theo cấp số nhân trước khi chúng tôi dừng.