builtwith-official-cli 1.5.3 → 1.5.5

package/README.md

@@ -101,14 +101,18 @@ 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

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

@@ -51,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)' },
       },
@@ -208,8 +219,20 @@ async function callTool(name, args, key, debug) {
       if (args.since) params.SINCE = args.since;
       return request('change', params, opts);
     }
-    case 'lists_tech':
-      return request('lists', { KEY: key, TECH: args.tech, OFFSET: args.offset || 0, LIMIT: args.limit || 20 }, 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.3",
+  "version": "1.5.5",
   "description": "Non-interactive, scriptable CLI for the BuiltWith API",
   "main": "lib/cli.js",
   "bin": {