antigravity-seo-kit 1.0.0

package/LICENSE

@@ -0,0 +1,88 @@
+COMMERCIAL SOFTWARE LICENSE AGREEMENT
+
+Copyright (c) 2026 nguyendev. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of nguyendev.
+
+BY INSTALLING, COPYING, OR OTHERWISE USING THE SOFTWARE, YOU AGREE TO BE
+BOUND BY THE TERMS OF THIS LICENSE AGREEMENT.
+
+1. GRANT OF LICENSE
+
+   Subject to the terms of this agreement and a valid license key activation,
+   the Licensee is granted a non-exclusive, non-transferable, revocable license
+   to:
+
+   (a) USE the Software on up to three (3) devices per license key;
+   (b) MODIFY the Software for personal or internal business use;
+   (c) USE the Software with Google Antigravity or compatible AI agent
+       platforms for SEO analysis purposes.
+
+2. RESTRICTIONS
+
+   The Licensee may NOT:
+
+   (a) Redistribute, sublicense, sell, rent, lease, or share the Software
+       or any derivative works to third parties;
+   (b) Share, publish, or expose license keys to unauthorized users;
+   (c) Remove, alter, or circumvent license verification mechanisms;
+   (d) Use the Software after license expiration or revocation;
+   (e) Reverse engineer, decompile, or disassemble the license verification
+       system;
+   (f) Create competing products based on the Software;
+   (g) Transfer this license to another individual or entity without prior
+       written consent.
+
+3. DEVICE MANAGEMENT
+
+   (a) Each license key permits activation on up to three (3) devices
+       simultaneously;
+   (b) Devices can be managed (added/removed) through the CLI tool or
+       license management portal;
+   (c) Exceeding the device limit requires either removing existing devices
+       or purchasing additional license keys.
+
+4. INTELLECTUAL PROPERTY
+
+   The Software is protected by copyright laws and international treaties.
+   The Licensee acknowledges that nguyendev retains all rights, title, and
+   interest in and to the Software, including all intellectual property rights.
+
+5. UPDATES AND SUPPORT
+
+   (a) License holders are entitled to Software updates for the duration
+       of their license term;
+   (b) Support is provided through designated channels as specified at
+       time of purchase;
+   (c) nguyendev reserves the right to modify, discontinue, or redesign
+       the Software at any time.
+
+6. TERMINATION
+
+   (a) This license is effective until terminated;
+   (b) It will terminate automatically if the Licensee fails to comply with
+       any term of this agreement;
+   (c) It will terminate upon license key expiration (if applicable);
+   (d) Upon termination, the Licensee must cease using and destroy all
+       copies of the Software.
+
+7. DISCLAIMER OF WARRANTIES
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+8. LIMITATION OF LIABILITY
+
+   IN NO EVENT SHALL NGUYENDEV BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN
+   CONNECTION WITH THE USE OF THE SOFTWARE.
+
+9. GOVERNING LAW
+
+   This agreement shall be governed by and construed in accordance with
+   applicable laws.
+
+For license inquiries and support,
+visit: https://antigravityseokit.solann.io/

package/README.md

@@ -0,0 +1,136 @@
+# SEO Kit for Google Antigravity
+
+> **Professional SEO Analysis Toolkit** — 35 specialized skills organized into a 5-phase SEO lifecycle for comprehensive audits, E-E-A-T analysis, schema markup, GEO optimization, keyword research, audience analysis, AI prompt research, and more. Built for [Google Antigravity](https://deepmind.google/technologies/antigravity/) AI agent platform.
+
+## ⚡ Quick Install
+
+```bash
+npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX
+```
+
+> Purchase a license key at: [https://antigravityseokit.solann.io/](https://antigravityseokit.solann.io/)
+
+## Features
+
+- **35 specialized SEO skills** organized into a 5-phase lifecycle
+- **Master Orchestrator** (`/seo-run`) — auto-detects project phase, suggests next step
+- **Technical SEO Audit** with 9 categories (crawlability, indexability, Core Web Vitals, etc.)
+- **E-E-A-T Content Quality** analysis with Sept 2025 QRG update
+- **Schema Markup** detection, validation, and JSON-LD generation
+- **AI Search Optimization (GEO)** for AI Overviews, ChatGPT, Perplexity
+- **Agentic SEO** audit — Action schema, A2A readiness, API discoverability
+- **Content Strategy** — gap analysis, topical authority, entity SEO, 30/60/90 roadmap
+- **Keyword Research** — seed expansion, volume/difficulty, intent classification, clustering
+- **Audience Analysis** — persona definition, journey mapping, community language mining
+- **AI Prompt Research** — conversational query patterns, multi-turn intent chains
+- **Backlink Analysis** — profile, toxic links, competitor link gap
+- **Local SEO** with GBP, NAP consistency, citations, reviews, Maps intelligence
+- **Programmatic SEO** for pages at scale with quality gates
+- **Google Search Console & Analytics** integration
+- **Auto-Fix Generator** — ready-to-use meta tags, schema, robots.txt, redirects
+- **SEO Experiment Tracking** — A/B tests with baseline/measurement cycle
+- **Extension System** for DataForSEO, Ahrefs, Semrush, and AI image generation
+
+## SEO Lifecycle
+
+```
+📋 ONBOARD → 🔎 RESEARCH → 🔍 AUDIT → 🧠 STRATEGY → ⚡ EXECUTE → 📈 MONITOR → (re-audit)
+```
+
+**Just remember one command:** `/seo-run <domain>` — it guides you through everything.
+
+## Commands
+
+### CLI Commands
+
+```bash
+# Install SEO Kit
+npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX
+
+# Update to latest version
+npx antigravity-seo-kit update
+
+# Check installation status
+npx antigravity-seo-kit status
+
+# List activated devices
+npx antigravity-seo-kit devices
+
+# Remove a device
+npx antigravity-seo-kit devices remove <deviceId>
+
+# Uninstall
+npx antigravity-seo-kit uninstall --confirm
+```
+
+### SEO Workflows (inside Antigravity)
+
+| Workflow | Phase | Skills | Purpose |
+|----------|-------|--------|---------|
+| `/seo-run` | Master | Delegates | Auto-detect phase, suggest next step |
+| `/seo-onboard` | 1 | 4 | Project setup, API check, brand identity, personas |
+| `/seo-research` | Research | 5 | Keyword research, audience, prompt patterns |
+| `/seo-audit` | 2 | 9 | Full website diagnostic, Health Score |
+| `/seo-strategy` | 3 | 10 | Content gaps, entity, authority, roadmap |
+| `/seo-execute` | 4 | 6 | Code fixes, schema, redirects, content |
+| `/seo-monitor` | 5 | 6 | Experiments, AI citability, traffic |
+| `/seo-local-suite` | Special | 2 | Local SEO + Maps intelligence |
+| `/seo-page` | Utility | 4 | Deep single-page analysis |
+
+> **Direct Skill Access**: You can always call any of the 35 skills directly by name (e.g., "Run seo-entity for example.com") without going through the lifecycle.
+
+## System Requirements
+
+- **Node.js** ≥ 18 (for CLI installer)
+- **Python** ≥ 3.11 (for analysis scripts)
+- **Google Antigravity** or compatible AI agent platform
+
+## Setup After Installation
+
+```bash
+# 1. Install Python dependencies
+pip install -r requirements.txt
+
+# 2. (Optional) Install Google API dependencies
+pip install -r requirements-google.txt
+
+# 3. (Optional) Install Playwright for visual analysis
+pip install playwright && playwright install chromium
+
+# 4. Open your workspace in Google Antigravity
+# 5. Start with: /seo-run yourdomain.com
+```
+
+## Extensions
+
+| Extension | What it Adds |
+|-----------|-------------|
+| **DataForSEO** | 22 commands: live SERP, keywords, backlinks, on-page analysis, AI visibility |
+| **Banana Image Gen** | 6 commands: OG image, hero, product, infographic, custom, batch via Gemini AI |
+| **Ahrefs MCP** | DR/UR, backlink quality, content gap, referring domains |
+| **Semrush MCP** | Keyword gap, toxic links, backlink audit, domain analytics |
+
+## License Management
+
+Each license key supports up to **3 devices** simultaneously. Manage your devices:
+
+```bash
+# View activated devices
+npx antigravity-seo-kit devices
+
+# Remove a device to free up a slot
+npx antigravity-seo-kit devices remove <deviceId>
+```
+
+## License
+
+This software is distributed under a **Commercial License**. See [LICENSE](LICENSE) for full terms.
+
+- ✅ Use on up to 3-20 devices per license
+- ✅ Modify for personal/business use
+- ❌ Redistribution prohibited
+- ❌ Sublicensing prohibited
+
+## Support
+
+For license inquiries and support, visit: [https://antigravityseokit.solann.io/](https://antigravityseokit.solann.io/)

package/bin/cli.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { showBanner, showHelp, isValidKeyFormat, error, info, colorize } = require('../lib/utils');
+const installer = require('../lib/installer');
+
+// ─── Parse Arguments ────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const command = args[0];
+const subCommand = args[1];
+
+function getArg(name) {
+  const arg = args.find(a => a.startsWith(`--${name}=`));
+  return arg ? arg.split('=').slice(1).join('=') : null;
+}
+
+function getFlag(name) {
+  return args.includes(`--${name}`);
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────────
+
+async function main() {
+  const cwd = process.cwd();
+
+  try {
+    switch (command) {
+      case 'install': {
+        showBanner();
+        const key = getArg('key');
+        if (!key) {
+          error('License key required.');
+          console.log('');
+          console.log(`  Usage: ${colorize('cyan', 'npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX')}`);
+          console.log('');
+          console.log(`  Purchase: ${colorize('cyan', 'https://antigravity-seokit.solann.io/')}`);
+          process.exit(1);
+        }
+        if (!isValidKeyFormat(key)) {
+          error('Invalid key format. Expected: SK-XXXX-XXXX-XXXX');
+          process.exit(1);
+        }
+        await installer.install(key, cwd);
+        break;
+      }
+
+      case 'update': {
+        showBanner();
+        await installer.update(cwd);
+        break;
+      }
+
+      case 'uninstall': {
+        showBanner();
+        if (!getFlag('confirm')) {
+          console.log(`${colorize('yellow', '⚠️')}  This will remove all SEO Kit files from this workspace.`);
+          console.log(`  Add ${colorize('cyan', '--confirm')} to proceed.`);
+          console.log('');
+          console.log(`  ${colorize('gray', 'npx antigravity-seo-kit uninstall --confirm')}`);
+          process.exit(0);
+        }
+        await installer.uninstall(cwd);
+        break;
+      }
+
+      case 'status': {
+        showBanner();
+        await installer.status(cwd);
+        break;
+      }
+
+      case 'devices': {
+        showBanner();
+        if (subCommand === 'remove') {
+          const deviceId = args[2];
+          await installer.deviceRemove(cwd, deviceId);
+        } else {
+          await installer.devices(cwd);
+        }
+        break;
+      }
+
+      case 'help':
+      case '--help':
+      case '-h': {
+        showHelp();
+        break;
+      }
+
+      case '--version':
+      case '-v': {
+        const pkg = require('../package.json');
+        console.log(pkg.version);
+        break;
+      }
+
+      default: {
+        showHelp();
+        if (command) {
+          error(`Unknown command: "${command}"`);
+        }
+        break;
+      }
+    }
+  } catch (err) {
+    console.log('');
+    error(`Unexpected error: ${err.message}`);
+    if (process.env.DEBUG) {
+      console.error(err.stack);
+    }
+    process.exit(1);
+  }
+}
+
+main();

package/lib/api.js

@@ -0,0 +1,207 @@
+'use strict';
+
+const https = require('https');
+const http = require('http');
+const { PACKAGE_VERSION } = require('./utils');
+
+// ─── Configuration ──────────────────────────────────────────────────────────
+
+// TODO: Replace with your actual license server URL
+const DEFAULT_API_URL = process.env.SEO_KIT_API_URL || 'https://app.solann.io/api/seo-kit/';
+
+function getApiUrl() {
+  // Ensure trailing slash so new URL('licenses/verify', base) resolves correctly
+  const url = DEFAULT_API_URL.replace(/\/+$/, '');
+  return url + '/';
+}
+
+function getUserAgent() {
+  return `antigravity-seo-kit/${PACKAGE_VERSION} node/${process.version} ${process.platform}`;
+}
+
+// ─── HTTP Client ────────────────────────────────────────────────────────────
+
+/**
+ * Make an HTTP(S) request. Returns parsed JSON response.
+ * Uses only Node.js built-in modules (no dependencies).
+ */
+function request(method, urlPath, { body = null, licenseKey = null, timeout = 15000 } = {}) {
+  return new Promise((resolve, reject) => {
+    const baseUrl = getApiUrl();
+    const fullUrl = new URL(urlPath, baseUrl);
+
+    const isHttps = fullUrl.protocol === 'https:';
+    const transport = isHttps ? https : http;
+
+    const headers = {
+      'User-Agent': getUserAgent(),
+      'Accept': 'application/json',
+    };
+
+    if (licenseKey) {
+      headers['X-License-Key'] = licenseKey;
+    }
+
+    if (body) {
+      headers['Content-Type'] = 'application/json';
+    }
+
+    const options = {
+      hostname: fullUrl.hostname,
+      port: fullUrl.port || (isHttps ? 443 : 80),
+      path: fullUrl.pathname + fullUrl.search,
+      method: method.toUpperCase(),
+      headers,
+      timeout,
+    };
+
+    const req = transport.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const parsed = data ? JSON.parse(data) : {};
+          if (res.statusCode >= 200 && res.statusCode < 300) {
+            resolve({ status: res.statusCode, data: parsed });
+          } else {
+            reject(new ApiError(
+              parsed.error?.message || parsed.message || `HTTP ${res.statusCode}`,
+              res.statusCode,
+              parsed
+            ));
+          }
+        } catch (e) {
+          reject(new ApiError(`Invalid JSON response: ${data.substring(0, 200)}`, res.statusCode));
+        }
+      });
+    });
+
+    req.on('error', (err) => {
+      if (err.code === 'ECONNREFUSED') {
+        reject(new ApiError('Cannot connect to license server. Please check your internet connection.', 0));
+      } else if (err.code === 'ENOTFOUND') {
+        reject(new ApiError('License server not found. DNS resolution failed.', 0));
+      } else {
+        reject(new ApiError(`Network error: ${err.message}`, 0));
+      }
+    });
+
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new ApiError('Request timed out. Please try again.', 0));
+    });
+
+    if (body) {
+      req.write(JSON.stringify(body));
+    }
+
+    req.end();
+  });
+}
+
+// ─── API Error ──────────────────────────────────────────────────────────────
+
+class ApiError extends Error {
+  constructor(message, statusCode, responseData = null) {
+    super(message);
+    this.name = 'ApiError';
+    this.statusCode = statusCode;
+    this.responseData = responseData;
+  }
+
+  get isNetworkError() { return this.statusCode === 0; }
+  get isNotFound() { return this.statusCode === 404; }
+  get isForbidden() { return this.statusCode === 403; }
+  get isUnauthorized() { return this.statusCode === 401; }
+}
+
+// ─── License API Methods ────────────────────────────────────────────────────
+
+/**
+ * Verify a license key and activate the current device.
+ *
+ * POST /licenses/verify
+ * Body: { licenseKey, deviceId, deviceName }
+ *
+ * Response: {
+ *   valid: true,
+ *   license: { plan, expiresAt, ... },
+ *   devicesUsed: 2,
+ *   maxDevices: 3,
+ *   devices: [{ deviceId, deviceName, activatedAt }]
+ * }
+ */
+async function verifyLicense(licenseKey, deviceId, deviceName) {
+  const { data } = await request('POST', 'licenses/verify', {
+    body: { licenseKey, deviceId, deviceName },
+  });
+  return data;
+}
+
+/**
+ * Get license status and info.
+ *
+ * GET /licenses/status
+ */
+async function getLicenseStatus(licenseKey) {
+  const { data } = await request('GET', 'licenses/status', { licenseKey });
+  return data;
+}
+
+/**
+ * List all activated devices for a license.
+ *
+ * GET /licenses/devices
+ */
+async function listDevices(licenseKey) {
+  const { data } = await request('GET', 'licenses/devices', { licenseKey });
+  return data;
+}
+
+/**
+ * Remove a device from the license.
+ *
+ * DELETE /licenses/devices/:deviceId
+ */
+async function removeDevice(licenseKey, deviceId) {
+  const { data } = await request('DELETE', `licenses/devices/${deviceId}`, { licenseKey });
+  return data;
+}
+
+/**
+ * Check for the latest release version.
+ *
+ * GET /releases/latest
+ */
+async function getLatestRelease() {
+  const { data } = await request('GET', 'releases/latest');
+  return data;
+}
+
+/**
+ * Get the download URL for SEO Kit assets.
+ * The seokit-web server serves a .tar.gz archive after verifying the license key.
+ *
+ * Default: https://antigravityseokit.solann.io/api/seo-kit/releases/download
+ * Override: SEO_KIT_ASSETS_URL environment variable
+ *
+ * GET /releases/download?version=x.y.z
+ * Header: X-License-Key
+ */
+function getAssetsDownloadUrl(version) {
+  const base = process.env.SEO_KIT_ASSETS_URL || 'https://antigravityseokit.solann.io/api/seo-kit/';
+  return `${base}releases/download?version=${encodeURIComponent(version)}`;
+}
+
+// ─── Exports ────────────────────────────────────────────────────────────────
+
+module.exports = {
+  verifyLicense,
+  getLicenseStatus,
+  listDevices,
+  removeDevice,
+  getLatestRelease,
+  getAssetsDownloadUrl,
+  ApiError,
+  getApiUrl,
+};