bookakaku-mcp

MCP (Model Context Protocol) server for Yomitaku - Japanese book search, price comparison, and library availability.

Tools

| Tool | Description | |------|-------------| | search_books | Search Japanese books by ISBN or keyword | | get_book_prices | Compare prices across Amazon, Rakuten, Yahoo Shopping | | check_library_availability | Check availability at public libraries by prefecture/city | | get_book_details | Full book metadata + all prices in one call |

Setup

Claude Desktop / Claude Code

{
  "mcpServers": {
    "bookakaku": {
      "command": "npx",
      "args": ["bookakaku-mcp"]
    }
  }
}

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | BOOKAKAKU_API_URL | https://www.yomitaku.com | API base URL |

For local development against a Rails server:

{
  "mcpServers": {
    "bookakaku": {
      "command": "npx",
      "args": ["bookakaku-mcp"],
      "env": {
        "BOOKAKAKU_API_URL": "http://localhost:3000"
      }
    }
  }
}

Example Usage

Once configured, ask your AI assistant:

• "Find the cheapest copy of 吾輩は猫である"
• "Search for books about Ruby programming"
• "Is ISBN 9784101010014 available at libraries in Osaka?"
• "Compare prices for 9784532168308"

API

This MCP server calls the public JSON API at www.yomitaku.com:

• GET /api/books/search?q=QUERY&page=1 - Book search
• GET /books/{isbn}/amazon_data - Amazon pricing
• GET /books/{isbn}/rakuten_data - Rakuten pricing
• GET /books/{isbn}/yahoo_data - Yahoo Shopping pricing
• GET /books/{isbn}/library_search?prefecture=X&city=Y - Library availability

No API keys required. Prices are cached for 24 hours.

License

MIT