builtwith-official-cli 1.5.0 → 1.5.1

package/README.md

@@ -181,6 +181,19 @@ bw vector search "react framework"
 bw vector search "ecommerce platform" --limit 20
 ```
 
+### 🔐 Auth
+
+Obtain a temporary `bw-` prefixed API token via browser approval — no API key needed to run this command.
+
+```bash
+bw auth login
+```
+
+Flow:
+1. Prints a `builtwith.com` URL — open it in your browser and click **Approve**
+2. Polls automatically every 5 seconds
+3. Prints the `access_token` (`bw-...`) on approval — use it as `BW_API_KEY`
+
 ### 💳 Payment
 
 Manage API credits autonomously.
@@ -391,6 +404,8 @@ If your API key isn't in an env var or `.builtwithrc`, pass it inline:
 | `payment_purchase` | 🛒 Purchase API credits (minimum 2000) |
 | `account_whoami` | 👤 Authenticated account identity |
 | `account_usage` | 📊 API usage statistics |
+| `agent-auth-start` | 🔐 Start Device-Code Authorization (no API key required) |
+| `agent-auth-token` | 🔐 Poll for authorization result and access token (no API key required) |
 
 ### 🔬 Implementation note
 

package/lib/client.js

@@ -43,8 +43,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;
 
@@ -60,18 +60,18 @@ module.exports = function registerAuth(program) {
           process.exit(1);
         }
 
-        if (tokenRes.status === 'approved' && tokenRes.access_token) {
+        if (tokenRes.access_token) {
           process.stderr.write('\n\n');
           output.print({ access_token: tokenRes.access_token, message: 'Authorization approved. Use this token as your BW_API_KEY.' }, { format: opts.format });
           return;
         }
 
-        if (tokenRes.status === 'denied') {
+        if (tokenRes.error === 'access_denied') {
           process.stderr.write('\n');
           output.error('Authorization was denied by the user.');
           process.exit(1);
         }
-        // status === 'pending' — keep polling
+        // error === 'authorization_pending' — keep polling
       }
 
       process.stderr.write('\n');

package/package.json

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