bookfinder-mcp 1.0.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/scraper.ts
+import { chromium } from "playwright-core";
+var BASE_URL = "https://www.bookfinder.com";
+var TIMEOUT = 3e4;
+var CONDITION_MAP = { new: "NEW", used: "USED", all: "ANY" };
+var CHROMIUM_EXECUTABLE_PATH = process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH || void 0;
+function decodeHtmlEntities(s) {
+  return s.replace(/&amp;/g, "&").replace(/&#38;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">");
+}
+async function withBrowser(fn) {
+  const browser = await chromium.launch({
+    headless: true,
+    ...CHROMIUM_EXECUTABLE_PATH ? { executablePath: CHROMIUM_EXECUTABLE_PATH } : {},
+    args: ["--no-sandbox", "--disable-setuid-sandbox"]
+  });
+  try {
+    return await fn(browser);
+  } finally {
+    await browser.close();
+  }
+}
+async function newPage(browser) {
+  const context = await browser.newContext({
+    userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
+    viewport: { width: 1280, height: 800 },
+    locale: "en-US"
+  });
+  return { page: await context.newPage(), context };
+}
+async function searchBooks(query, condition = "all") {
+  const conditionCode = CONDITION_MAP[condition] ?? "ANY";
+  const encoded = encodeURIComponent(query);
+  const url = `${BASE_URL}/search/?keywords=${encoded}&condition=${conditionCode}&currency=CAD&destination=CA&language=en`;
+  return withBrowser(async (browser) => {
+    const { page, context } = await newPage(browser);
+    try {
+      await page.goto(url, { timeout: TIMEOUT, waitUntil: "networkidle" });
+      const html = await page.content();
+      const bunchLinks = [...html.matchAll(/href="(\/search\?[^"]*bunchKey=[^"]+)"/g)].map((m) => decodeHtmlEntities(m[1])).filter((href) => {
+        const val = href.match(/bunchKey=([^&]*)/)?.[1] ?? "";
+        return val.length > 0;
+      });
+      if (bunchLinks.length === 0) {
+        const pageTitle = await page.title().catch(() => "(unknown)");
+        throw new Error(`No results found (page: "${pageTitle}"). Is bookfinder.com reachable?`);
+      }
+      await page.goto(`${BASE_URL}${bunchLinks[0]}`, { timeout: TIMEOUT, waitUntil: "networkidle" });
+      const hasCards = await page.waitForSelector('[data-test-id^="search-offer-card-NON-RENTAL-"]', {
+        timeout: TIMEOUT,
+        state: "attached"
+      }).then(() => true).catch(() => false);
+      if (!hasCards) return [];
+      const cards = await page.$$('[data-test-id^="search-offer-card-NON-RENTAL-"]');
+      const isbnMap = /* @__PURE__ */ new Map();
+      for (const card of cards) {
+        try {
+          const isbn = (await card.getAttribute("data-csa-c-isbn") ?? "").trim();
+          const title = (await card.getAttribute("data-csa-c-title") ?? "").trim();
+          const author = (await card.getAttribute("data-csa-c-authors") ?? "").trim();
+          const priceStr = (await card.getAttribute("data-csa-c-usdprice") ?? "").trim();
+          const cond = (await card.getAttribute("data-csa-c-condition") ?? "").trim().toLowerCase();
+          if (!isbn || !priceStr) continue;
+          const price = parseFloat(priceStr);
+          if (isNaN(price)) continue;
+          const existing = isbnMap.get(isbn);
+          if (!existing || price < existing.price) {
+            isbnMap.set(isbn, { title, author, isbn, price, condition: cond || condition });
+          }
+        } catch {
+          continue;
+        }
+      }
+      return [...isbnMap.values()].slice(0, 20).map((d) => ({
+        title: d.title,
+        author: d.author,
+        isbn: d.isbn,
+        lowest_price: d.price,
+        condition: d.condition
+      }));
+    } finally {
+      await context.close();
+    }
+  });
+}
+async function getPrices(isbn) {
+  const clean = isbn.replace(/-/g, "").trim();
+  if (!/^\d+$/.test(clean)) throw new Error(`Invalid ISBN format: ${isbn}`);
+  const url = `${BASE_URL}/search/?isbn=${clean}&new_used=*&destination=ca&currency=CAD&mode=basic&st=sr&ac=qr`;
+  return withBrowser(async (browser) => {
+    const { page, context } = await newPage(browser);
+    try {
+      await page.goto(url, { timeout: TIMEOUT, waitUntil: "networkidle" });
+      const hasCards = await page.waitForSelector('[data-test-id^="search-offer-card-NON-RENTAL-"]', {
+        timeout: TIMEOUT,
+        state: "attached"
+      }).then(() => true).catch(() => false);
+      if (!hasCards) return [];
+      const cards = await page.$$('[data-test-id^="search-offer-card-NON-RENTAL-"]');
+      const listings = [];
+      for (const card of cards) {
+        try {
+          const seller = (await card.getAttribute("data-csa-c-seller") ?? "").trim();
+          const priceStr = (await card.getAttribute("data-csa-c-usdprice") ?? "").trim();
+          const shippingStr = (await card.getAttribute("data-csa-c-usdshipping") ?? "0").trim();
+          const cond = (await card.getAttribute("data-csa-c-condition") ?? "").trim();
+          const linkEl = await card.$('a[href^="http"]');
+          if (!seller || !priceStr || !linkEl) continue;
+          const buyUrl = (await linkEl.getAttribute("href") ?? "").trim();
+          if (!buyUrl) continue;
+          const price = parseFloat(priceStr);
+          const shipping = parseFloat(shippingStr) || 0;
+          if (isNaN(price)) continue;
+          listings.push({ seller, price, shipping, total: Math.round((price + shipping) * 100) / 100, condition: cond, buy_url: buyUrl });
+        } catch {
+          continue;
+        }
+      }
+      return listings.sort((a, b) => a.total - b.total);
+    } finally {
+      await context.close();
+    }
+  });
+}
+async function getBookDetails(isbn) {
+  const clean = isbn.replace(/-/g, "").trim();
+  if (!/^\d+$/.test(clean)) throw new Error(`Invalid ISBN format: ${isbn}`);
+  const url = `${BASE_URL}/isbn/${clean}/`;
+  return withBrowser(async (browser) => {
+    const { page, context } = await newPage(browser);
+    try {
+      await page.goto(url, { timeout: TIMEOUT, waitUntil: "networkidle" });
+      await page.waitForSelector('meta[itemprop="name"]', { timeout: TIMEOUT, state: "attached" });
+      const title = (await page.$eval('meta[itemprop="name"]', (el) => el.getAttribute("content") ?? "").catch(() => "")).trim();
+      const author = (await page.$eval('meta[itemprop="author"]', (el) => el.getAttribute("content") ?? "").catch(() => "")).trim();
+      if (!title) throw new Error("Could not extract book title from page");
+      const getText = async (selector) => {
+        try {
+          return (await page.$eval(selector, (el) => el.textContent ?? "")).trim() || void 0;
+        } catch {
+          return void 0;
+        }
+      };
+      let publisher;
+      let year;
+      try {
+        const pubRowEl = await page.$('span.font-medium:text("Publisher:")');
+        if (pubRowEl) {
+          const rowText = await pubRowEl.evaluate((el) => el.parentElement?.textContent ?? "");
+          const boldEl = await page.$('span.font-medium:text("Publisher:") + span');
+          if (boldEl) publisher = (await boldEl.textContent() ?? "").trim() || void 0;
+          const yearMatch = rowText.match(/\b(19|20)\d{2}\b/);
+          if (yearMatch) year = parseInt(yearMatch[0]);
+        }
+      } catch {
+      }
+      const edition = await getText('span.font-medium:text("Edition:") + span');
+      const description = await getText("aside .text-sm.leading-relaxed");
+      return { title, author, isbn13: clean, publisher, year, edition, description };
+    } finally {
+      await context.close();
+    }
+  });
+}
+
+// src/index.ts
+var server = new McpServer({ name: "bookfinder", version: "1.0.0" });
+server.tool(
+  "search_books",
+  "Search bookfinder.com by title, author, or ISBN. Returns results with prices in CAD.",
+  { query: z.string(), condition: z.enum(["new", "used", "all"]).optional().default("all") },
+  async ({ query, condition }) => {
+    try {
+      const results = await searchBooks(query, condition ?? "all");
+      return { content: [{ type: "text", text: JSON.stringify(results) }] };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `search_books error: ${msg}` }], isError: true };
+    }
+  }
+);
+server.tool(
+  "get_prices",
+  "Get full price listing across all sellers for a given ISBN. Prices in CAD, sorted cheapest first.",
+  { isbn: z.string() },
+  async ({ isbn }) => {
+    try {
+      const listings = await getPrices(isbn);
+      return { content: [{ type: "text", text: JSON.stringify(listings) }] };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `get_prices error: ${msg}` }], isError: true };
+    }
+  }
+);
+server.tool(
+  "get_book_details",
+  "Get metadata for a book by ISBN: title, author, publisher, year, edition, description.",
+  { isbn: z.string() },
+  async ({ isbn }) => {
+    try {
+      const details = await getBookDetails(isbn);
+      return { content: [{ type: "text", text: JSON.stringify(details) }] };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `get_book_details error: ${msg}` }], isError: true };
+    }
+  }
+);
+var transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "bookfinder-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for searching book prices on bookfinder.com. Runs locally via npx.",
+  "type": "module",
+  "bin": {
+    "bookfinder-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup && chmod +x dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": ["mcp", "bookfinder", "books", "prices"],
+  "author": "jansdhillon",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "playwright-core": "^1.60.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}