Catalog books from photos or text. Trigger on: book photo, catalog book, log book, add to library.
--- name: book-id description: "Catalog books from photos or text. Trigger on: book photo, catalog book, log book, add to library." --- # Book Cataloger ## ICM Contract | | | |---|---| | **Layer 3 inputs** | `SOUL.md` (32-property book schema) | | **Layer 4 inputs** | Photo from `media/inbound/` or user-provided text | | **Process** | Identify book → web search OpenLibrary/Wikipedia → check for duplicates in `Files/Books/` → write note → save photo → run fix-md.sh | | **Layer 4 outputs** | `Files/Books/Title - Author.md`, photo saved to `Files/Photos/Books/Title - Author.jpg` → vault-push to `HumanVault/Knowledge Atlas/Outside Knowledge/Books/` | --- ## STEP 0 — READ THE COVER FIRST (mandatory before anything else) A photo was provided. Before doing anything: 1. Look at the book cover in the image 2. Read the TITLE exactly as printed on the cover 3. Read the AUTHOR exactly as printed on the cover 4. State them explicitly: "I can see: Title = X, Author = Y" If you cannot read the cover clearly → say "I cannot read the cover. Please send a clearer photo." DO NOT proceed. NEVER catalog a book you have not confirmed from the image. NEVER guess or substitute another book. --- ## NON-NEGOTIABLE: WRITE ALL 32 PROPERTIES Every single one of the 32 properties below MUST appear in the output, in exact order. Empty value = leave blank after the colon. DO NOT omit any property line. A note with missing properties is BROKEN. Obsidian will silently fail. WRONG — omitting unknowns: ```yaml type: book title: The Stranger author: - "Camus, Albert" tags: - book ``` WRONG — inline arrays: ```yaml author: ["Camus, Albert"] tags: [book, fiction] ``` RIGHT — all 32 properties, 2-space indent lists, blanks included: ```yaml type: book title: The Stranger subtitle: original_title: L'Étranger author: - "Camus, Albert" translator: publisher: Vintage International year: 1989 year_original: 1942 edition: isbn_13: "9780679720201" isbn_10: pages: 123 language: English original_language: French format: Paperback series: genre: - fiction category: subjects: - absurdism audience: Adult condition: status: owned rating: cover: https://covers.openlibrary.org/b/isbn/9780679720201-L.jpg date_added: 2026-04-22 wikipedia: https://en.wikipedia.org/wiki/The_Stranger_(Camus_novel) goodreads: https://www.goodreads.com/book/show/49552.The_Stranger openlibrary: https://openlibrary.org/works/OL46933W aliases: cssclass: book tags: - book - fiction - author/camus ``` WRITE THE BODY SECTION TOO. Do not skip it. The body section is mandatory. ## WORKFLOW 1. **READ THE COVER** — state title and author explicitly (Step 0 above) 2. Web search: title + author on OpenLibrary, Wikipedia, Goodreads 3. Check workspace/Files/Books/ for duplicates (title + author match) 4. If duplicate: tell Pooh. If new: write file. 5. Save to: `workspace/Files/Books/Title - Author.md` (filename format: Title first, then Author, ASCII only) Save photo: cp "/home/node/.openclaw/media/inbound/[FILE]" "/home/node/.openclaw/workspace/Files/Photos/Books/Title - Author.jpg" 6. Run: bash /home/node/.openclaw/workspace/fix-md.sh "[FILEPATH]" 7. Reply with the full file path and a one-line summary 8. Ask: "Push to vault? (yes/no)" — do NOT push unless Pooh confirms ## FRONTMATTER TEMPLATE - COPY EXACTLY --- type: book title: "Book Title" subtitle: original_title: author: - "LastName, FirstName" translator: publisher: year: 1956 year_original: edition: isbn_13: isbn_10: pages: 147 language: Spanish original_language: format: Paperback series: genre: - "Fiction" - "Philosophy" category: subjects: - "French literature" audience: Adult condition: status: owned rating: cover: date_added: 2026-04-06 wikipedia: goodreads: openlibrary: aliases: cssclass: book tags: - book - fiction - author/camus --- ## BODY TEMPLATE - COPY EXACTLY # Title **By** [[LastName, FirstName]] **Published** YEAR by Publisher **Format** Paperback | **Language** Spanish ## Synopsis 2-3 sentences about the book from web search. ## About the Author [[LastName, FirstName]] 1-2 sentence bio from web search. ## Details | Field | Value | | --- | --- | | Publisher | Name | | Pages | 000 | | Language | Language | | Format | Format | | ISBN | 0000000000000 | ## Themes Keywords: theme1, theme2, theme3. ## Personal Notes Photo: [[Photos/Books/Title - Author.jpg]] ## Quotes ## Related - [[Related Book]] ## CRITICAL REMINDERS - author MUST be a list: 2-space indent, dash, space, quoted name - genre MUST be a list: 2-space indent, dash, space, quoted genre - tags MUST be a list: 2-space indent, dash, space, lowercase no quotes - status: always "owned" - cssclass: always "book" - rating: always empty - year and pages: numbers only, no quotes - No parentheses () or brackets [] in any values - Filenames: `Title - Author.md` format — Title first, then Author. ASCII only, no accents. - Leave blank for unknown. NEVER write "Unknown" - ALWAYS web search before writing ## COVER IMAGE 1. Search: https://openlibrary.org/search.json?title=[TITLE]&author=[AUTHOR]&limit=5 2. Verify title AND author match in results 3. Build URL: https://covers.openlibrary.org/b/isbn/[ISBN]-M.jpg or /b/id/[COVER_ID]-M.jpg 4. Any size works (-S, -M, -L) — pick whichever is clear and available 5. Exact edition match is ideal, but a generic relevant cover is acceptable 6. ONLY use OpenLibrary URLs. NEVER Amazon, Google, or descriptions. 7. If no covers exist at all on OpenLibrary, leave cover: blank ## FORBIDDEN - No parentheses () or brackets [] in property values - No accented characters in filenames - No "Unknown" or "N/A" anywhere - No guessing. If unsure, ASK Pooh. - No skipping web search - No writing author/genre/tags as plain strings instead of lists
don't have the plugin yet? install it then click "run inline in claude" again.