dembrandt 0.14.1 → 0.15.0

package/README.md

@@ -59,6 +59,9 @@ Load extractions, track token drift, and compare snapshots. **[dembrandt.com/app
 * **Copy tokens.** Paste values straight into Copilot, Claude, or Cursor.
 * **No login.** Your data stays in the browser, nothing is sent to any server.
 
+## Recipes
+
+**[dembrandt.com/recipes](https://www.dembrandt.com/recipes)** — 38 ready-to-run workflows. Copy a command, paste a prompt, get a result. Covers competitor benchmarking, WCAG audits, CI/CD drift detection, Figma token push, and agentic design system builds. Filterable by role.
 
 ## What to expect from extraction?
 
@@ -84,6 +87,7 @@ dembrandt example.com --mobile         # Use mobile viewport (390x844) for respo
 dembrandt example.com --slow           # 3x longer timeouts (24s hydration) for JavaScript-heavy sites
 dembrandt example.com --brand-guide    # Generate a brand guide PDF
 dembrandt example.com --design-md      # Generate a DESIGN.md file for AI agents
+dembrandt example.com /pricing /docs   # Extract specific paths and merge results into one output
 dembrandt example.com --crawl 5        # Analyze 5 pages (homepage + 4 discovered pages), merges results
 dembrandt example.com --sitemap        # Discover pages from sitemap.xml instead of DOM links
 dembrandt example.com --crawl 10 --sitemap # Combine: up to 10 pages discovered via sitemap

package/index.js

@@ -32,7 +32,7 @@ program
   .description("Extract design tokens from any website")
   .version(version)
   .argument("<url>")
-  .argument("[paths...]", "Additional paths to extract and merge, e.g. /pricing /docs")
+  .argument("[paths...]", "Additional paths on the same domain to extract and merge, e.g. /pricing /docs")
   .option("--browser <type>", "Browser to use (chromium|firefox); set BROWSER_CDP_ENDPOINT env var to connect to an existing Chromium instance via CDP", "chromium")
   .option("--json-only", "Output raw JSON")
   .option("--save-output", "Save JSON file to output folder")
@@ -44,24 +44,19 @@ program
   .option("--design-md", "Export a DESIGN.md file")
   .option("--no-sandbox", "Disable browser sandbox (needed for Docker/CI)")
   .option("--raw-colors", "Include pre-filter raw colors in JSON output")
-  .option("--screenshot <path>", "Save a screenshot of the page")
+  .option("--screenshot <path>", "Save a viewport screenshot of the page (not full-page)")
   .option("--wcag", "Analyze WCAG contrast ratios between palette colors")
-  .option("--crawl [n]", "Auto-discover and extract up to N pages via DOM links (default: 5)", (v) => {
+  .option("--crawl [n]", "Auto-discover and extract up to N pages via DOM links (default: 5); combine with --sitemap to use sitemap discovery instead", (v) => {
     if (v === undefined || v === true) return 5;
     const n = parseInt(v, 10);
     if (isNaN(n) || n < 1) throw new Error(`--crawl must be a positive integer, got: ${v}`);
     return n;
   })
-  .option("--pages <n>", "Alias for --crawl (deprecated)", (v) => {
-    const n = parseInt(v, 10);
-    if (isNaN(n) || n < 1) throw new Error(`--pages must be a positive integer, got: ${v}`);
-    return n;
-  })
-  .option("--sitemap", "Discover pages from sitemap.xml instead of DOM links")
-  .option("--stealth", "Enable anti-detection scripts to bypass bot protection (use only when authorized)")
+  .option("--sitemap", "Discover pages from sitemap.xml instead of DOM links; use alone or combine with --crawl to set page limit")
+  .option("--stealth", "Enable anti-detection: navigator spoofing, human mouse simulation, randomized fingerprint (use only when authorized)")
   .option("--user-agent <string>", "Custom user agent string")
-  .option("--locale <string>", "Browser locale, e.g. en-GB, fi-FI (default: en-US)")
-  .option("--timezone <string>", "Browser timezone, e.g. Europe/Helsinki (default: America/New_York)")
+  .option("--locale <string>", "Browser locale for fingerprint, e.g. en-GB, fi-FI; affects content only if the site reacts to Accept-Language (default: en-US)")
+  .option("--timezone <string>", "Browser timezone for fingerprint, e.g. Europe/Helsinki; affects content only if the site reacts to timezone (default: America/New_York)")
   .option("--accept-language <string>", "Custom Accept-Language header value")
   .option("--screen-size <WxH>", "Physical screen resolution to report, e.g. 1920x1080 (default: 1920x1080)")
   .action(async (input, paths, opts) => {
@@ -126,7 +121,7 @@ program
         }
 
         try {
-          const crawlN = opts.crawl ?? opts.pages ?? null;
+          const crawlN = opts.crawl ?? null;
           const isAutoCrawl = crawlN && !opts.sitemap && (!paths || paths.length === 0);
           const hasExplicitPaths = paths && paths.length > 0;
 
@@ -265,7 +260,7 @@ program
           mkdirSync(outputDir, { recursive: true });
 
           const suffix = opts.dtcg ? '.tokens' : '';
-          const filename = `${timestamp}${suffix}.json`;
+          const filename = `${timestamp}_v${version}${suffix}.json`;
           const filepath = join(outputDir, filename);
           writeFileSync(filepath, JSON.stringify(outputData, null, 2));
 

package/mcp-server.js

@@ -15,9 +15,11 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { chromium } from "playwright-core";
 import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
 import { extractBranding } from "./lib/extractors/index.js";
 
 const { version } = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
+const pwVersion = createRequire(import.meta.url)("playwright-core/package.json").version;
 
 const server = new McpServer({
   name: "dembrandt",
@@ -50,7 +52,7 @@ async function runExtraction(url, options = {}) {
   } catch (err) {
     return {
       ok: false,
-      error: `Browser launch failed. Is Playwright installed? Run: npx playwright install chromium\n\n${err.message}`,
+      error: `Browser launch failed. Install the matching browser: npx playwright@${pwVersion} install chromium\n\n${err.message}`,
     };
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dembrandt",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "description": "Extract design tokens and publicly visible CSS information from any website",
   "mcpName": "io.github.dembrandt/dembrandt",
   "main": "index.js",