README

公式 PHP SDK for the AMANE Blog Distribution API.

AMANE が AI で自動生成した SEO 記事を、顧客の corporate サイトや blog サイトに pull して公開できます。

必要要件

• PHP 8.1+
• Composer

インストール

composer require amane/blog-sdk

使い方

クライアント初期化

use Amane\BlogSdk\AmaneClient;

$client = new AmaneClient(
    apiUrl: 'https://service.amane.app',
    apiToken: 'amb_xxxxxxxxxxxxx',  // AMANE 管理画面で発行
);

配信可能な記事一覧を取得

$articles = $client->articles()->list();
foreach ($articles['data'] as $article) {
    echo $article['title'] . "\n";
}

記事詳細を取得 (= delivered ステータスに遷移)

$article = $client->articles()->fetch('art_01HF3ABC...');
echo $article['content_html'];      // HTML 本文
echo $article['content_markdown'];  // Markdown 本文

公開報告 (= 顧客サイトで公開した時に呼ぶ)

$client->publication()->report(
    articleId: 'art_01HF3ABC...',
    publishedUrl: 'https://customer.example.com/blog/article-slug',
    publishedAt: new DateTimeImmutable(),
);

効果計測結果取得 (= 公開後 14 日以降)

$perf = $client->performance()->get('art_01HF3ABC...');
echo "verdict: {$perf['data']['verdict']}\n";
echo "position improvement: {$perf['data']['delta']['position_improvement']}\n";

API トークンの発行

1. AMANE 管理画面 (https://service.amane.app) にログイン
2. Site 詳細 → 「📝 ブログ配信」タブ
3. API トークン発行 (= 表示は 1 度だけ、コピーしておく)

トークンの形式: amb_ プレフィックス + 48 桁の hex

関連リンク

• API 仕様 (OpenAPI 3.0)
• JavaScript/TypeScript SDK
• WordPress プラグイン
• プロダクトサイト

ライセンス

MIT License — see LICENSE

Copyright (c) 2026 Transonic Software Corporation