---
name: books
version: 1.0.0
description: "CLI for AI agents to search and lookup books for their humans. Uses Open Library API. No auth required."
homepage: https://openlibrary.org
metadata:
  openclaw:
    emoji: "📚"
    requires:
      bins: ["bash", "curl", "jq"]
    tags: ["books", "reading", "open-library", "literature", "cli"]
---

# Book Lookup

CLI for AI agents to search and lookup books for their humans. "What's that fantasy series about the magic university?" — now your agent can answer.

Uses Open Library API. No account or API key needed.

## Usage

```
"Search for books called The Name of the Wind"
"Find books by Patrick Rothfuss"
"Tell me about work ID OL27448W"
"Who is author OL23919A?"
```

## Commands

| Action | Command |
|--------|---------|
| Search | `books search "query"` |
| Get book details | `books info <work_id>` |
| Get author info | `books author <author_id>` |

### Examples

```bash
books search "the name of the wind"     # Find books by title
books search "author:brandon sanderson" # Search by author
books info OL27448W                     # Get full details by work ID
books author OL23919A                   # Get author bio and works
```

## Output

**Search output:**
```
[OL27448W] The Name of the Wind — Patrick Rothfuss, 2007, ⭐ 4.5
```

**Info output:**
```
📚 The Name of the Wind
   Work ID: OL27448W
   First Published: March 27, 2007
   Subjects: Fantasy, Magic, Coming of Age

📖 Description:
[Full description text]

🖼️ Cover: https://covers.openlibrary.org/b/id/12345-L.jpg
```

**Author output:**
```
👤 Patrick Rothfuss
   Born: June 6, 1973
   Author ID: OL23919A

📖 Bio:
[Author biography]

=== Works ===
[OL27448W] The Name of the Wind, 2007
[OL16313124W] The Wise Man's Fear, 2011
```

## Notes

- Uses Open Library API (openlibrary.org)
- No authentication required
- Work IDs look like: OL27448W
- Author IDs look like: OL23919A
- Search supports `author:`, `title:`, `subject:` prefixes
- Cover images available in S, M, L sizes

---

## Agent Implementation Notes

**Script location:** `{skill_folder}/books` (wrapper to `scripts/books`)

**When user asks about books:**
1. Run `./books search "title or author"` to find work ID
2. Run `./books info <work_id>` for full details
3. Run `./books author <author_id>` for author info and bibliography

**Search tips:**
- Use `author:name` to search specifically by author
- Use `title:name` to search specifically by title
- Use `subject:topic` to search by genre/subject

**Don't use for:** E-books, audiobooks, purchasing, or reading the actual content.