---
name: add-book
description: Add a new book to the documentation collection. Use when user provides a URL to a book page or tweet linking to one.
argument-hint: [url]
---

# Add new book

Add a new book to the documentation collection.

## Input

- URL to a book (Amazon, publisher page, etc.) or to a tweet/discussion about the book

## Steps

1. **Check browser is activated**:
   - Call `tabs_context_mcp` to verify browser connection
   - If it fails, ask the user to enable browser:
     - VS Code: Ensure Chrome extension is connected
     - CLI: Run `claude --chrome` or type `/chrome`

2. **Find the canonical book page**: If the input URL is:
   - A tweet (x.com or twitter.com): Use browser to navigate to the tweet, take a screenshot, and extract the book link
   - An Amazon page: Use that URL
   - A publisher page: Use that URL
   - Other: Use the provided URL

   **Important**: For Twitter/X and sites requiring JavaScript, use browser automation instead of WebFetch.

3. **Extract book information**:
   - **Title**: The full book title
   - **Author(s)**: The book author(s)
   - **Description**: A concise summary (1-3 paragraphs) describing what the book covers and who it's for

   **For pages requiring browser**: Use `navigate` to open the page, then `get_page_text` or `read_page` to extract content. If CAPTCHA appears, ask the user to complete it manually.

4. **Determine category**: Based on the extracted content, automatically determine the category:
   - **Trading/Finance** (goes to `source/learn/books.rst`) - for books about algorithmic trading, quantitative finance, portfolio management, risk management, market microstructure, etc.
   - **AI/ML** (goes to `source/learn/ai-and-machine-learning.rst`) - for books primarily about machine learning, deep learning, neural networks, or AI techniques applied to trading

   Only ask the user if the content is ambiguous (e.g., equally about ML techniques AND trading strategies). If clearly one category, proceed without asking.

5. **Add to the appropriate .rst file**: Use this exact format (matching existing entries):

   ```rst
   Title of the Book
   -----------------

   Description paragraph(s) here. Keep it informative but concise.

   `Buy the book <https://amazon-or-publisher-url-here>`__
   ```

   Or for free books:

   ```rst
   Title of the Book
   -----------------

   Description paragraph(s) here.

   `Read the book <https://url-here>`__
   ```

   Important formatting notes:
   - The underline of dashes must be at least as long as the title
   - There should be a blank line after the title underline
   - There should be a blank line before the "Buy/Read the book" link
   - The link format uses double underscores at the end: `__`
   - Use "Buy the book" for paid books (Amazon, etc.) and "Read the book" or "Read more" for free resources
   - Add the new entry BEFORE the "Further reading lists" section in books.rst

If the source of the link is a discussion like a tweet, then include a paragraph with a link to that tweet with the comment "Mentioned by XXX in this discussion" and include what they say about it.

6. **Commit and push**:
   - Stage the modified file
   - Commit with message: "Add: {Book Title}"
   - Push to master branch

7. **Save as PDF**: Follow the procedure in **README-browser.md > PDF Generation > How it works** with:
   - SELECTOR: `'#bookDescription_feature_div' || 'article' || 'main'`
   - FILENAME: `<slugified-title>.pdf`