| name | book-to-post |
| description | Search for books using Google Books API (by title or ISBN) and generate a Hugo markdown post with book metadata including cover, description, author, etc. Use when the user provides a book title or ISBN. |
| allowed-tools | Bash, Read, Write, Glob |
Book to Hugo Post (Google Books API)
使用 Google Books API 搜尋書籍，自動抓取書名、作者、封面、簡介等資訊，
並產生一篇 Hugo content/books/<slug>.md 文章。
Runtime
- Python via
uv run - Do NOT use system python or pip
Inputs
- query: 書名或 ISBN（必填）
- --isbn: 將查詢視為 ISBN（可選，預設為書名搜尋）
- --outdir: 輸出目錄（預設 content/books）
- --slug: 手動指定 slug（可選）
- --title: 手動覆蓋文章 title（可選）
Outputs
- Hugo Markdown 檔案：content/books/
.md - 包含：書名、作者、ISBN、出版社、出版日期、封面、Google Books 連結、簡介
Command
ALWAYS execute using:
# 用書名搜尋
uv run --project .claude/skills/book-to-post .claude/skills/book-to-post/book2post.py "書名"
# 用 ISBN 搜尋
uv run --project .claude/skills/book-to-post .claude/skills/book-to-post/book2post.py "ISBN" --isbn
Never use:
- python book2post.py
- pip install
- uv run without --project flag
Examples
# 搜尋書名
uv run --project .claude/skills/book-to-post .claude/skills/book-to-post/book2post.py "Effective Java"
# 搜尋 ISBN
uv run --project .claude/skills/book-to-post .claude/skills/book-to-post/book2post.py "9780134685991" --isbn
# 指定輸出目錄
uv run --project .claude/skills/book-to-post .claude/skills/book-to-post/book2post.py "Clean Code" --outdir content/reading
Notes
- Dependencies are resolved via pyproject.toml
- Assume uv is available
- Uses Google Books API (no API key required)
- Returns the first/best match from search results