add-book

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):

   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:

   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