antigravity-seo-kit 2.0.0

package/extensions/dataforseo/install.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# DataForSEO Extension Installer for SEO Kit
+# Wraps everything in main() to prevent partial execution on network failure
+
+main() {
+    SKILL_DIR=".agent/skills/seo-dataforseo"
+    AGENT_DIR=".agent/skills"
+    SEO_SKILL_DIR=".agent/skills/seo"
+    SETTINGS_FILE="MCP_settings_path"
+
+    echo "════════════════════════════════════════"
+    echo "║   DataForSEO Extension - Installer   ║"
+    echo "║   For SEO Kit                     ║"
+    echo "════════════════════════════════════════"
+    echo ""
+
+    # Check prerequisites
+    if [ ! -d "${SEO_SKILL_DIR}" ]; then
+        echo "✗ SEO Kit is not installed."
+        echo "  Install it first: curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/seo-kit/main/install.sh | bash"
+        exit 1
+    fi
+    echo "✓ SEO Kit detected"
+
+    if ! command -v node >/dev/null 2>&1; then
+        echo "✗ Node.js is required but not installed."
+        echo "  Install Node.js 20+: https://nodejs.org/"
+        exit 1
+    fi
+
+    NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
+    if [ "${NODE_VERSION}" -lt 20 ]; then
+        echo "✗ Node.js 20+ required (found v${NODE_VERSION})."
+        echo "  Update: https://nodejs.org/"
+        exit 1
+    fi
+    echo "✓ Node.js v$(node -v | sed 's/v//') detected"
+
+    if ! command -v npx >/dev/null 2>&1; then
+        echo "✗ npx is required but not found (comes with npm)."
+        exit 1
+    fi
+    echo "✓ npx detected"
+
+    # Prompt for credentials
+    echo ""
+    echo "DataForSEO API credentials required."
+    echo "Sign up at: https://app.dataforseo.com/register"
+    echo ""
+
+    read -rp "DataForSEO username (email): " DFSE_USERNAME
+    if [ -z "${DFSE_USERNAME}" ]; then
+        echo "✗ Username cannot be empty."
+        exit 1
+    fi
+
+    read -rsp "DataForSEO password: " DFSE_PASSWORD
+    echo ""
+    if [ -z "${DFSE_PASSWORD}" ]; then
+        echo "✗ Password cannot be empty."
+        exit 1
+    fi
+
+    # Determine script directory (works for both ./install.sh and curl|bash)
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+    # Check if running from repo or standalone
+    if [ -f "${SCRIPT_DIR}/skills/seo-dataforseo/SKILL.md" ]; then
+        SOURCE_DIR="${SCRIPT_DIR}"
+    elif [ -f "${SCRIPT_DIR}/extensions/dataforseo/skills/seo-dataforseo/SKILL.md" ]; then
+        SOURCE_DIR="${SCRIPT_DIR}/extensions/dataforseo"
+    else
+        echo "✗ Cannot find extension source files."
+        echo "  Run this script from the seo-kit repo: ./extensions/dataforseo/install.sh"
+        exit 1
+    fi
+
+    # Install skill
+    echo ""
+    echo "→ Installing DataForSEO skill..."
+    mkdir -p "${SKILL_DIR}"
+    cp "${SOURCE_DIR}/skills/seo-dataforseo/SKILL.md" "${SKILL_DIR}/SKILL.md"
+
+    # Install agent
+    echo "→ Installing DataForSEO agent..."
+    mkdir -p "${AGENT_DIR}"
+    cp "${SOURCE_DIR}/agents/seo-dataforseo.md" "${AGENT_DIR}/seo-dataforseo.md"
+
+    # Install field config
+    echo "→ Installing field config..."
+    cp "${SOURCE_DIR}/field-config.json" "${SEO_SKILL_DIR}/dataforseo-field-config.json"
+
+    # Merge MCP config into settings.json
+    echo "→ Configuring MCP server..."
+    FIELD_CONFIG_PATH="${SEO_SKILL_DIR}/dataforseo-field-config.json"
+
+    python3 -c "
+import json, os, sys
+
+settings_path = '${SETTINGS_FILE}'
+username = '''${DFSE_USERNAME}'''
+password = '''${DFSE_PASSWORD}'''
+field_config = '${FIELD_CONFIG_PATH}'
+
+# Read existing settings or create new
+if os.path.exists(settings_path):
+    with open(settings_path, 'r') as f:
+        settings = json.load(f)
+else:
+    settings = {}
+
+# Ensure mcpServers key exists
+if 'mcpServers' not in settings:
+    settings['mcpServers'] = {}
+
+# Add DataForSEO server config
+settings['mcpServers']['dataforseo'] = {
+    'command': 'npx',
+    'args': ['-y', 'dataforseo-mcp-server'],
+    'env': {
+        'DATAFORSEO_USERNAME': username,
+        'DATAFORSEO_PASSWORD': password,
+        'ENABLED_MODULES': 'SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,DOMAIN_ANALYTICS,BUSINESS_DATA,CONTENT_ANALYSIS,AI_OPTIMIZATION',
+        'FIELD_CONFIG_PATH': field_config
+    }
+}
+
+# Write back
+os.makedirs(os.path.dirname(settings_path), exist_ok=True)
+with open(settings_path, 'w') as f:
+    json.dump(settings, f, indent=2)
+
+print('  ✓ MCP server configured in settings.json')
+" || {
+        echo "  ⚠  Could not auto-configure MCP server."
+        echo "  Add the dataforseo server manually to MCP settings"
+        echo "  See: extensions/dataforseo/docs/DATAFORSEO-SETUP.md"
+    }
+
+    # Pre-warm npx package
+    echo "→ Pre-downloading dataforseo-mcp-server..."
+    npx -y dataforseo-mcp-server --help >/dev/null 2>&1 || true
+
+    echo ""
+    echo "✓ DataForSEO extension installed successfully!"
+    echo ""
+    echo "Usage:"
+    echo "  1. Open your workspace in your AI agent"
+    echo "  2. Run commands:"
+    echo "     /seo dataforseo serp best coffee shops"
+    echo "     /seo dataforseo keywords seo tools"
+    echo "     /seo dataforseo backlinks example.com"
+    echo "     /seo dataforseo ai-mentions your brand"
+    echo ""
+    echo "All 22 commands: see extensions/dataforseo/README.md"
+    echo "To uninstall: ./extensions/dataforseo/uninstall.sh"
+}
+
+main "$@"

package/extensions/dataforseo/uninstall.ps1

@@ -0,0 +1,35 @@
+# DataForSEO Extension Uninstaller for SEO Kit (Windows)
+# PowerShell uninstall script
+
+$ErrorActionPreference = "Stop"
+
+Write-Host "════════════════════════════════════════" -ForegroundColor Cyan
+Write-Host "║   DataForSEO Extension - Uninstall   ║" -ForegroundColor Cyan
+Write-Host "╣   For SEO Kit (Antigravity)          ║" -ForegroundColor Cyan
+Write-Host "════════════════════════════════════════" -ForegroundColor Cyan
+Write-Host ""
+
+# Determine workspace root
+$WorkspaceRoot = Split-Path -Parent (Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path))
+
+# Remove skill
+$SkillDir = "$WorkspaceRoot\.agent\skills\seo-dataforseo"
+if (Test-Path $SkillDir) {
+    Remove-Item -Recurse -Force $SkillDir
+    Write-Host "✓ Removed DataForSEO skill" -ForegroundColor Green
+} else {
+    Write-Host "  ⚠ Skill directory not found (already removed?)" -ForegroundColor Yellow
+}
+
+# Remove field config
+$FieldConfig = "$WorkspaceRoot\.agent\skills\seo\dataforseo-field-config.json"
+if (Test-Path $FieldConfig) {
+    Remove-Item -Force $FieldConfig
+    Write-Host "✓ Removed field config" -ForegroundColor Green
+}
+
+Write-Host ""
+Write-Host "✓ DataForSEO extension uninstalled." -ForegroundColor Green
+Write-Host ""
+Write-Host "Note: MCP server configuration must be removed manually from your"
+Write-Host "agent platform settings if configured." -ForegroundColor Yellow

package/extensions/dataforseo/uninstall.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+main() {
+    echo "→ Uninstalling DataForSEO extension..."
+
+    # Remove skill
+    rm -rf ".agent/skills/seo-dataforseo"
+
+    # Remove agent
+    rm -f ".agent/skills/seo-dataforseo.md"
+
+    # Remove field config
+    rm -f ".agent/skills/seo/dataforseo-field-config.json"
+
+    # Remove MCP server entry from settings.json
+    SETTINGS_FILE="MCP_settings_path"
+    if [ -f "${SETTINGS_FILE}" ]; then
+        python3 -c "
+import json, os
+settings_path = '${SETTINGS_FILE}'
+with open(settings_path, 'r') as f:
+    settings = json.load(f)
+if 'mcpServers' in settings and 'dataforseo' in settings['mcpServers']:
+    del settings['mcpServers']['dataforseo']
+    if not settings['mcpServers']:
+        del settings['mcpServers']
+    with open(settings_path, 'w') as f:
+        json.dump(settings, f, indent=2)
+    print('  ✓ Removed dataforseo from settings.json')
+else:
+    print('  ✓ No dataforseo entry in settings.json')
+" 2>/dev/null || echo "  ⚠  Could not auto-remove MCP config. Remove 'dataforseo' from MCP settings manually."
+    fi
+
+    echo "✓ DataForSEO extension uninstalled."
+}
+
+main "$@"

package/lib/api.js

@@ -0,0 +1,190 @@
+'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://api.example.com/api/seo-kit';
+
+function getApiUrl() {
+  return DEFAULT_API_URL.replace(/\/+$/, ''); // Remove trailing slash
+}
+
+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 },
+    licenseKey,
+  });
+  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(licenseKey) {
+  const { data } = await request('GET', '/releases/latest', { licenseKey });
+  return data;
+}
+
+// ─── Exports ────────────────────────────────────────────────────────────────
+
+module.exports = {
+  verifyLicense,
+  getLicenseStatus,
+  listDevices,
+  removeDevice,
+  getLatestRelease,
+  ApiError,
+  getApiUrl,
+};

package/lib/fingerprint.js

@@ -0,0 +1,68 @@
+'use strict';
+
+const os = require('os');
+const crypto = require('crypto');
+
+/**
+ * Generate a unique device fingerprint based on hardware characteristics.
+ *
+ * Combines hostname, platform, architecture, CPU model, total memory,
+ * and primary MAC address into a SHA-256 hash (truncated to 16 chars).
+ *
+ * This is not tamper-proof but sufficient for license device tracking.
+ */
+function generateFingerprint() {
+  const components = [
+    os.hostname(),
+    os.platform(),
+    os.arch(),
+    getCpuModel(),
+    os.totalmem().toString(),
+    getPrimaryMacAddress(),
+  ];
+
+  const raw = components.join('|');
+  return crypto.createHash('sha256').update(raw).digest('hex').substring(0, 16);
+}
+
+/**
+ * Get a human-readable device name for display purposes.
+ * Example: "DESKTOP-ABC (win32 x64)"
+ */
+function getDeviceName() {
+  const hostname = os.hostname();
+  const platform = os.platform();
+  const arch = os.arch();
+  const release = os.release().split('.').slice(0, 2).join('.');
+  return `${hostname} (${platform} ${arch}, ${release})`;
+}
+
+/**
+ * Get CPU model string.
+ */
+function getCpuModel() {
+  const cpus = os.cpus();
+  return cpus.length > 0 ? cpus[0].model.trim() : 'unknown-cpu';
+}
+
+/**
+ * Get the MAC address of the first non-internal network interface.
+ * Falls back to 'no-mac' if none found.
+ */
+function getPrimaryMacAddress() {
+  const interfaces = os.networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    for (const iface of interfaces[name]) {
+      // Skip internal (loopback) and link-local interfaces
+      if (!iface.internal && iface.mac && iface.mac !== '00:00:00:00:00:00') {
+        return iface.mac;
+      }
+    }
+  }
+  return 'no-mac';
+}
+
+module.exports = {
+  generateFingerprint,
+  getDeviceName,
+};