@miranda0808/maya-codex 0.1.0

package/payload/tools/clis/ahrefs.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.AHREFS_API_KEY
+const BASE_URL = 'https://api.ahrefs.com/v3'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'AHREFS_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path) {
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { 'Authorization': '***', 'Content-Type': 'application/json' } }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+  })
+  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 mode = args.mode || 'domain'
+
+  switch (cmd) {
+    case 'domain-rating':
+      switch (sub) {
+        case 'get': {
+          if (!args.target) { result = { error: '--target required (domain)' }; break }
+          const params = new URLSearchParams({ target: args.target })
+          result = await api('GET', `/site-explorer/domain-rating?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown domain-rating subcommand. Use: get' }
+      }
+      break
+
+    case 'backlinks':
+      switch (sub) {
+        case 'list': {
+          if (!args.target) { result = { error: '--target required (domain or URL)' }; break }
+          const params = new URLSearchParams({ target: args.target, mode })
+          if (args.limit) params.set('limit', args.limit)
+          result = await api('GET', `/site-explorer/backlinks?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown backlinks subcommand. Use: list' }
+      }
+      break
+
+    case 'refdomains':
+      switch (sub) {
+        case 'list': {
+          if (!args.target) { result = { error: '--target required (domain or URL)' }; break }
+          const params = new URLSearchParams({ target: args.target, mode })
+          if (args.limit) params.set('limit', args.limit)
+          result = await api('GET', `/site-explorer/refdomains?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown refdomains subcommand. Use: list' }
+      }
+      break
+
+    case 'keywords':
+      switch (sub) {
+        case 'organic': {
+          if (!args.target) { result = { error: '--target required (domain or URL)' }; break }
+          const params = new URLSearchParams({ target: args.target, mode })
+          if (args.country) params.set('country', args.country)
+          if (args.limit) params.set('limit', args.limit)
+          result = await api('GET', `/site-explorer/organic-keywords?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown keywords subcommand. Use: organic' }
+      }
+      break
+
+    case 'top-pages':
+      switch (sub) {
+        case 'list': {
+          if (!args.target) { result = { error: '--target required (domain or URL)' }; break }
+          const params = new URLSearchParams({ target: args.target, mode })
+          if (args.country) params.set('country', args.country)
+          if (args.limit) params.set('limit', args.limit)
+          result = await api('GET', `/site-explorer/top-pages?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown top-pages subcommand. Use: list' }
+      }
+      break
+
+    case 'keyword-overview':
+      switch (sub) {
+        case 'get': {
+          const params = new URLSearchParams({ keywords: args.keywords })
+          if (args.country) params.set('country', args.country)
+          result = await api('GET', `/keywords-explorer/overview?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown keyword-overview subcommand. Use: get' }
+      }
+      break
+
+    case 'keyword-suggestions':
+      switch (sub) {
+        case 'get': {
+          const params = new URLSearchParams({ keyword: args.keyword })
+          if (args.country) params.set('country', args.country)
+          if (args.limit) params.set('limit', args.limit)
+          result = await api('GET', `/keywords-explorer/matching-terms?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown keyword-suggestions subcommand. Use: get' }
+      }
+      break
+
+    case 'serp':
+      switch (sub) {
+        case 'get': {
+          const params = new URLSearchParams({ keyword: args.keyword })
+          if (args.country) params.set('country', args.country)
+          result = await api('GET', `/keywords-explorer/serp-overview?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown serp subcommand. Use: get' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          'domain-rating': 'domain-rating get --target <domain>',
+          'backlinks': 'backlinks list --target <domain> [--mode <mode>] [--limit <n>]',
+          'refdomains': 'refdomains list --target <domain> [--mode <mode>] [--limit <n>]',
+          'keywords': 'keywords organic --target <domain> [--country <cc>] [--limit <n>]',
+          'top-pages': 'top-pages list --target <domain> [--country <cc>] [--limit <n>]',
+          'keyword-overview': 'keyword-overview get --keywords <kw1,kw2> [--country <cc>]',
+          'keyword-suggestions': 'keyword-suggestions get --keyword <keyword> [--country <cc>] [--limit <n>]',
+          'serp': 'serp get --keyword <keyword> [--country <cc>]',
+          'modes': 'domain (default), subdomains, prefix, exact',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})

package/payload/tools/clis/amplitude.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.AMPLITUDE_API_KEY
+const SECRET_KEY = process.env.AMPLITUDE_SECRET_KEY
+const INGESTION_URL = 'https://api2.amplitude.com'
+const QUERY_URL = 'https://amplitude.com/api/2'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'AMPLITUDE_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function ingestApi(method, path, body) {
+  if (args['dry-run']) {
+    const maskedBody = body ? JSON.parse(JSON.stringify(body)) : undefined
+    if (maskedBody && maskedBody.api_key) maskedBody.api_key = '***'
+    return { _dry_run: true, method, url: `${INGESTION_URL}${path}`, headers: { 'Content-Type': 'application/json' }, body: maskedBody }
+  }
+  const res = await fetch(`${INGESTION_URL}${path}`, {
+    method,
+    headers: { '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 queryApi(method, path, params) {
+  if (!SECRET_KEY) {
+    return { error: 'AMPLITUDE_SECRET_KEY required for query/export operations' }
+  }
+  const url = params ? `${QUERY_URL}${path}?${params}` : `${QUERY_URL}${path}`
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url, headers: { 'Authorization': '***', 'Content-Type': 'application/json' } }
+  }
+  const auth = Buffer.from(`${API_KEY}:${SECRET_KEY}`).toString('base64')
+  const res = await fetch(url, {
+    method,
+    headers: {
+      'Authorization': `Basic ${auth}`,
+      'Content-Type': 'application/json',
+    },
+  })
+  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 'track':
+      switch (sub) {
+        case 'event': {
+          if (!args['user-id']) { result = { error: '--user-id required' }; break }
+          if (!args['event-type']) { result = { error: '--event-type required' }; break }
+          const event = {
+            user_id: args['user-id'],
+            event_type: args['event-type'],
+          }
+          if (args.properties) {
+            event.event_properties = JSON.parse(args.properties)
+          }
+          result = await ingestApi('POST', '/2/httpapi', {
+            api_key: API_KEY,
+            events: [event],
+          })
+          break
+        }
+        case 'batch': {
+          if (!args.events) { result = { error: '--events required (JSON array)' }; break }
+          const events = JSON.parse(args.events)
+          result = await ingestApi('POST', '/batch', {
+            api_key: API_KEY,
+            events,
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown track subcommand. Use: event, batch' }
+      }
+      break
+
+    case 'users':
+      switch (sub) {
+        case 'activity': {
+          if (!args['user-id']) { result = { error: '--user-id required' }; break }
+          const params = new URLSearchParams()
+          params.set('user', args['user-id'])
+          result = await queryApi('GET', '/useractivity', params)
+          break
+        }
+        default:
+          result = { error: 'Unknown users subcommand. Use: activity' }
+      }
+      break
+
+    case 'export':
+      switch (sub) {
+        case 'events': {
+          if (!args.start) { result = { error: '--start required (e.g. 20240101T00)' }; break }
+          if (!args.end) { result = { error: '--end required (e.g. 20240131T23)' }; break }
+          const params = new URLSearchParams()
+          params.set('start', args.start)
+          params.set('end', args.end)
+          result = await queryApi('GET', '/export', params)
+          break
+        }
+        default:
+          result = { error: 'Unknown export subcommand. Use: events' }
+      }
+      break
+
+    case 'retention':
+      switch (sub) {
+        case 'get': {
+          if (!args.start) { result = { error: '--start required (e.g. 20240101)' }; break }
+          if (!args.end) { result = { error: '--end required (e.g. 20240131)' }; break }
+          const params = new URLSearchParams()
+          params.set('start', args.start)
+          params.set('end', args.end)
+          if (args.event) {
+            params.set('e', JSON.stringify([{ event_type: args.event }]))
+          }
+          result = await queryApi('GET', '/retention', params)
+          break
+        }
+        default:
+          result = { error: 'Unknown retention subcommand. Use: get' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          track: 'track [event --user-id <id> --event-type <type> [--properties <json>] | batch --events <json>]',
+          users: 'users activity --user-id <id>',
+          export: 'export events --start <YYYYMMDDThh> --end <YYYYMMDDThh>',
+          retention: 'retention get --start <YYYYMMDD> --end <YYYYMMDD> [--event <type>]',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})

package/payload/tools/clis/apollo.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.APOLLO_API_KEY
+const BASE_URL = 'https://api.apollo.io/api/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'APOLLO_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const authBody = body ? { ...body, api_key: API_KEY } : { api_key: API_KEY }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { 'Content-Type': 'application/json' }, body: { ...authBody, api_key: '***' } }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(authBody),
+  })
+  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
+
+  switch (cmd) {
+    case 'people':
+      switch (sub) {
+        case 'search': {
+          const body = { page, per_page: perPage }
+          if (args.titles) body.person_titles = args.titles.split(',')
+          if (args.locations) body.person_locations = args.locations.split(',')
+          if (args.seniorities) body.person_seniorities = args.seniorities.split(',')
+          if (args['employee-ranges']) body.organization_num_employees_ranges = args['employee-ranges'].split(',').map(r => r.trim())
+          if (args.keywords) body.q_keywords = args.keywords
+          result = await api('POST', '/mixed_people/search', body)
+          break
+        }
+        case 'enrich': {
+          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.domain) body.domain = args.domain
+          if (args.linkedin) body.linkedin_url = args.linkedin
+          if (!args.email && !args.linkedin && !(args['first-name'] && args.domain)) {
+            result = { error: '--email, --linkedin, or --first-name + --domain required' }
+            break
+          }
+          result = await api('POST', '/people/match', body)
+          break
+        }
+        case 'bulk-enrich': {
+          const emails = args.emails?.split(',')
+          if (!emails) { result = { error: '--emails required (comma-separated)' }; break }
+          const details = emails.map(email => ({ email: email.trim() }))
+          result = await api('POST', '/people/bulk_match', { details })
+          break
+        }
+        default:
+          result = { error: 'Unknown people subcommand. Use: search, enrich, bulk-enrich' }
+      }
+      break
+
+    case 'organizations':
+      switch (sub) {
+        case 'search': {
+          const body = { page, per_page: perPage }
+          if (args.locations) body.organization_locations = args.locations.split(',')
+          if (args['employee-ranges']) body.organization_num_employees_ranges = args['employee-ranges'].split(',').map(r => r.trim())
+          if (args.keywords) body.q_keywords = args.keywords
+          result = await api('POST', '/mixed_companies/search', body)
+          break
+        }
+        case 'enrich': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('POST', '/organizations/enrich', { domain })
+          break
+        }
+        default:
+          result = { error: 'Unknown organizations subcommand. Use: search, enrich' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          people: {
+            search: 'people search [--titles <t1,t2>] [--locations <l1,l2>] [--seniorities <s1,s2>] [--employee-ranges <1,100>] [--keywords <kw>] [--page <n>]',
+            enrich: 'people enrich --email <email> | --first-name <name> --last-name <name> --domain <domain> | --linkedin <url>',
+            'bulk-enrich': 'people bulk-enrich --emails <e1,e2,e3>',
+          },
+          organizations: {
+            search: 'organizations search [--locations <l1,l2>] [--employee-ranges <1,100>] [--keywords <kw>] [--page <n>]',
+            enrich: 'organizations enrich --domain <domain>',
+          },
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})