hvac-marketing-skills/tools/clis/snov.js

#!/usr/bin/env node

const CLIENT_ID = process.env.SNOV_CLIENT_ID
const CLIENT_SECRET = process.env.SNOV_CLIENT_SECRET
const BASE_URL = 'https://api.snov.io/v1'

if (!CLIENT_ID || !CLIENT_SECRET) {
  console.error(JSON.stringify({ error: 'SNOV_CLIENT_ID and SNOV_CLIENT_SECRET environment variables required' }))
  process.exit(1)
}

let cachedToken = null

async function getToken() {
  if (cachedToken) return cachedToken
  const res = await fetch('https://api.snov.io/v1/oauth/access_token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ grant_type: 'client_credentials', client_id: CLIENT_ID, client_secret: CLIENT_SECRET }),
  })
  const data = await res.json()
  if (!data.access_token) {
    throw new Error(data.error_description || data.error || 'Failed to obtain access token')
  }
  cachedToken = data.access_token
  return cachedToken
}

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', Accept: 'application/json' }, body: body || undefined }
  }
  const token = await getToken()
  const opts = {
    method,
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json',
      'Accept': 'application/json',
    },
  }
  if (body) opts.body = JSON.stringify(body)
  const res = await fetch(`${BASE_URL}${path}`, opts)
  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 'domain':
      switch (sub) {
        case 'search': {
          const domain = args.domain
          if (!domain) { result = { error: '--domain required' }; break }
          const body = { domain, type: args.type || 'all', limit: Number(args.limit || 100), lastId: 0 }
          result = await api('POST', '/get-domain-emails-with-info', body)
          break
        }
        case 'count': {
          const domain = args.domain
          if (!domain) { result = { error: '--domain required' }; break }
          result = await api('POST', '/get-domain-emails-count', { domain })
          break
        }
        default:
          result = { error: 'Unknown domain subcommand. Use: search, count' }
      }
      break

    case 'email':
      switch (sub) {
        case 'find': {
          const domain = args.domain
          const firstName = args['first-name']
          const lastName = args['last-name']
          if (!domain || !firstName || !lastName) { result = { error: '--domain, --first-name, and --last-name required' }; break }
          result = await api('POST', '/get-emails-from-names', { firstName, lastName, domain })
          break
        }
        case 'verify': {
          const email = args.email
          if (!email) { result = { error: '--email required' }; break }
          result = await api('POST', '/get-emails-verification-status', { emails: [email] })
          break
        }
        default:
          result = { error: 'Unknown email subcommand. Use: find, verify' }
      }
      break

    case 'prospect':
      switch (sub) {
        case 'find': {
          const email = args.email
          if (!email) { result = { error: '--email required' }; break }
          result = await api('POST', '/get-prospect-by-email', { email })
          break
        }
        case 'add': {
          const email = args.email
          if (!email) { result = { error: '--email required' }; break }
          const body = { email }
          if (args['first-name']) body.firstName = args['first-name']
          if (args['last-name']) body.lastName = args['last-name']
          if (args['list-id']) body.listId = args['list-id']
          result = await api('POST', '/add-prospect-to-list', body)
          break
        }
        default:
          result = { error: 'Unknown prospect subcommand. Use: find, add' }
      }
      break

    case 'lists':
      switch (sub) {
        case 'list':
          result = await api('GET', '/get-user-lists')
          break
        case 'prospects': {
          const id = args.id
          if (!id) { result = { error: '--id required' }; break }
          const params = new URLSearchParams({ listId: id })
          if (args.page) params.set('page', args.page)
          if (args['per-page']) params.set('perPage', args['per-page'])
          result = await api('GET', `/prospect-list?${params.toString()}`)
          break
        }
        default:
          result = { error: 'Unknown lists subcommand. Use: list, prospects' }
      }
      break

    case 'technology':
      switch (sub) {
        case 'check': {
          const domain = args.domain
          if (!domain) { result = { error: '--domain required' }; break }
          result = await api('POST', '/get-technology-checker', { domain })
          break
        }
        default:
          result = { error: 'Unknown technology subcommand. Use: check' }
      }
      break

    case 'drips':
      switch (sub) {
        case 'list':
          result = await api('GET', '/get-user-campaigns')
          break
        case 'get': {
          const id = args.id
          if (!id) { result = { error: '--id required' }; break }
          result = await api('GET', `/get-emails-from-campaign?id=${encodeURIComponent(id)}`)
          break
        }
        case 'add-prospect': {
          const campaignId = args['campaign-id']
          const email = args.email
          if (!campaignId || !email) { result = { error: '--campaign-id and --email required' }; break }
          const body = { campaignId, email }
          if (args['first-name']) body.firstName = args['first-name']
          if (args['last-name']) body.lastName = args['last-name']
          result = await api('POST', '/add-prospect-to-email-campaign', body)
          break
        }
        default:
          result = { error: 'Unknown drips subcommand. Use: list, get, add-prospect' }
      }
      break

    default:
      result = {
        error: 'Unknown command',
        usage: {
          domain: {
            search: 'domain search --domain <domain> [--type all|personal|generic] [--limit <n>]',
            count: 'domain count --domain <domain>',
          },
          email: {
            find: 'email find --domain <domain> --first-name <name> --last-name <name>',
            verify: 'email verify --email <email>',
          },
          prospect: {
            find: 'prospect find --email <email>',
            add: 'prospect add --email <email> [--first-name <name>] [--last-name <name>] [--list-id <id>]',
          },
          lists: {
            list: 'lists list',
            prospects: 'lists prospects --id <id> [--page <n>] [--per-page <n>]',
          },
          technology: 'technology check --domain <domain>',
          drips: {
            list: 'drips list',
            get: 'drips get --id <id>',
            'add-prospect': 'drips add-prospect --campaign-id <id> --email <email> [--first-name <name>] [--last-name <name>]',
          },
        }
      }
  }

  console.log(JSON.stringify(result, null, 2))
}

main().catch(err => {
  console.error(JSON.stringify({ error: err.message }))
  process.exit(1)
})