StoryGraph Enhancer

Zero-click autofill from Douban/Libby to StoryGraph: metadata, rating, cover download, and review sync.

スクリプトをインストールするには、Tampermonkey, GreasemonkeyViolentmonkey のような拡張機能のインストールが必要です。

You will need to install an extension such as Tampermonkey to install this script.

スクリプトをインストールするには、TampermonkeyViolentmonkey のような拡張機能のインストールが必要です。

スクリプトをインストールするには、TampermonkeyUserscripts のような拡張機能のインストールが必要です。

このスクリプトをインストールするには、Tampermonkeyなどの拡張機能をインストールする必要があります。

このスクリプトをインストールするには、ユーザースクリプト管理ツールの拡張機能をインストールする必要があります。

(ユーザースクリプト管理ツールは設定済みなのでインストール!)

このスタイルをインストールするには、Stylusなどの拡張機能をインストールする必要があります。

このスタイルをインストールするには、Stylus などの拡張機能をインストールする必要があります。

このスタイルをインストールするには、Stylus tなどの拡張機能をインストールする必要があります。

このスタイルをインストールするには、ユーザースタイル管理用の拡張機能をインストールする必要があります。

このスタイルをインストールするには、ユーザースタイル管理用の拡張機能をインストールする必要があります。

このスタイルをインストールするには、ユーザースタイル管理用の拡張機能をインストールする必要があります。

(ユーザースタイル管理ツールは設定済みなのでインストール!)

このスクリプトの質問や評価の投稿はこちら通報はこちらへお寄せください
作者
locoda
1日のインストール数
0
累計インストール数
5
評価
0 0 0
バージョン
0.1.4
作成日
2026/04/06
更新日
2026/05/16
大きさ
49.7KB
ライセンス
MIT
対象サイト

📚 StoryGraph Enhancer

Version License: MIT Platform

StoryGraph Enhancer is a Tampermonkey userscript designed to move book data from Douban / Libby / Amazon to The StoryGraph with minimal manual effort. It provides a zero-click experience for autofilling metadata, ratings, cover downloads, and review synchronization.

✨ Features

🚀 One-Click Porting

  • Source Integration: Adds a Port to StoryGraph button directly to Douban book pages and Libby title details.
  • Automatic Search: Automatically opens a search tab on The StoryGraph using the book's ISBN, with a title or original title fallback.
  • Data Synchronization: Securely transfers parsed information from source sites to StoryGraph using browser storage to eliminate manual copy-pasting.

🧠 Supported Data Fields (Autofill)

When you land on a StoryGraph "add metadata" or "write review" page, the script automatically populates the following compatible fields:

  • Title & Author
  • Language & Publisher
  • ISBN & Page Count
  • Format & Publication Date
  • Rating & Description
  • Personal Review Text

⚙️ Enhancements & Customization

  • Missing Cover Shortcuts: Detects books with placeholder covers on StoryGraph and injects add metadata and search douban links.
  • Direct Review Editing: Automatically transforms standard review links into direct edit review links to save navigation steps.
  • Smart Mapping: Automatically translates source-specific formats (e.g., mapping "精装" to "hardcover") to match StoryGraph’s classification system.
  • Cover Sync: Includes an optional feature to download high-quality cover images from Douban or Libby for manual upload to StoryGraph.
  • In-Script Settings: A dedicated modal accessible via the Tampermonkey menu to toggle specific automation features and shortcuts.

🛠️ Supported Sites

🚀 Installation

End Users (Recommended)

  1. Ensure you have Tampermonkey installed.
  2. Install the script directly from GreasyFork.
  3. Visit a Douban, Amazon or Libby book page and click Port to StoryGraph.

💻 Local Development

Setup

npm install

Build Commands

  • Standard Build: npm run build

Development Server

Run npm run serve to start a local server. This builds the project continuously and generates dist/dev.user.js, a bootstrap script for quick testing in Tampermonkey.

📂 Project Structure

src/
├── index.ts             # Entry point
├── constants.ts         # Shared constants
├── modules/
│   ├── douban/          # Parser and UI injectors for Douban
│   ├── libby/           # Parser and UI injectors for Libby
│   ├── amazon/          # Parser and UI injectors for Amazon
│   ├── storygraph/      # Autofill logic and shortcuts for SG
│   └── settings.ts      # Settings modal logic
└── utils/
    └── dom.ts           # DOM manipulation helpers

📜 License

This project is licensed under the MIT License. Created by @locoda.

Known Problems

  • Libby ISBN availability: Libby pages commonly do not expose ISBN in the rendered metadata, so Libby transfers intentionally leave ISBN blank.
  • Dynamic DOM changes: Both StoryGraph and Libby are dynamic apps, and occasional UI updates may temporarily break selectors until the userscript is updated.

📝 Wishlist & Upcoming Features

  • [ ] Kobo Support: Add a parser and injector for Kobo Store and Kobo Library pages.
  • [ ] Internationalization (i18n): Add multi-language support for the settings menu and UI notifications.
  • [ ] Improved Edition Matching: Add logic to highlight the best-matching edition on StoryGraph search results based on publisher and page count.