arkaos 4.26.0 → 4.28.0

package/departments/marketing/tools/clis/customer-io.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+
+const APP_KEY = process.env.CUSTOMERIO_APP_KEY
+const SITE_ID = process.env.CUSTOMERIO_SITE_ID
+const API_KEY = process.env.CUSTOMERIO_API_KEY
+
+const TRACK_URL = 'https://track.customer.io/api/v1'
+const APP_URL = 'https://api.customer.io/v1'
+
+const hasTrackAuth = SITE_ID && API_KEY
+const hasAppAuth = APP_KEY
+
+if (!hasTrackAuth && !hasAppAuth) {
+  console.error(JSON.stringify({ error: 'CUSTOMERIO_APP_KEY (for App API) or CUSTOMERIO_SITE_ID + CUSTOMERIO_API_KEY (for Track API) environment variables required' }))
+  process.exit(1)
+}
+
+const basicAuth = hasTrackAuth ? Buffer.from(`${SITE_ID}:${API_KEY}`).toString('base64') : null
+
+async function trackApi(method, path, body) {
+  if (!hasTrackAuth) {
+    return { error: 'Track API requires CUSTOMERIO_SITE_ID and CUSTOMERIO_API_KEY environment variables' }
+  }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${TRACK_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${TRACK_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Basic ${basicAuth}`,
+      'Content-Type': 'application/json',
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const text = await res.text()
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { status: res.status, body: text }
+  }
+}
+
+async function appApi(method, path, body) {
+  if (!hasAppAuth) {
+    return { error: 'App API requires CUSTOMERIO_APP_KEY environment variable' }
+  }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${APP_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${APP_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${APP_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const text = await res.text()
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { status: res.status, body: text }
+  }
+}
+
+function parseArgs(args) {
+  const result = { _: [] }
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2)
+      const next = args[i + 1]
+      if (next && !next.startsWith('--')) {
+        result[key] = next
+        i++
+      } else {
+        result[key] = true
+      }
+    } else {
+      result._.push(arg)
+    }
+  }
+  return result
+}
+
+const args = parseArgs(process.argv.slice(2))
+const [cmd, sub, ...rest] = args._
+
+async function main() {
+  let result
+
+  switch (cmd) {
+    case 'customers':
+      switch (sub) {
+        case 'identify': {
+          const customerId = rest[0] || args.id
+          if (!customerId) { result = { error: 'Customer ID required (positional arg or --id)' }; break }
+          const body = {}
+          if (args.email) body.email = args.email
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args['last-name']) body.last_name = args['last-name']
+          if (args['created-at']) body.created_at = parseInt(args['created-at'])
+          if (args.plan) body.plan = args.plan
+          if (args.data) Object.assign(body, JSON.parse(args.data))
+          result = await trackApi('PUT', `/customers/${customerId}`, body)
+          break
+        }
+        case 'get': {
+          const customerId = rest[0] || args.id
+          if (!customerId) { result = { error: 'Customer ID required (positional arg or --id)' }; break }
+          result = await appApi('GET', `/customers/${customerId}/attributes`)
+          break
+        }
+        case 'delete': {
+          const customerId = rest[0] || args.id
+          if (!customerId) { result = { error: 'Customer ID required (positional arg or --id)' }; break }
+          result = await trackApi('DELETE', `/customers/${customerId}`)
+          break
+        }
+        case 'track-event': {
+          const customerId = rest[0] || args.id
+          if (!customerId) { result = { error: 'Customer ID required (positional arg or --id)' }; break }
+          if (!args.name) { result = { error: '--name required (event name)' }; break }
+          const body = { name: args.name }
+          if (args.data) body.data = JSON.parse(args.data)
+          result = await trackApi('POST', `/customers/${customerId}/events`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown customers subcommand. Use: identify, get, delete, track-event' }
+      }
+      break
+
+    case 'campaigns':
+      switch (sub) {
+        case 'list':
+          result = await appApi('GET', '/campaigns')
+          break
+        case 'get': {
+          const campaignId = rest[0] || args.id
+          if (!campaignId) { result = { error: 'Campaign ID required (positional arg or --id)' }; break }
+          result = await appApi('GET', `/campaigns/${campaignId}`)
+          break
+        }
+        case 'metrics': {
+          const campaignId = rest[0] || args.id
+          if (!campaignId) { result = { error: 'Campaign ID required (positional arg or --id)' }; break }
+          result = await appApi('GET', `/campaigns/${campaignId}/metrics`)
+          break
+        }
+        case 'trigger': {
+          const campaignId = rest[0] || args.id
+          if (!campaignId) { result = { error: 'Campaign ID required (positional arg or --id)' }; break }
+          const body = {}
+          if (args.emails) body.emails = args.emails.split(',')
+          if (args.ids) body.ids = args.ids.split(',')
+          if (args.data) body.data = JSON.parse(args.data)
+          result = await appApi('POST', `/campaigns/${campaignId}/triggers`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown campaigns subcommand. Use: list, get, metrics, trigger' }
+      }
+      break
+
+    case 'send':
+      switch (sub) {
+        case 'email': {
+          const body = {
+            transactional_message_id: args['message-id'],
+            to: args.to,
+            identifiers: {},
+          }
+          if (args['identifier-id']) body.identifiers.id = args['identifier-id']
+          if (args['identifier-email']) body.identifiers.email = args['identifier-email']
+          if (args.data) body.message_data = JSON.parse(args.data)
+          if (args.from) body.from = args.from
+          if (args.subject) body.subject = args.subject
+          if (args.body) body.body = args.body
+          result = await appApi('POST', '/send/email', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown send subcommand. Use: email' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          customers: 'customers [identify|get|delete|track-event] <customer_id> [--email <email>] [--first-name <name>] [--plan <plan>] [--data <json>] [--name <event>]',
+          campaigns: 'campaigns [list|get|metrics|trigger] [campaign_id] [--emails <e1,e2>] [--ids <id1,id2>] [--data <json>]',
+          send: 'send email --message-id <id> --to <email> [--identifier-id <id>] [--identifier-email <email>] [--data <json>]',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})

package/departments/marketing/tools/clis/dataforseo.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+
+const LOGIN = process.env.DATAFORSEO_LOGIN
+const PASSWORD = process.env.DATAFORSEO_PASSWORD
+const BASE_URL = 'https://api.dataforseo.com/v3'
+
+if (!LOGIN || !PASSWORD) {
+  console.error(JSON.stringify({ error: 'DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD environment variables required' }))
+  process.exit(1)
+}
+
+const AUTH = 'Basic ' + Buffer.from(`${LOGIN}:${PASSWORD}`).toString('base64')
+
+async function api(method, path, body) {
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': AUTH,
+      'Content-Type': 'application/json',
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const text = await res.text()
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { status: res.status, body: text }
+  }
+}
+
+function parseArgs(args) {
+  const result = { _: [] }
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2)
+      const next = args[i + 1]
+      if (next && !next.startsWith('--')) {
+        result[key] = next
+        i++
+      } else {
+        result[key] = true
+      }
+    } else {
+      result._.push(arg)
+    }
+  }
+  return result
+}
+
+const args = parseArgs(process.argv.slice(2))
+const [cmd, sub, ...rest] = args._
+
+async function main() {
+  let result
+  const location = args.location || 'United States'
+  const locationCode = args['location-code'] ? Number(args['location-code']) : 2840
+  const language = args.language || 'English'
+  const languageCode = args['language-code'] || 'en'
+  const limit = args.limit ? Number(args.limit) : 100
+
+  switch (cmd) {
+    case 'serp':
+      switch (sub) {
+        case 'google': {
+          const keyword = args.keyword
+          if (!keyword) { result = { error: '--keyword required' }; break }
+          result = await api('POST', '/serp/google/organic/live/regular', [{
+            keyword,
+            location_name: location,
+            language_name: language,
+          }])
+          break
+        }
+        case 'locations':
+          result = await api('GET', '/serp/google/locations')
+          break
+        case 'languages':
+          result = await api('GET', '/serp/google/languages')
+          break
+        default:
+          result = { error: 'Unknown serp subcommand. Use: google, locations, languages' }
+      }
+      break
+
+    case 'keywords':
+      switch (sub) {
+        case 'volume': {
+          const keywords = args.keywords?.split(',')
+          if (!keywords) { result = { error: '--keywords required (comma-separated)' }; break }
+          result = await api('POST', '/keywords_data/google_ads/search_volume/live', [{
+            keywords,
+            location_code: locationCode,
+            language_code: languageCode,
+          }])
+          break
+        }
+        case 'for-site': {
+          const target = args.target
+          if (!target) { result = { error: '--target required (domain)' }; break }
+          result = await api('POST', '/keywords_data/google_ads/keywords_for_site/live', [{
+            target,
+            location_code: locationCode,
+            language_code: languageCode,
+          }])
+          break
+        }
+        case 'for-keywords': {
+          const keywords = args.keywords?.split(',')
+          if (!keywords) { result = { error: '--keywords required (comma-separated)' }; break }
+          result = await api('POST', '/keywords_data/google_ads/keywords_for_keywords/live', [{
+            keywords,
+            location_code: locationCode,
+            language_code: languageCode,
+          }])
+          break
+        }
+        case 'trends': {
+          const keywords = args.keywords?.split(',')
+          if (!keywords) { result = { error: '--keywords required (comma-separated)' }; break }
+          result = await api('POST', '/keywords_data/google_trends/explore/live', [{
+            keywords,
+            location_code: locationCode,
+            language_code: languageCode,
+          }])
+          break
+        }
+        default:
+          result = { error: 'Unknown keywords subcommand. Use: volume, for-site, for-keywords, trends' }
+      }
+      break
+
+    case 'backlinks':
+      switch (sub) {
+        case 'summary': {
+          const target = args.target
+          if (!target) { result = { error: '--target required' }; break }
+          result = await api('POST', '/backlinks/summary/live', [{
+            target,
+            backlinks_status_type: 'live',
+          }])
+          break
+        }
+        case 'list': {
+          const target = args.target
+          if (!target) { result = { error: '--target required' }; break }
+          result = await api('POST', '/backlinks/backlinks/live', [{
+            target,
+            mode: args.mode || 'as_is',
+            limit,
+            backlinks_status_type: 'live',
+          }])
+          break
+        }
+        case 'refdomains': {
+          const target = args.target
+          if (!target) { result = { error: '--target required' }; break }
+          result = await api('POST', '/backlinks/referring_domains/live', [{
+            target,
+            limit,
+          }])
+          break
+        }
+        case 'anchors': {
+          const target = args.target
+          if (!target) { result = { error: '--target required' }; break }
+          result = await api('POST', '/backlinks/anchors/live', [{
+            target,
+            limit,
+          }])
+          break
+        }
+        case 'index':
+          result = await api('GET', '/backlinks/index')
+          break
+        default:
+          result = { error: 'Unknown backlinks subcommand. Use: summary, list, refdomains, anchors, index' }
+      }
+      break
+
+    case 'onpage':
+      switch (sub) {
+        case 'audit': {
+          const url = args.url
+          if (!url) { result = { error: '--url required' }; break }
+          result = await api('POST', '/on_page/instant_pages', [{
+            url,
+            enable_javascript: args['no-js'] ? false : true,
+          }])
+          break
+        }
+        default:
+          result = { error: 'Unknown onpage subcommand. Use: audit' }
+      }
+      break
+
+    case 'labs':
+      switch (sub) {
+        case 'competitors': {
+          const target = args.target
+          if (!target) { result = { error: '--target required' }; break }
+          result = await api('POST', '/dataforseo_labs/google/competitors_domain/live', [{
+            target,
+            location_code: locationCode,
+            language_code: languageCode,
+            limit,
+          }])
+          break
+        }
+        case 'ranked-keywords': {
+          const target = args.target
+          if (!target) { result = { error: '--target required' }; break }
+          result = await api('POST', '/dataforseo_labs/google/ranked_keywords/live', [{
+            target,
+            location_code: locationCode,
+            language_code: languageCode,
+            limit,
+          }])
+          break
+        }
+        case 'domain-intersection': {
+          const targets = args.targets?.split(',')
+          if (!targets || targets.length < 2) { result = { error: '--targets required (comma-separated, at least 2 domains)' }; break }
+          const payload = { location_code: locationCode, language_code: languageCode, limit }
+          targets.forEach((t, i) => { payload[`target${i + 1}`] = t })
+          result = await api('POST', '/dataforseo_labs/google/domain_intersection/live', [payload])
+          break
+        }
+        default:
+          result = { error: 'Unknown labs subcommand. Use: competitors, ranked-keywords, domain-intersection' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          serp: 'serp [google --keyword <kw> | locations | languages]',
+          keywords: 'keywords [volume --keywords <kw1,kw2> | for-site --target <domain> | for-keywords --keywords <kw1,kw2> | trends --keywords <kw1,kw2>]',
+          backlinks: 'backlinks [summary --target <domain> | list --target <domain> | refdomains --target <domain> | anchors --target <domain> | index]',
+          onpage: 'onpage [audit --url <url>]',
+          labs: 'labs [competitors --target <domain> | ranked-keywords --target <domain> | domain-intersection --targets <d1,d2>]',
+          options: '--location-code <code> --language-code <code> --limit <n>',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})

package/departments/marketing/tools/clis/demio.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.DEMIO_API_KEY
+const API_SECRET = process.env.DEMIO_API_SECRET
+const BASE_URL = 'https://my.demio.com/api/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'DEMIO_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+if (!API_SECRET) {
+  console.error(JSON.stringify({ error: 'DEMIO_API_SECRET environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { 'Api-Key': '***', 'Api-Secret': '***', 'Content-Type': 'application/json', Accept: 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Api-Key': API_KEY,
+      'Api-Secret': API_SECRET,
+      'Content-Type': 'application/json',
+      'Accept': 'application/json',
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const text = await res.text()
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { status: res.status, body: text }
+  }
+}
+
+function parseArgs(args) {
+  const result = { _: [] }
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2)
+      const next = args[i + 1]
+      if (next && !next.startsWith('--')) {
+        result[key] = next
+        i++
+      } else {
+        result[key] = true
+      }
+    } else {
+      result._.push(arg)
+    }
+  }
+  return result
+}
+
+const args = parseArgs(process.argv.slice(2))
+const [cmd, sub, ...rest] = args._
+
+async function main() {
+  let result
+
+  switch (cmd) {
+    case 'ping':
+      result = await api('GET', '/ping')
+      break
+
+    case 'events':
+      switch (sub) {
+        case 'list': {
+          const type = args.type
+          let qs = ''
+          if (type) qs = `?type=${encodeURIComponent(type)}`
+          result = await api('GET', `/events${qs}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/event/${id}`)
+          break
+        }
+        case 'date': {
+          const eventId = args['event-id']
+          const dateId = args['date-id']
+          if (!eventId) { result = { error: '--event-id required' }; break }
+          if (!dateId) { result = { error: '--date-id required' }; break }
+          result = await api('GET', `/event/${eventId}/date/${dateId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown events subcommand. Use: list, get, date' }
+      }
+      break
+
+    case 'register':
+      switch (sub) {
+        case 'create': {
+          const id = args.id || args['event-id']
+          const name = args.name
+          const email = args.email
+          if (!id) { result = { error: '--id (event id) required' }; break }
+          if (!name) { result = { error: '--name required' }; break }
+          if (!email) { result = { error: '--email required' }; break }
+          const payload = { id, name, email }
+          if (args['date-id']) payload.date_id = args['date-id']
+          if (args['ref-url']) payload.ref_url = args['ref-url']
+          result = await api('POST', '/event/register', payload)
+          break
+        }
+        default:
+          result = { error: 'Unknown register subcommand. Use: create' }
+      }
+      break
+
+    case 'participants':
+      switch (sub) {
+        case 'list': {
+          const dateId = args['date-id']
+          if (!dateId) { result = { error: '--date-id required' }; break }
+          result = await api('GET', `/date/${dateId}/participants`)
+          break
+        }
+        default:
+          result = { error: 'Unknown participants subcommand. Use: list' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          ping: 'ping',
+          events: 'events [list --type <upcoming|past|all> | get --id <id> | date --event-id <id> --date-id <id>]',
+          register: 'register [create --id <event_id> --name <name> --email <email> --date-id <date_id>]',
+          participants: 'participants [list --date-id <id>]',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})