builtwith-official-cli 1.5.2 → 1.5.5

package/README.md

@@ -5,6 +5,7 @@
 ```bash
 bw domain lookup shopify.com --format table
 bw domain lookup shopify.com --nopii | jq '.Results[0].Technologies[].Name'
+bw change lookup shopify.com --since "last month"
 bw live feed --duration 60 > events.ndjson
 bw mcp   # start MCP server for Claude Desktop, VS Code, etc.
 ```
@@ -86,17 +87,32 @@ bw domain lookup shopify.com --nopii --liveonly | jq '.Results[0].Technologies[]
 bw domain lookup shopify.com --fdrange 20240101-20241231
 ```
 
+### 🔄 Change
+
+```bash
+bw change lookup <domain[,domain2]> [--since <date>]
+```
+
+```bash
+bw change lookup shopify.com
+bw change lookup shopify.com,builtwith.com --since "last month"
+```
+
 ### 📋 Lists
 
 ```bash
-bw lists tech <tech> [--offset <n>] [--limit <n>]
+bw lists tech <tech> [--other-techs <names>] [--country <codes>] [--since <date>] [--revenue <filter>] [--spend <filter>] [--offset <n>] [--limit <n>]
 ```
 
 ```bash
 bw lists tech WordPress
 bw lists tech Shopify --limit 50 --offset 100
+bw lists tech Google-Analytics --other-techs Meta-Pixel
+bw lists tech Shopify --revenue "100000|GT" --spend "100|GTE" --country US
 ```
 
+Lists numeric filters use `number|operator`, where operator is `EQ`, `LT`, `LTE`, `GT`, or `GTE`. Supported attribute filters include `--spend`, `--revenue`, `--sku`, `--followers`, `--employees`, `--sitemap`, `--page-rank`, `--bw-rank`, `--tranco`, `--majestic`, `--bws`, `--ecat`, `--aim`, `--aio`, `--air`, and `--aiv`.
+
 ### 🔗 Relationships
 
 ```bash
@@ -387,6 +403,7 @@ If your API key isn't in an env var or `.builtwithrc`, pass it inline:
 | Tool | Description |
 |---|---|
 | `domain_lookup` | 🌐 Technology stack for a domain (supports `nopii`, `liveonly`, date ranges) |
+| `change_lookup` | 🔄 Technology additions and removals for one or more domains |
 | `lists_tech` | 📋 Domains currently using a technology |
 | `relationships_lookup` | 🔗 Related domains (shared infra, ownership) |
 | `free_lookup` | 🆓 Free-tier category counts for a domain |

package/lib/cli.js

@@ -24,6 +24,7 @@ function run() {
 
   // Register all command modules
   require('./commands/domain')(program);
+  require('./commands/change')(program);
   require('./commands/lists')(program);
   require('./commands/relationships')(program);
   require('./commands/free')(program);

package/lib/client.js

@@ -25,6 +25,7 @@ function scanForInjection(data) {
 
 const BASE_URLS = {
   domain:          'https://api.builtwith.com/v22/api.json',
+  change:          'https://api.builtwith.com/change1/api.json',
   lists:           'https://api.builtwith.com/lists12/api.json',
   relationships:   'https://api.builtwith.com/rv4/api.json',
   free:            'https://api.builtwith.com/free1/api.json',

package/lib/commands/change.js

@@ -0,0 +1,35 @@
+'use strict';
+
+const { requireKey } = require('../config');
+const { request } = require('../client');
+const { validateInput } = require('../validate');
+const output = require('../output');
+const ora = require('ora');
+
+module.exports = function registerChange(program) {
+  const change = program.command('change').description('Technology additions and removals');
+
+  change
+    .command('lookup <domains>')
+    .description('Get technology additions and removals for one or more comma-separated domains')
+    .option('--since <date>', 'Natural language date window (default: 3 months, e.g. "last month")')
+    .action(async (domainsArg, cmdOpts) => {
+      const opts = program.opts();
+      if (opts.noColor) output.setNoColor(true);
+      const key = requireKey(opts.key);
+      validateInput(domainsArg, 'domains');
+      if (cmdOpts.since) validateInput(cmdOpts.since, 'since');
+
+      const params = { KEY: key, LOOKUP: domainsArg };
+      if (cmdOpts.since) params.SINCE = cmdOpts.since;
+
+      const spinner = opts.quiet ? null : ora({ text: `Fetching changes for ${domainsArg}...`, stream: process.stderr }).start();
+      try {
+        const data = await request('change', params, { dryRun: opts.dryRun, debug: opts.debug, spinner });
+        output.print(data, { format: opts.format, fields: opts.fields });
+      } catch (err) {
+        if (spinner) spinner.stop();
+        throw err;
+      }
+    });
+};

package/lib/commands/lists.js

@@ -7,15 +7,45 @@ const { validateInput, validatePosInt } = require('../validate');
 const output = require('../output');
 const ora = require('ora');
 
+const ATTRIBUTE_FILTERS = [
+  ['spend', 'SPEND', 'Monthly technology spend filter, e.g. 100|GT'],
+  ['revenue', 'REVENUE', 'Estimated ecommerce sales revenue filter, e.g. 100000|GT'],
+  ['sku', 'SKU', 'Product count filter, e.g. 1000|GTE'],
+  ['followers', 'FOLLOWERS', 'Followers filter, e.g. 5000|GTE'],
+  ['employees', 'EMPLOYEES', 'Employee count filter, e.g. 50|GTE'],
+  ['sitemap', 'SITEMAP', 'Sitemap URL count filter, e.g. 100|GT'],
+  ['pageRank', 'PAGERANK', 'Page rank filter, e.g. 1000000|LT'],
+  ['bwRank', 'BWRANK', 'BuiltWith rank filter, e.g. 50000|LTE'],
+  ['tranco', 'TRANCO', 'Tranco rank filter, e.g. 100000|LTE'],
+  ['majestic', 'MAJESTIC', 'Majestic rank filter, e.g. 100000|LTE'],
+  ['bws', 'BWS', 'BuiltWith score filter, e.g. 50|GTE'],
+  ['ecat', 'ECAT', 'Ecommerce category id filter, e.g. 123|EQ'],
+  ['aim', 'AIM', 'AI maturity filter, e.g. 50|GTE'],
+  ['aio', 'AIO', 'AI openness filter, e.g. 50|GTE'],
+  ['air', 'AIR', 'AI readiness filter, e.g. 50|GTE'],
+  ['aiv', 'AIV', 'AI visibility filter, e.g. 50|GTE'],
+];
+
 module.exports = function registerLists(program) {
   const lists = program.command('lists').description('Technology lists');
 
-  lists
+  const techCommand = lists
     .command('tech <tech>')
     .description('Get list of sites using a technology')
+    .option('--other-techs <names>', 'Comma-separated additional required technologies')
+    .option('--country <codes>', 'Comma-separated country filters, e.g. US,CA')
+    .option('--since <date>', 'Date or relative time filter, e.g. "30 days ago"')
     .option('--offset <n>', 'Result offset', '0')
     .option('--limit <n>', 'Max results', '20')
-    .action(async (tech, cmdOpts) => {
+    .option('--meta', 'Include metadata')
+    .option('--all', 'Include historical sites');
+
+  for (const [, apiName, description] of ATTRIBUTE_FILTERS) {
+    const optionName = apiName.toLowerCase().replace('pagerank', 'page-rank').replace('bwrank', 'bw-rank');
+    techCommand.option(`--${optionName} <filter>`, description);
+  }
+
+  techCommand.action(async (tech, cmdOpts) => {
       const opts = program.opts();
       if (opts.noColor) output.setNoColor(true);
       const key = requireKey(opts.key);
@@ -23,6 +53,26 @@ module.exports = function registerLists(program) {
       const offset = validatePosInt(cmdOpts.offset, 'offset');
       const limit = validatePosInt(cmdOpts.limit, 'limit');
       const params = { KEY: key, TECH: tech, OFFSET: offset, LIMIT: limit };
+      if (cmdOpts.otherTechs) {
+        validateInput(cmdOpts.otherTechs, 'otherTechs');
+        params.OTHERTECHS = cmdOpts.otherTechs;
+      }
+      if (cmdOpts.country) {
+        validateInput(cmdOpts.country, 'country');
+        params.COUNTRY = cmdOpts.country;
+      }
+      if (cmdOpts.since) {
+        validateInput(cmdOpts.since, 'since');
+        params.SINCE = cmdOpts.since;
+      }
+      if (cmdOpts.meta) params.META = 'yes';
+      if (cmdOpts.all) params.ALL = 'yes';
+      for (const [optionKey, apiName] of ATTRIBUTE_FILTERS) {
+        if (cmdOpts[optionKey]) {
+          validateInput(cmdOpts[optionKey], optionKey);
+          params[apiName] = cmdOpts[optionKey];
+        }
+      }
 
       if (opts.params) {
         let extra;

package/lib/commands/mcp.js

@@ -32,6 +32,18 @@ const TOOLS = [
       required: ['domain'],
     },
   },
+  {
+    name: 'change_lookup',
+    description: 'Get technology additions and removals for one or more domains using the BuiltWith Change API.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        domains: { type: 'string', description: 'Domain or comma-separated domains to look up' },
+        since: { type: 'string', description: 'Natural language date window, e.g. "last month"' },
+      },
+      required: ['domains'],
+    },
+  },
   {
     name: 'lists_tech',
     description: 'Get a list of domains currently using a specific technology.',
@@ -39,6 +51,17 @@ const TOOLS = [
       type: 'object',
       properties: {
         tech:   { type: 'string',  description: 'Technology name (e.g. "WordPress", "Shopify")' },
+        otherTechs: { type: 'string', description: 'Comma-separated additional required technologies, max 16' },
+        country: { type: 'string', description: 'Comma-separated country filters, e.g. US,CA' },
+        since: { type: 'string', description: 'Date or relative time filter, e.g. "30 days ago"' },
+        spend: { type: 'string', description: 'Monthly technology spend filter, e.g. 100|GT' },
+        revenue: { type: 'string', description: 'Estimated ecommerce sales revenue filter, e.g. 100000|GT' },
+        employees: { type: 'string', description: 'Employee count filter, e.g. 50|GTE' },
+        filters: {
+          type: 'object',
+          description: 'Additional Lists API attribute filters keyed by API parameter name, e.g. {"SKU":"1000|GTE","AIM":"50|GTE"}',
+          additionalProperties: { type: 'string' },
+        },
         offset: { type: 'number', description: 'Result offset for pagination (default 0)' },
         limit:  { type: 'number', description: 'Number of results (default 20)' },
       },
@@ -191,8 +214,25 @@ async function callTool(name, args, key, debug) {
       if (args.ldrange)  params.LDRANGE  = args.ldrange;
       return request('domain', params, opts);
     }
-    case 'lists_tech':
-      return request('lists', { KEY: key, TECH: args.tech, OFFSET: args.offset || 0, LIMIT: args.limit || 20 }, opts);
+    case 'change_lookup': {
+      const params = { KEY: key, LOOKUP: args.domains };
+      if (args.since) params.SINCE = args.since;
+      return request('change', params, opts);
+    }
+    case 'lists_tech': {
+      const params = { KEY: key, TECH: args.tech, OTHERTECHS: args.otherTechs, OFFSET: args.offset || 0, LIMIT: args.limit || 20 };
+      if (args.country) params.COUNTRY = args.country;
+      if (args.since) params.SINCE = args.since;
+      if (args.spend) params.SPEND = args.spend;
+      if (args.revenue) params.REVENUE = args.revenue;
+      if (args.employees) params.EMPLOYEES = args.employees;
+      if (args.filters && typeof args.filters === 'object') {
+        for (const [filterKey, filterValue] of Object.entries(args.filters)) {
+          params[filterKey.toUpperCase()] = filterValue;
+        }
+      }
+      return request('lists', params, opts);
+    }
     case 'relationships_lookup':
       return request('relationships', { KEY: key, LOOKUP: args.domain }, opts);
     case 'free_lookup':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "builtwith-official-cli",
-  "version": "1.5.2",
+  "version": "1.5.5",
   "description": "Non-interactive, scriptable CLI for the BuiltWith API",
   "main": "lib/cli.js",
   "bin": {