Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Book Metasearch

bonghobongho3k downloads

Book note maker with metasearch across Aladin, Kakao, Google Books, and Open Library. Successor to anpigon/obsidian-book-search-plugin (Naver EOL 2026-08-01).

Add to Obsidian
  • Overview
  • Scorecard
  • Updates15

Book note maker with metasearch across YES24 · Kakao · Google Books · Open Library, queried in parallel. Korean-first with foreign fallback.

Successor to anpigon/obsidian-book-search-plugin (unmaintained). Built to solve the Naver Book Search API EOL (2026-08-01) and provide a proper Korean-first book note workflow.

Install

From the community plugin directory:

  1. In Obsidian, open Settings → Community plugins
  2. Turn off Restricted mode if enabled
  3. Click Browse and search for Book Metasearch
  4. Click Install, then Enable

Features

Core (v1.0)

  • 4-provider metasearch: YES24 (Korean primary) · Kakao (Korean recall) · Google Books (foreign primary) · Open Library (foreign covers/ISBN)
  • Two strategies: Sequential fallback (default) or parallel Fanout with ISBN13 dedupe
  • Commands: Search books · Search by ISBN · Search based on current note · Update book info · Migration helper
  • Template file support with {{variable}} substitution (including {{credit}} and {{tableOfContents}}; a required source credit is appended automatically if the template omits it) — Templater <% %> blocks are preserved for post-creation execution
  • Frontmatter customization: useDefaultFrontmatter toggle · key case (as-is / camelCase / snake_case / kebab-case) · additional YAML fragment with {{variable}} substitution
  • Cover image download to a configurable folder
  • 37 ISO 639-1 locale codes for cross-provider language filtering
  • API keys kept in Obsidian's keychain, not in the plugin's data.json
  • Settings are searchable from Obsidian's own settings search
  • Cover thumbnails in search results (opt-in)
  • Naver EOL migration: opt-in helper detects an existing obsidian-book-search-plugin config and guides users through Aladin setup

v1.1 additions

  • Auto-filled Abstract / Description section — new notes get the provider's book description written into the ## Abstract / Description block (HTML stripped). "Update book info in current note" refreshes it while preserving edits outside the auto-block markers.
  • ISBN13 vault-wide duplicate detection — before creating a note, the plugin scans the vault. On match, DuplicateModal offers: open existing / update existing / create anyway / cancel. Backed by an incremental VaultBookIndex.
  • Reading Log — three commands ("Mark book as wishlist / reading / read") with automatic startedAt / finishedAt date stamping (idempotent). New notes get a configurable initial status (default: wishlist).
  • Insert book citation at cursor — editor command that emits a wikilink to an existing vault note (if any) or an unresolved link. Two link styles.
  • Aladin used-book price check (opt-in) — surfaces used-book minimum prices as a Notice or appended ## Price Watch section.
  • Redacted error diagnostics — healthcheck / migration failures auto-write a diagnostics note with secrets masked, so users can attach it to bug reports.

See CHANGELOG.md for the full v1.1.0 changelog.

Provider setup

Only YES24 and Kakao require API keys (both free, instant issuance). Google Books works without a key at a lower rate limit. Open Library needs no auth.

Provider Auth Free tier Where to get a key
YES24 API Key (required) 20,000/day developers.yes24.com
Kakao REST API Key (required) 30,000/day developers.kakao.com
Google Books API Key (optional) 1,000/day with key, low limit without Google Cloud Console — enable Books API first
Open Library No auth Effectively unlimited —
Aladin TTB Key 5,000/day API shut down 2026-10-30 — see below

After installing, open Settings → Book Metasearch → Providers, paste keys, and hit Healthcheck on each provider.

Aladin OpenAPI shutdown

Aladin announced the end of its Open API: new key issuance stopped 2026-09-04, and existing keys stop working 2026-10-30. YES24 is now the Korean primary provider, and it covers everything Aladin supplied plus a table of contents and physical dimensions.

If you already hold a working TTB Key, the Aladin provider keeps functioning until the shutdown date — it is simply no longer first in priorityOrder. Move yes24 into your provider order and add a YES24 key when convenient; the Aladin code is removed in v2.0.0, after the shutdown.

The one feature with no replacement is the used-book price check — no Korean bookstore exposes used listings through an API, and all three block the corresponding pages in robots.txt. It goes away with the Aladin provider.

Attribution

  • YES24: 도서 정보 제공: YES24, linked to the product page (yes24.com)
  • Aladin: Book DB by Aladin (aladin.co.kr)

The YES24 credit is required, not optional, and has no toggle. Its Open API FAQ makes two things a condition of use: 「도서 정보가 노출되는 화면에 예스24 출처 표기」 and 「도서 상세 정보 또는 구매 관련 영역에서 예스24 상품 상세페이지로 연결」. Notes built from YES24 data therefore carry a footer crediting YES24 and linking the product page. If you add a buy link for another retailer, the YES24 product link has to stay visible alongside it.

The Aladin OpenAPI general-tier terms don't strictly mandate a credit link, but keeping the "Book DB by Aladin" footer in generated notes is the polite (and forward-compatible if you ever upgrade to the premium tier). Leave the credit toggle on unless you have a specific reason. That toggle governs Aladin only.

Storing what you look up is fine — the same FAQ allows caching 「서비스 제공에 필요한 범위 내에서」, which is what a book note is. What it does not allow is harvesting the catalogue into a database of your own, or redistributing the data. Keep that in mind before scripting bulk imports.

Development

Prerequisites: Node 22.12+, npm.

git clone https://github.com/bongho/obsidian-book-metasearch.git
cd obsidian-book-metasearch
npm install

# dev — build directly into your vault's plugin folder
export VAULT_PLUGIN_DIR="/path/to/your/vault/.obsidian/plugins/book-metasearch"
mkdir -p "$VAULT_PLUGIN_DIR"
cp manifest.json styles.css "$VAULT_PLUGIN_DIR/"
OUTDIR="$VAULT_PLUGIN_DIR" npm run dev

# production build
npm run build

For hot-reload, install pjeby/hot-reload via BRAT and create an empty .hotreload file in the plugin folder.

License

MIT © 2026 BongHo Lee

HealthExcellent
ReviewPassed
About
Book note maker with metasearch across YES24, Kakao, Google Books, and Open Library. Korean-first with foreign fallback; covers the Naver (2026-08-01) and Aladin (2026-10-30) book API shutdowns.
ImportTemplatingImages
Details
Current version
1.6.1
Last updated
Last week
Created
4 months ago
Updates
15 releases
Downloads
3k
Compatible with
Obsidian 1.13.2+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Sponsor
Buy Me a Coffee
Author
bonghobongho
github.com/bongho
GitHubbongho
  1. Community
  2. Plugins
  3. Import
  4. Book Metasearch

Related plugins

Weread

Sync Tencent Weread highlights and annotations.

Kindle Highlights

Sync your Kindle book highlights using your Amazon login or uploading your My Clippings file.

Make It Rain

Pull Raindrop.io bookmarks, highlights, and attachments into Markdown notes with rich metadata, smart folder structures, and native file support.

Importer

Convert your data to Markdown files you can use in Obsidian. Works with Apple Notes, OneNote, Evernote, Notion, Google Keep, and many other formats.

Templater

Create and use dynamic templates.

QuickAdd

Quickly add new notes or content to your vault.

TTRPG Tools - Maps

A toolbox for interactive fantasy maps.

YTranscript

Easily fetch transcription for any YouTube video.

Folder notes

Create notes within folders that can be accessed without collapsing the folder, similar to the functionality offered in Notion.

Ink

Handwriting and drawing directly between paragraphs using a digital pen, stylus, or Apple pencil.