arkaos 4.26.0 → 4.27.0

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

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.DUB_API_KEY
+const BASE_URL = 'https://api.dub.co'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'DUB_API_KEY 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: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${API_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 'links':
+      switch (sub) {
+        case 'create': {
+          if (!args.url) { result = { error: '--url required' }; break }
+          const body = {}
+          if (args.url) body.url = args.url
+          if (args.domain) body.domain = args.domain
+          if (args.key) body.key = args.key
+          if (args.tags) body.tags = args.tags.split(',')
+          result = await api('POST', '/links', body)
+          break
+        }
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.domain) params.set('domain', args.domain)
+          if (args.page) params.set('page', args.page)
+          result = await api('GET', `/links?${params}`)
+          break
+        }
+        case 'get': {
+          const params = new URLSearchParams()
+          if (args.domain) params.set('domain', args.domain)
+          if (args.key) params.set('key', args.key)
+          if (args['link-id']) params.set('linkId', args['link-id'])
+          if (args['external-id']) params.set('externalId', args['external-id'])
+          result = await api('GET', `/links/info?${params}`)
+          break
+        }
+        case 'update': {
+          if (!args.id) { result = { error: '--id required (link ID)' }; break }
+          const body = {}
+          if (args.url) body.url = args.url
+          if (args.tags) body.tags = args.tags.split(',')
+          result = await api('PATCH', `/links/${args.id}`, body)
+          break
+        }
+        case 'delete':
+          if (!args.id) { result = { error: '--id required (link ID)' }; break }
+          result = await api('DELETE', `/links/${args.id}`)
+          break
+        case 'bulk-create': {
+          let links
+          try {
+            links = JSON.parse(args.links || '[]')
+          } catch {
+            result = { error: 'Invalid JSON in --links' }; break
+          }
+          result = await api('POST', '/links/bulk', links)
+          break
+        }
+        default:
+          result = { error: 'Unknown links subcommand. Use: create, list, get, update, delete, bulk-create' }
+      }
+      break
+
+    case 'analytics':
+      switch (sub) {
+        case 'get': {
+          const params = new URLSearchParams()
+          if (args.domain) params.set('domain', args.domain)
+          if (args.key) params.set('key', args.key)
+          if (args.interval) params.set('interval', args.interval)
+          result = await api('GET', `/analytics?${params}`)
+          break
+        }
+        case 'country': {
+          const params = new URLSearchParams()
+          if (args.domain) params.set('domain', args.domain)
+          if (args.key) params.set('key', args.key)
+          result = await api('GET', `/analytics/country?${params}`)
+          break
+        }
+        case 'device': {
+          const params = new URLSearchParams()
+          if (args.domain) params.set('domain', args.domain)
+          if (args.key) params.set('key', args.key)
+          result = await api('GET', `/analytics/device?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown analytics subcommand. Use: get, country, device' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          links: 'links [create|list|get|update|delete|bulk-create] [--url <url>] [--domain <domain>] [--key <key>] [--tags <tags>] [--id <id>] [--page <page>] [--links <json>]',
+          analytics: 'analytics [get|country|device] [--domain <domain>] [--key <key>] [--interval <interval>]',
+        }
+      }
+  }
+
+  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/exa.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.EXA_API_KEY
+const BASE_URL = 'https://api.exa.ai'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'EXA_API_KEY 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: { 'x-api-key': '***', 'Content-Type': 'application/json', 'x-exa-integration': 'marketingskills' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'x-api-key': API_KEY,
+      'Content-Type': 'application/json',
+      'x-exa-integration': 'marketingskills',
+    },
+    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
+}
+
+function buildContents(args) {
+  const contents = {}
+  if (args.text) {
+    contents.text = args['max-chars']
+      ? { maxCharacters: Number(args['max-chars']) }
+      : true
+  }
+  if (args.highlights) {
+    contents.highlights = args['highlight-query']
+      ? { query: args['highlight-query'] }
+      : true
+  }
+  if (args.summary) {
+    contents.summary = args['summary-query']
+      ? { query: args['summary-query'] }
+      : {}
+  }
+  return Object.keys(contents).length ? contents : null
+}
+
+const args = parseArgs(process.argv.slice(2))
+const [cmd, ...rest] = args._
+
+async function main() {
+  let result
+
+  switch (cmd) {
+    case 'search': {
+      const query = args.query || rest.join(' ')
+      if (!query) { result = { error: '--query required' }; break }
+      const body = { query }
+      if (args.type) body.type = args.type
+      if (args.num) body.numResults = Number(args.num)
+      if (args.category) body.category = args.category
+      if (args['include-domains']) body.includeDomains = args['include-domains'].split(',').map(s => s.trim())
+      if (args['exclude-domains']) body.excludeDomains = args['exclude-domains'].split(',').map(s => s.trim())
+      if (args['include-text']) body.includeText = args['include-text'].split(',').map(s => s.trim())
+      if (args['exclude-text']) body.excludeText = args['exclude-text'].split(',').map(s => s.trim())
+      if (args['start-published']) body.startPublishedDate = args['start-published']
+      if (args['end-published']) body.endPublishedDate = args['end-published']
+      if (args['start-crawl']) body.startCrawlDate = args['start-crawl']
+      if (args['end-crawl']) body.endCrawlDate = args['end-crawl']
+      if (args['user-location']) body.userLocation = args['user-location']
+      const contents = buildContents(args)
+      if (contents) body.contents = contents
+      result = await api('POST', '/search', body)
+      break
+    }
+
+    case 'find-similar': {
+      const url = args.url
+      if (!url) { result = { error: '--url required' }; break }
+      const body = { url }
+      if (args.num) body.numResults = Number(args.num)
+      if (args['include-domains']) body.includeDomains = args['include-domains'].split(',').map(s => s.trim())
+      if (args['exclude-domains']) body.excludeDomains = args['exclude-domains'].split(',').map(s => s.trim())
+      if (args['start-published']) body.startPublishedDate = args['start-published']
+      if (args['end-published']) body.endPublishedDate = args['end-published']
+      if (args['start-crawl']) body.startCrawlDate = args['start-crawl']
+      if (args['end-crawl']) body.endCrawlDate = args['end-crawl']
+      const contents = buildContents(args)
+      if (contents) body.contents = contents
+      result = await api('POST', '/findSimilar', body)
+      break
+    }
+
+    case 'contents': {
+      const urls = args.urls?.split(',').map(s => s.trim())
+      if (!urls || !urls.length) { result = { error: '--urls required (comma-separated)' }; break }
+      const body = { urls }
+      const contents = buildContents(args)
+      if (contents) Object.assign(body, contents)
+      else body.text = true
+      result = await api('POST', '/contents', body)
+      break
+    }
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          search: 'search --query <q> [--type neural|fast|auto|deep-lite|deep|deep-reasoning|instant] [--num <n>] [--category company|research paper|news|personal site|financial report|people] [--include-domains <d1,d2>] [--exclude-domains <d1,d2>] [--include-text <phrases>] [--exclude-text <phrases>] [--start-published <ISO>] [--end-published <ISO>] [--user-location <CC>] [--text] [--highlights] [--summary] [--max-chars <n>] [--highlight-query <q>] [--summary-query <q>]',
+          'find-similar': 'find-similar --url <url> [--num <n>] [--include-domains <d1,d2>] [--exclude-domains <d1,d2>] [--start-published <ISO>] [--end-published <ISO>] [--text] [--highlights] [--summary]',
+          contents: 'contents --urls <url1,url2> [--text] [--highlights] [--summary] [--max-chars <n>] [--highlight-query <q>] [--summary-query <q>]',
+          options: '--dry-run (preview request without sending)',
+        }
+      }
+  }
+
+  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/g2.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+
+const API_TOKEN = process.env.G2_API_TOKEN
+const BASE_URL = 'https://data.g2.com/api/v1'
+
+if (!API_TOKEN) {
+  console.error(JSON.stringify({ error: 'G2_API_TOKEN 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: { Authorization: '***', 'Content-Type': 'application/vnd.api+json', Accept: 'application/vnd.api+json' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Token token=${API_TOKEN}`,
+      'Content-Type': 'application/vnd.api+json',
+      'Accept': 'application/vnd.api+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 page = args.page ? Number(args.page) : 1
+  const perPage = args['per-page'] ? Number(args['per-page']) : 25
+  const productId = args['product-id'] || args.product
+
+  switch (cmd) {
+    case 'reviews':
+      switch (sub) {
+        case 'list': {
+          let qs = `?page[size]=${perPage}&page[number]=${page}`
+          if (productId) qs += `&filter[product_id]=${productId}`
+          if (args.state) qs += `&filter[state]=${encodeURIComponent(args.state)}`
+          result = await api('GET', `/survey-responses${qs}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/survey-responses/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown reviews subcommand. Use: list, get' }
+      }
+      break
+
+    case 'products':
+      switch (sub) {
+        case 'list': {
+          let qs = `?page[size]=${perPage}&page[number]=${page}`
+          if (args.name) qs += `&filter[name]=${encodeURIComponent(args.name)}`
+          result = await api('GET', `/products${qs}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/products/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown products subcommand. Use: list, get' }
+      }
+      break
+
+    case 'reports':
+      switch (sub) {
+        case 'list': {
+          let qs = `?page[size]=${perPage}&page[number]=${page}`
+          result = await api('GET', `/reports${qs}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/reports/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown reports subcommand. Use: list, get' }
+      }
+      break
+
+    case 'competitors':
+      switch (sub) {
+        case 'list': {
+          if (!productId) { result = { error: '--product-id required' }; break }
+          let qs = `?page[size]=${perPage}&page[number]=${page}&filter[product_id]=${productId}`
+          result = await api('GET', `/competitor-comparisons${qs}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown competitors subcommand. Use: list' }
+      }
+      break
+
+    case 'categories':
+      switch (sub) {
+        case 'list': {
+          let qs = `?page[size]=${perPage}&page[number]=${page}`
+          if (args.name) qs += `&filter[name]=${encodeURIComponent(args.name)}`
+          result = await api('GET', `/categories${qs}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/categories/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown categories subcommand. Use: list, get' }
+      }
+      break
+
+    case 'tracking':
+      switch (sub) {
+        case 'visitors': {
+          let qs = `?page[size]=${perPage}&page[number]=${page}`
+          if (args.start) qs += `&filter[start_date]=${encodeURIComponent(args.start)}`
+          if (args.end) qs += `&filter[end_date]=${encodeURIComponent(args.end)}`
+          result = await api('GET', `/tracking-events${qs}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown tracking subcommand. Use: visitors' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          reviews: 'reviews [list --product-id <id> | get --id <id>]',
+          products: 'products [list --name <name> | get --id <id>]',
+          reports: 'reports [list | get --id <id>]',
+          competitors: 'competitors [list --product-id <id>]',
+          categories: 'categories [list --name <name> | get --id <id>]',
+          tracking: 'tracking [visitors --start <date> --end <date>]',
+          options: '--page <n> --per-page <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/ga4.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+
+const ACCESS_TOKEN = process.env.GA4_ACCESS_TOKEN
+const DATA_API = 'https://analyticsdata.googleapis.com/v1beta'
+const ADMIN_API = 'https://analyticsadmin.googleapis.com/v1beta'
+const MP_URL = 'https://www.google-analytics.com/mp/collect'
+
+if (!ACCESS_TOKEN) {
+  console.error(JSON.stringify({ error: 'GA4_ACCESS_TOKEN environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, baseUrl, path, body) {
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${baseUrl}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${baseUrl}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${ACCESS_TOKEN}`,
+      '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 mpApi(measurementId, apiSecret, body) {
+  const params = new URLSearchParams({ measurement_id: measurementId, api_secret: apiSecret })
+  if (args['dry-run']) {
+    return { _dry_run: true, method: 'POST', url: `${MP_URL}?${new URLSearchParams({ measurement_id: measurementId, api_secret: '***' })}`, headers: { 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${MP_URL}?${params}`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body),
+  })
+  const text = await res.text()
+  if (!text) return { status: res.status, success: res.ok }
+  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 'reports':
+      switch (sub) {
+        case 'run': {
+          const property = args.property
+          if (!property) { result = { error: '--property required' }; break }
+          const body = {
+            dateRanges: [{
+              startDate: args['start-date'] || '30daysAgo',
+              endDate: args['end-date'] || 'today',
+            }],
+          }
+          if (args.dimensions) {
+            body.dimensions = args.dimensions.split(',').map(d => ({ name: d.trim() }))
+          }
+          if (args.metrics) {
+            body.metrics = args.metrics.split(',').map(m => ({ name: m.trim() }))
+          }
+          result = await api('POST', DATA_API, `/properties/${property}:runReport`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown reports subcommand. Use: run' }
+      }
+      break
+
+    case 'realtime':
+      switch (sub) {
+        case 'run': {
+          const property = args.property
+          if (!property) { result = { error: '--property required' }; break }
+          const body = {}
+          if (args.dimensions) {
+            body.dimensions = args.dimensions.split(',').map(d => ({ name: d.trim() }))
+          }
+          if (args.metrics) {
+            body.metrics = args.metrics.split(',').map(m => ({ name: m.trim() }))
+          }
+          result = await api('POST', DATA_API, `/properties/${property}:runRealtimeReport`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown realtime subcommand. Use: run' }
+      }
+      break
+
+    case 'conversions':
+      switch (sub) {
+        case 'list': {
+          const property = args.property
+          if (!property) { result = { error: '--property required' }; break }
+          result = await api('GET', ADMIN_API, `/properties/${property}/conversionEvents`)
+          break
+        }
+        case 'create': {
+          const property = args.property
+          if (!property) { result = { error: '--property required' }; break }
+          if (!args['event-name']) { result = { error: '--event-name required' }; break }
+          result = await api('POST', ADMIN_API, `/properties/${property}/conversionEvents`, {
+            eventName: args['event-name'],
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown conversions subcommand. Use: list, create' }
+      }
+      break
+
+    case 'events':
+      switch (sub) {
+        case 'send': {
+          if (!args['measurement-id']) { result = { error: '--measurement-id required' }; break }
+          if (!args['api-secret']) { result = { error: '--api-secret required' }; break }
+          if (!args['client-id']) { result = { error: '--client-id required' }; break }
+          if (!args['event-name']) { result = { error: '--event-name required' }; break }
+          let eventParams = {}
+          if (args.params) {
+            try {
+              eventParams = JSON.parse(args.params)
+            } catch {
+              result = { error: 'Invalid JSON in --params' }; break
+            }
+          }
+          const body = {
+            client_id: args['client-id'],
+            events: [{
+              name: args['event-name'],
+              params: eventParams,
+            }],
+          }
+          result = await mpApi(args['measurement-id'], args['api-secret'], body)
+          break
+        }
+        default:
+          result = { error: 'Unknown events subcommand. Use: send' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          reports: 'reports run --property <id> [--start-date <date>] [--end-date <date>] [--dimensions <dims>] [--metrics <metrics>]',
+          realtime: 'realtime run --property <id> [--dimensions <dims>] [--metrics <metrics>]',
+          conversions: 'conversions [list|create] --property <id> [--event-name <name>]',
+          events: 'events send --measurement-id <id> --api-secret <secret> --client-id <id> --event-name <name> [--params <json>]',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})