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/<slug>.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