builtwith-official-cli 1.5.1 → 1.5.3

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,6 +87,17 @@ 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
@@ -387,6 +399,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',
@@ -43,8 +44,8 @@ const BASE_URLS = {
   'payment-balance': 'https://payments.builtwith.com/v1/billing/api-discovery',
   'payment-config':  'https://payments.builtwith.com/v1/billing/api-configuration',
   'payment-purchase': 'https://payments.builtwith.com/v1/billing/api-purchase',
-  'agent-auth-start': 'https://api.builtwith.com/agent-auth-start',
-  'agent-auth-token': 'https://api.builtwith.com/agent-auth-token',
+  'agent-auth-start': 'https://api.builtwith.com/agent-auth/start',
+  'agent-auth-token': 'https://api.builtwith.com/agent-auth/token',
 };
 
 /**

package/lib/commands/auth.js

@@ -3,8 +3,8 @@
 const fetch = require('node-fetch');
 const output = require('../output');
 
-const AUTH_START_URL = 'https://api.builtwith.com/agent-auth-start';
-const AUTH_TOKEN_URL = 'https://api.builtwith.com/agent-auth-token';
+const AUTH_START_URL = 'https://api.builtwith.com/agent-auth/start';
+const AUTH_TOKEN_URL = 'https://api.builtwith.com/agent-auth/token';
 const POLL_INTERVAL_MS = 5000;
 const TIMEOUT_MS = 5 * 60 * 1000;
 

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/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.',
@@ -191,6 +203,11 @@ async function callTool(name, args, key, debug) {
       if (args.ldrange)  params.LDRANGE  = args.ldrange;
       return request('domain', params, 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':
       return request('lists', { KEY: key, TECH: args.tech, OFFSET: args.offset || 0, LIMIT: args.limit || 20 }, opts);
     case 'relationships_lookup':

package/package.json

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