Auto_Bangumi/docs/ja/dev/plugins/points/metadata-provider.md

メタデータソース (metadata_provider)

新しい作品のルールを保存する前に、AB は RSS 購読の「パーサー」の値でメタデータソースを選びます。ソースは正式タイトル、シーズン、年、ポスターを補完します。mikan と tmdb が組み込みです。@provider(points.METADATA_PROVIDER, id=...) で新しい値を追加できます。購読の追加時に、「パーサー」の一覧に表示されます。

from dataclasses import replace

from ab_sdk import Plugin, points, provider
from ab_sdk.ingest import Metadata, MetadataRequest


class BangumiTv:
    async def enrich(self, request: MetadataRequest) -> Metadata | None:
        info = await search(request.current.official_title)  # 自前の実装
        if info is None:
            return None  # 変更なし
        return replace(request.current, official_title=info.name, poster_link=info.cover)


class MyPlugin(Plugin):
    @provider(points.METADATA_PROVIDER, id="bangumi-tv")
    def bgm(self):
        return BangumiTv()

• request.kind は作品（bangumi）と映画（movie）を区別します。request.torrent.homepage はトレントの詳細ページ、request.language は言語設定です。
• 完全な新しい Metadata を返します。通常は request.current を変更して作ります。None は変更なしです。
• 失敗またはタイムアウトの場合、AB は元の値を保持し、失敗はブレーカーに数えられます。