技術スタックに合ったパッケージを選ぶ
TypeScript SDKは、ホスト型のFoPost APIを完全な型付きでラップします。PHPコアとLaravelラッパーはMITライセンスで、自社のサーバーから自社のプラットフォーム認証情報で直接投稿します。WordPressプラグインは、セルフホストのサイトをワークスペースに接続します。それ以外はOpenAPI仕様から生成できます。
import { FoPost } from '@fopost/sdk';
const client = new FoPost({ apiKey: process.env.FOPOST_API_KEY });
const [workspace] = await client.workspaces.list();
const accounts = await client.accounts.list({ workspaceId: workspace.id });
const post = await client.posts.create({
workspaceId: workspace.id,
status: 'scheduled',
scheduleAt: '2026-09-01T09:00:00Z',
content: [{ text: 'Shipped a new release today.' }],
accounts: accounts.map((a) => ({ id: a.id })),
});TypeScript、完全な型付き
すべてのエンドポイント、リクエストボディ、レスポンスに型があります。ドキュメントを読む代わりに補完が教えてくれます。
アカウント不要のPHP
コアとLaravelのパッケージは自社のサーバーで動き、ホスト型のアカウントは必要ありません。
OpenAPI仕様
API自体から配信されるため、生成したクライアントが本番とずれることはありません。
API全体を型付きメソッドで
@fopost/sdkは、投稿、配信、アカウント、ワークスペース、ラベル、そしてAIによるキャプション生成、書き換え、再活用のヘルパーをカバーします。Nodeとエッジランタイムで動作し、一時的なエラーを再試行し、レート制限のヘッダーを返すので間隔を空けられます。MCPサーバーもこのSDKの上に作られています。
SDKのドキュメントを読むconst deliveries = await client.posts.deliveries(post.id);
for (const d of deliveries) {
console.log(d.platform, d.status, d.external_url);
}
const health = await client.accounts.health(accounts[0].id);
console.log(health);すべてのリソース
クライアントオブジェクトは1つ、エンドポイントごとにメソッドが1つ。最初から最後まで型付きです。
再試行とバックオフ
ネットワークの一時的な不調や429は、エラーとして届く前に再試行されます。
MCPと同じコア
@fopost/mcpはこのSDKを使っているため、エージェントとスクリプトの動作は同じです。
自社の認証情報でPHPから投稿
fopost/social-coreは、ネットワークごとのアダプターを備え、フレームワークに一切依存しない単体の投稿ライブラリです。fopost/social-laravelは、サービスプロバイダー、ファサード、イベント、キューのサポートを追加します。どちらもホスト型の製品とは通信せず、用意したプラットフォームの認証情報で直接投稿します。
PHPパッケージを見るuse Fopost\Social\Laravel\Facades\FopostSocial;
$result = FopostSocial::linkedin('Shipped a new release today.');
if ($result->success) {
logger()->info("Published: {$result->externalUrl}");
}MITライセンス、自社サーバーで
Composerでインストールするだけ。アカウントもキーも不要で、こちら側の利用制限もありません。
Laravelとの連携
設定、ファサード、イベント、キュー経由の投稿をすぐに使えます。
同じ整形ルール
文字数制限とメディアの扱いは、ホスト型のアダプターと同じです。
WordPressにはプラグイン、それ以外には仕様を
WordPressプラグインは、スコープ付きのサイトトークンでセルフホストのサイトをワークスペースに接続し、FoPostで作成した投稿をサイトに反映します。ほかの言語向けには、OpenAPI仕様をAPIからライブで配信しています。ジェネレーターに読み込ませれば、現在デプロイされている内容と一致するクライアントが手に入ります。
開発を始めるcurl https://api.fopost.com/v1/openapi.json -o openapi.json
npx @openapitools/openapi-generator-cli generate \
-i openapi.json -g python -o ./clientWordPressプラグイン
プラグインディレクトリで無料公開中。サイトトークンを貼り付ければ、サイトに投稿できます。
ライブの仕様
GET /v1/openapi.jsonは、常に稼働中のAPIを記述しています。
どの言語でも
Python、Go、Rubyなど、OpenAPIジェネレーターがある言語ならどれでも。