Amazon.co.jp の Kindle 蔵書から購入済みシリーズを検出し、次巻候補の価格・割引率・発売日をまとめて表示する Chrome / Firefox 拡張を作って公開しました。
Zenn に同じ拡張の紹介記事を書いています。こちらはモジュール設計と実装の詰まりどころに絞った内容です。
原文：Kindleの続刊セールを見逃さないためにChrome拡張を作った
拡張の概要
- Chrome Web Store: https://chromewebstore.google.com/detail/kindle-series-sale-tracke/aiemlodfimjjbeejdghomifkhhhaekfm
- Firefox Add-ons: https://addons.mozilla.org/ja/firefox/addon/kindle-series-sale-tracker/
- GitHub: https://github.com/harness17/kindle-series-sale-tracker
操作は「Kindle 一覧を開く」→「このページをスキャン」の2ステップです。Amazon.co.jp にログインした状態で実行すると、購入済み Kindle 本の一覧を取得し、次巻候補を検索して一覧表示します。
モジュール構成と分けた理由
extension/shared/ に3つのモジュールを置いています。
| モジュール | 責務 |
|---|---|
kindle-library.js |
Amazon デジタルコンソールの Ajax から蔵書一覧を取得・正規化 |
catalog-probe.js |
Amazon 商品検索で続刊候補を取得・シリーズ照合 |
series-card.js |
UI カードの生成 |
蔵書取得は Amazon のデジタルコンソールのページ構造に依存していて、Amazon 側の変更で壊れる前提があります。続刊の商品検索は別の原因で壊れるため、同じモジュールに混ぜると原因の切り分けが難しくなります。壊れ方を局所化するために分けました。
書誌データの正規化（kindle-library.js）
Amazon の書誌には全角英数と HTML エンティティの二重エンコードが混在しています。タイトルの表記ゆれをそのままにするとシリーズ照合がずれるため、kindle-library.js に正規化処理を集約しています。
// 全角英数を半角に正規化（例：「２巻」→「2巻」）
function normalizeAsciiAlphanumerics(value) {
return String(value ?? '').replace(/[０-９Ａ-Ｚａ-ｚ]/g, (ch) =>
String.fromCharCode(ch.charCodeAt(0) - 0xfee0)
);
}
// & のような二重エンコードを変化しなくなるまで復号する（最大5回）
function decodeHtmlEntities(value) {
let current = String(value ?? '');
for (let i = 0; i < 5; i += 1) {
const next = decodeOnce(current);
if (next === current) break;
current = next;
}
return current;
}
上限5回は暴走防止です。単一エンコードに対しては冪等で動作します。
シリーズ照合の実装（catalog-probe.js）
スピンオフの誤判定を防ぐ
部分一致でシリーズを判定すると、スピンオフを同一シリーズと誤判定します。たとえば「小林さんちのメイドラゴン」を部分一致のキーにすると、スピンオフの「エルマのOL日記」も続刊として拾われます。正規化した seriesKey の完全一致のみに絞りました。
// 完全一致のみ。末尾のハイフン・波線類を除去してから比較する
function sameSeries(a, b) {
if (!a || !b) return false;
const normalizeKey = (value) =>
kdl.normalizeSeriesKey(value).replace(/\s+/g, '').replace(/[-‐－―—~～]+$/g, '');
const na = normalizeKey(a);
const nb = normalizeKey(b);
return na !== '' && na === nb;
}
単話版の除外
単話版（1話ずつの分冊配信）を除外しないと、完結済みの作品でも話数を追って延々と「続刊あり」と表示されます。
// 単話版・分冊版を続刊候補から除外する
// 判定は加工前の rawTitle で行う（stripNoise で除去される前の文字列）
function isSplitVolumeEdition(rawTitle) {
return /単話|分冊|話売り/.test(String(rawTitle || ''));
}
タイトル正規化の前の rawTitle で判定しているのは、stripNoise で「【単話版】」が消える前でないと判定できないためです。
別レーベル版の除外
所有しているレーベルと異なるレーベルの候補は除外します。
// 所有レーベルと候補レーベルが両方あり、かつ異なるときだけ除外する
// 片方が空（情報不足）なら拾う（改題・改称の取りこぼし最小化）
function isDifferentImprint(ownedImprint, candidateImprint) {
return Boolean(ownedImprint) && Boolean(candidateImprint) && ownedImprint !== candidateImprint;
}
検証スクリプト
本番コードを変更するたびに3つの検証スクリプトを使っています。
node .\verify-kindle-library.mjs # 蔵書取得・正規化のロジック
node .\verify-catalog-probe.mjs # シリーズ照合・フィルタのロジック
node .\verify-series-card.mjs # カード生成のロジック
fixture と照合して回帰を確認する構成で、Amazon 側の変更で壊れたとき、どのモジュールが原因かをすぐに絞り込めます。
公開状況
Chrome Web Store に Manifest V3 対応で審査を出し、通過しました。Firefox 版も Firefox Add-ons の審査を通過し、同じ拡張を公開しています。
リポジトリ: https://github.com/harness17/kindle-series-sale-tracker