amane / blog-sdk
AMANE Blog Distribution API SDK for PHP
v0.1.0
2026-06-22 03:26 UTC
Requires
- php: ^8.1
- guzzlehttp/guzzle: ^7.0
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 トークンの発行
- AMANE 管理画面 (https://service.amane.app) にログイン
- Site 詳細 → 「📝 ブログ配信」タブ
- API トークン発行 (= 表示は 1 度だけ、コピーしておく)
トークンの形式: amb_ プレフィックス + 48 桁の hex
関連リンク
ライセンス
MIT License — see LICENSE
Copyright (c) 2026 Transonic Software Corporation