amaprice 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 amaprice contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# amaprice
+
+CLI tool to look up and track Amazon product prices.
+
+## Install
+
+```bash
+npm install -g amaprice
+```
+
+## Usage
+
+```bash
+# One-shot price lookup
+amaprice price "https://www.amazon.de/dp/B0DZ5P7JD6"
+
+# JSON output (for scripts / AI agents)
+amaprice price "https://www.amazon.de/dp/B0DZ5P7JD6" --json
+
+# Track a product's price over time
+amaprice track "https://www.amazon.de/dp/B0DZ5P7JD6"
+
+# View price history
+amaprice history B0DZ5P7JD6
+
+# List all tracked products
+amaprice list
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `amaprice price <url>` | One-shot price lookup |
+| `amaprice track <url>` | Track a product's price |
+| `amaprice history <url\|asin>` | Show price history (`--limit N`, default 30) |
+| `amaprice list` | Show all tracked products with latest price |
+
+All commands support `--json` for machine-readable output.
+
+## Requirements
+
+- Node.js >= 18
+- Chromium is installed automatically via Playwright
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const pkg = require('../package.json');
+
+program
+  .name('amaprice')
+  .description('CLI tool to scrape and track Amazon product prices')
+  .version(pkg.version);
+
+// Register commands
+require('../src/commands/price')(program);
+require('../src/commands/track')(program);
+require('../src/commands/history')(program);
+require('../src/commands/list')(program);
+
+program.parse();

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "amaprice",
+  "version": "1.0.0",
+  "description": "CLI tool to scrape and track Amazon product prices",
+  "main": "src/scraper.js",
+  "type": "commonjs",
+  "bin": {
+    "amaprice": "./bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "npx --yes playwright install chromium"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "amazon",
+    "price",
+    "tracker",
+    "scraper",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "playwright": "^1.58.2",
+    "commander": "^13.1.0",
+    "@supabase/supabase-js": "^2.49.4"
+  }
+}

package/src/commands/history.js

@@ -0,0 +1,51 @@
+const { extractAsin } = require('../url');
+const { getPriceHistory } = require('../db');
+const { formatPrice } = require('../format');
+
+module.exports = function (program) {
+  program
+    .command('history <url-or-asin>')
+    .description('Show price history for a product')
+    .option('--limit <n>', 'Number of entries to show', '30')
+    .option('--json', 'Output as JSON')
+    .action(async (urlOrAsin, opts) => {
+      const asin = extractAsin(urlOrAsin);
+      if (!asin) {
+        console.error('Error: Could not extract ASIN from input.');
+        process.exit(1);
+      }
+
+      try {
+        const { product, history } = await getPriceHistory(asin, parseInt(opts.limit, 10));
+
+        if (opts.json) {
+          console.log(JSON.stringify({
+            product: product.title,
+            asin,
+            url: product.url,
+            history: history.map((h) => ({
+              price: parseFloat(h.price),
+              currency: h.currency,
+              scrapedAt: h.scraped_at,
+            })),
+          }));
+        } else {
+          console.log(`Price history for: ${product.title}\n`);
+
+          if (history.length === 0) {
+            console.log('No price history found.');
+            return;
+          }
+
+          for (const entry of history) {
+            const date = new Date(entry.scraped_at).toLocaleString();
+            const price = formatPrice(parseFloat(entry.price), entry.currency);
+            console.log(`  ${date}  ${price}`);
+          }
+        }
+      } catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+      }
+    });
+};

package/src/commands/list.js

@@ -0,0 +1,41 @@
+const { listProducts } = require('../db');
+const { formatPrice } = require('../format');
+
+module.exports = function (program) {
+  program
+    .command('list')
+    .description('Show all tracked products with latest price')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+      try {
+        const products = await listProducts();
+
+        if (opts.json) {
+          console.log(JSON.stringify(products.map((p) => ({
+            asin: p.asin,
+            title: p.title,
+            url: p.url,
+            domain: p.domain,
+            latestPrice: p.latestPrice ? parseFloat(p.latestPrice.price) : null,
+            currency: p.latestPrice?.currency ?? null,
+            lastScraped: p.latestPrice?.scraped_at ?? null,
+          }))));
+        } else {
+          if (products.length === 0) {
+            console.log('No tracked products. Use `amaprice track <url>` to start tracking.');
+            return;
+          }
+
+          for (const p of products) {
+            const price = p.latestPrice
+              ? formatPrice(parseFloat(p.latestPrice.price), p.latestPrice.currency)
+              : 'N/A';
+            console.log(`  ${p.asin}  ${price}  ${p.title}`);
+          }
+        }
+      } catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+      }
+    });
+};

package/src/commands/price.js

@@ -0,0 +1,58 @@
+const { isAmazonUrl } = require('../url');
+const { scrapePrice } = require('../scraper');
+const { upsertProduct, insertPrice } = require('../db');
+
+module.exports = function (program) {
+  program
+    .command('price <url>')
+    .description('One-shot price lookup for an Amazon product')
+    .option('--json', 'Output as JSON')
+    .action(async (url, opts) => {
+      if (!isAmazonUrl(url)) {
+        console.error('Error: URL does not appear to be an Amazon link.');
+        process.exit(1);
+      }
+
+      try {
+        const result = await scrapePrice(url);
+
+        if (opts.json) {
+          console.log(JSON.stringify({
+            product: result.title,
+            price: result.priceRaw ?? 'Not found',
+            priceNumeric: result.price?.numeric ?? null,
+            currency: result.price?.currency ?? null,
+            url: result.url,
+            asin: result.asin,
+            scrapedAt: new Date().toISOString(),
+          }));
+        } else {
+          console.log(`Product: ${result.title}`);
+          console.log(`Price:   ${result.priceRaw ?? 'Not found'}`);
+          console.log(`URL:     ${result.url}`);
+        }
+
+        // Silently record to Supabase for data gathering
+        if (result.price && result.asin) {
+          try {
+            const product = await upsertProduct({
+              asin: result.asin,
+              title: result.title,
+              url: result.url,
+              domain: result.domain,
+            });
+            await insertPrice({
+              productId: product.id,
+              price: result.price.numeric,
+              currency: result.price.currency,
+            });
+          } catch {
+            // Silent — don't disrupt the user experience
+          }
+        }
+      } catch (err) {
+        console.error(`Error scraping price: ${err.message}`);
+        process.exit(1);
+      }
+    });
+};

package/src/commands/track.js

@@ -0,0 +1,59 @@
+const { isAmazonUrl, extractAsin, extractDomain } = require('../url');
+const { scrapePrice } = require('../scraper');
+const { upsertProduct, insertPrice } = require('../db');
+
+module.exports = function (program) {
+  program
+    .command('track <url>')
+    .description('Save product + current price to Supabase')
+    .option('--json', 'Output as JSON')
+    .action(async (url, opts) => {
+      if (!isAmazonUrl(url)) {
+        console.error('Error: URL does not appear to be an Amazon link.');
+        process.exit(1);
+      }
+
+      try {
+        const result = await scrapePrice(url);
+
+        if (!result.price) {
+          console.error('Error: Could not extract price from the page.');
+          process.exit(1);
+        }
+
+        const product = await upsertProduct({
+          asin: result.asin,
+          title: result.title,
+          url: result.url,
+          domain: result.domain,
+        });
+
+        const priceRecord = await insertPrice({
+          productId: product.id,
+          price: result.price.numeric,
+          currency: result.price.currency,
+        });
+
+        if (opts.json) {
+          console.log(JSON.stringify({
+            product: result.title,
+            asin: result.asin,
+            price: result.priceRaw,
+            priceNumeric: result.price.numeric,
+            currency: result.price.currency,
+            productId: product.id,
+            priceRecordId: priceRecord.id,
+            trackedAt: priceRecord.scraped_at,
+          }));
+        } else {
+          console.log(`Tracking: ${result.title}`);
+          console.log(`ASIN:     ${result.asin}`);
+          console.log(`Price:    ${result.priceRaw}`);
+          console.log(`Saved to Supabase.`);
+        }
+      } catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+      }
+    });
+};

package/src/config.js

@@ -0,0 +1,4 @@
+const SUPABASE_URL = 'https://fetgmcukbeetwdahrkhe.supabase.co';
+const SUPABASE_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZldGdtY3VrYmVldHdkYWhya2hlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzE2MTQ2MTQsImV4cCI6MjA4NzE5MDYxNH0.KOymOB5I05eO_MMXyVHkQ2PukXkDIbFVKmukOI71r4Y';
+
+module.exports = { SUPABASE_URL, SUPABASE_KEY };

package/src/db.js

@@ -0,0 +1,92 @@
+const { createClient } = require('@supabase/supabase-js');
+const { SUPABASE_URL, SUPABASE_KEY } = require('./config');
+
+let _client = null;
+
+function getClient() {
+  if (_client) return _client;
+  _client = createClient(SUPABASE_URL, SUPABASE_KEY);
+  return _client;
+}
+
+/**
+ * Upsert a product by ASIN. Returns the product row.
+ */
+async function upsertProduct({ asin, title, url, domain }) {
+  const supabase = getClient();
+  const { data, error } = await supabase
+    .from('products')
+    .upsert({ asin, title, url, domain }, { onConflict: 'asin' })
+    .select()
+    .single();
+  if (error) throw new Error(`Supabase products error: ${error.message}`);
+  return data;
+}
+
+/**
+ * Insert a price record for a product.
+ */
+async function insertPrice({ productId, price, currency }) {
+  const supabase = getClient();
+  const { data, error } = await supabase
+    .from('price_history')
+    .insert({ product_id: productId, price, currency })
+    .select()
+    .single();
+  if (error) throw new Error(`Supabase price_history error: ${error.message}`);
+  return data;
+}
+
+/**
+ * Get price history for a product by ASIN.
+ */
+async function getPriceHistory(asin, limit = 30) {
+  const supabase = getClient();
+  const { data: product, error: pErr } = await supabase
+    .from('products')
+    .select('id, title, url')
+    .eq('asin', asin)
+    .single();
+  if (pErr) throw new Error(`Product not found for ASIN ${asin}: ${pErr.message}`);
+
+  const { data: history, error: hErr } = await supabase
+    .from('price_history')
+    .select('price, currency, scraped_at')
+    .eq('product_id', product.id)
+    .order('scraped_at', { ascending: false })
+    .limit(limit);
+  if (hErr) throw new Error(`Supabase price_history error: ${hErr.message}`);
+
+  return { product, history };
+}
+
+/**
+ * List all tracked products with their latest price.
+ */
+async function listProducts() {
+  const supabase = getClient();
+  const { data: products, error } = await supabase
+    .from('products')
+    .select('id, asin, title, url, domain, created_at')
+    .order('created_at', { ascending: false });
+  if (error) throw new Error(`Supabase products error: ${error.message}`);
+
+  const results = [];
+  for (const product of products) {
+    const { data: prices } = await supabase
+      .from('price_history')
+      .select('price, currency, scraped_at')
+      .eq('product_id', product.id)
+      .order('scraped_at', { ascending: false })
+      .limit(1);
+
+    results.push({
+      ...product,
+      latestPrice: prices?.[0] ?? null,
+    });
+  }
+
+  return results;
+}
+
+module.exports = { getClient, upsertProduct, insertPrice, getPriceHistory, listProducts };

package/src/format.js

@@ -0,0 +1,73 @@
+// Currency symbol → ISO code mapping
+const CURRENCY_MAP = {
+  '€': 'EUR',
+  '$': 'USD',
+  '£': 'GBP',
+  '¥': 'JPY',
+  '₹': 'INR',
+  'R$': 'BRL',
+  'A$': 'AUD',
+  'CA$': 'CAD',
+};
+
+/**
+ * Parse a price string like "€249,00" or "$1,299.99" into structured data.
+ * Returns { display, numeric, currency } or null if unparseable.
+ */
+function parsePrice(raw) {
+  if (!raw || typeof raw !== 'string') return null;
+
+  const trimmed = raw.trim();
+
+  // Detect currency
+  let currency = null;
+  for (const [symbol, code] of Object.entries(CURRENCY_MAP)) {
+    if (trimmed.includes(symbol)) {
+      currency = code;
+      break;
+    }
+  }
+  currency = currency || 'EUR';
+
+  // Extract numeric portion: strip everything except digits, commas, dots
+  const numStr = trimmed.replace(/[^\d.,]/g, '');
+  if (!numStr) return null;
+
+  // Determine decimal separator:
+  // "1.299,00" → comma is decimal (EU)
+  // "1,299.00" → dot is decimal (US)
+  // "249,00"   → comma is decimal (EU)
+  // "249.00"   → dot is decimal (US)
+  let numeric;
+  const lastComma = numStr.lastIndexOf(',');
+  const lastDot = numStr.lastIndexOf('.');
+
+  if (lastComma > lastDot) {
+    // EU format: 1.299,00 or 249,00
+    numeric = parseFloat(numStr.replace(/\./g, '').replace(',', '.'));
+  } else {
+    // US format: 1,299.00 or 249.00
+    numeric = parseFloat(numStr.replace(/,/g, ''));
+  }
+
+  if (isNaN(numeric)) return null;
+
+  return {
+    display: trimmed,
+    numeric,
+    currency,
+  };
+}
+
+/**
+ * Format a numeric price with currency for display.
+ */
+function formatPrice(numeric, currency = 'EUR') {
+  const symbol = Object.entries(CURRENCY_MAP).find(([, c]) => c === currency)?.[0] || '€';
+  if (currency === 'EUR') {
+    return `${symbol}${numeric.toFixed(2).replace('.', ',')}`;
+  }
+  return `${symbol}${numeric.toFixed(2)}`;
+}
+
+module.exports = { parsePrice, formatPrice };

package/src/scraper.js

@@ -0,0 +1,58 @@
+const { chromium } = require('playwright');
+const { parsePrice } = require('./format');
+const { extractAsin, extractDomain } = require('./url');
+
+const PRICE_SELECTORS = [
+  '#corePrice_feature_div .a-price .a-offscreen',
+  '#corePriceDisplay_desktop_feature_div .a-price .a-offscreen',
+  '.a-price .a-offscreen',
+  '#priceblock_ourprice',
+  '#priceblock_dealprice',
+];
+
+/**
+ * Scrape product title and price from an Amazon URL.
+ * Returns { title, priceRaw, price, asin, domain, url }
+ */
+async function scrapePrice(url) {
+  const browser = await chromium.launch({ headless: true });
+  try {
+    const page = await browser.newPage();
+    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+    await page.waitForTimeout(3000);
+
+    // Product title
+    const titleEl = await page.$('#productTitle');
+    const title = titleEl ? (await titleEl.textContent()).trim() : 'Unknown';
+
+    // Price — try selectors in order of specificity
+    let priceRaw = null;
+    for (const sel of PRICE_SELECTORS) {
+      const el = await page.$(sel);
+      if (el) {
+        const text = (await el.textContent()).trim();
+        if (text) {
+          priceRaw = text;
+          break;
+        }
+      }
+    }
+
+    const parsed = parsePrice(priceRaw);
+    const asin = extractAsin(url);
+    const domain = extractDomain(url);
+
+    return {
+      title,
+      priceRaw,
+      price: parsed,
+      asin,
+      domain,
+      url,
+    };
+  } finally {
+    await browser.close();
+  }
+}
+
+module.exports = { scrapePrice };

package/src/url.js

@@ -0,0 +1,40 @@
+const AMAZON_DOMAINS = [
+  'amazon.de', 'amazon.com', 'amazon.co.uk', 'amazon.fr',
+  'amazon.it', 'amazon.es', 'amazon.nl', 'amazon.co.jp',
+  'amazon.ca', 'amazon.com.au', 'amazon.in', 'amazon.com.br',
+];
+
+const ASIN_REGEX = /(?:\/(?:dp|gp\/product|ASIN)\/)([A-Z0-9]{10})/i;
+
+function isAmazonUrl(url) {
+  try {
+    const parsed = new URL(url);
+    return AMAZON_DOMAINS.some((d) => parsed.hostname === d || parsed.hostname === `www.${d}`);
+  } catch {
+    return false;
+  }
+}
+
+function extractAsin(urlOrAsin) {
+  // If it's already a bare ASIN (10 alphanumeric chars)
+  if (/^[A-Z0-9]{10}$/i.test(urlOrAsin)) {
+    return urlOrAsin.toUpperCase();
+  }
+  const match = urlOrAsin.match(ASIN_REGEX);
+  return match ? match[1].toUpperCase() : null;
+}
+
+function extractDomain(url) {
+  try {
+    const parsed = new URL(url);
+    return parsed.hostname.replace(/^www\./, '');
+  } catch {
+    return 'amazon.de';
+  }
+}
+
+function canonicalUrl(asin, domain = 'amazon.de') {
+  return `https://www.${domain}/dp/${asin}`;
+}
+
+module.exports = { isAmazonUrl, extractAsin, extractDomain, canonicalUrl, AMAZON_DOMAINS };