README file from
GithubKorean Book Search
A plugin for Obsidian that automatically fills in YAML frontmatter with Korean book information based on the note title.
It uses the Aladin Open API to fetch metadata like title, author, publisher, publication date, cover image, and more.
🚀 New Features
-
v1.4.0:
- Added 'Use High-Quality Cover' Function to settings
-
v1.3.0:
- Added 'pages' to frontmatter fields
-
v1.1.0:
- Added split subtitle and subtitle into separate fields
- Add Korean language support for UI localization
📚 Features
- 📖 Automatically fetch book data using Aladin Open API
- ✍️ Fills YAML frontmatter with title, author, publisher, ISBN, publication date, etc.
- 🧩 Toggle default fields like
myRate,status,startReadDate,finishReadDate - 📋 Add custom frontmatter fields via settings UI
- 🔐 API key is stored securely
🛠️ Installation
Community Plugin (once accepted):
- Go to
Settings → Community Plugins → Browse - Search for Korean Book Search
- Click Install and then Enable
Manual Installation (before registration):
- Clone or download this repository
- Copy the following files to your
.obsidian/plugins/korean-book-search/directory:main.jsmanifest.json- (optional)
styles.css
- Enable the plugin in Obsidian
🔧 Setup
- Go to
Settings → Korean Book Search - Enter your Aladin TTB API key
- (Optional) Toggle the default frontmatter fields you want to include
- (Optional) Add any custom key-value pairs you want to include in frontmatter
🚀 Usage
- Create a new note with the title of a book (e.g.
소년이 온다) - Click the book icon 📖 in the left ribbon
- The plugin will:
- Query the book via Aladin API
- Fetch metadata
- Insert a YAML frontmatter block
- Rename the file to match the book title
🧱 Example Output
---
title: 소년이 온다
subTitle: 2024 노벨문학상 수상작가
author: 한강 (지은이)
publisher: 창비
pages: 216
pubDate: 2014-05-19
isbn: 9788936434120
cover: https://image.aladin.co.kr/...
category: 소설/시/희곡
myRate: 5
status: 읽는 중
startReadDate: 2025-05-13
finishReadDate: 2025-05-13
---
🙋 Author
Developed by @lazerfit
💡 License
MIT