amane/blog-sdk

AMANE Blog Distribution API SDK for PHP

Maintainers

Package info

github.com/amane-app/blog-sdk-php

pkg:composer/amane/blog-sdk

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.1.0 2026-06-22 03:26 UTC

This package is auto-updated.

Last update: 2026-06-22 03:50:20 UTC


README

Latest Version License

公式 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

関連リンク

ライセンス

MIT License — see LICENSE

Copyright (c) 2026 Transonic Software Corporation