feat: add 22 zero-dependency CLI tools for marketing platforms

Single-file Node.js scripts for every tool in the registry that lacked a CLI. All follow the same pattern: env var auth, JSON output, consistent `{tool} <resource> <action>` command structure, zero npm dependencies. CLIs added: resend, sendgrid, mailchimp, kit, customer-io, ahrefs, semrush, google-search-console, ga4, mixpanel, amplitude, segment, adobe-analytics, rewardful, tolt, mention-me, dub, google-ads, meta-ads, linkedin-ads, tiktok-ads, zapier. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 06:28:46 -08:00
parent a04cb61a57
commit 98bd9ede62
24 changed files with 4232 additions and 22 deletions
@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+
+const TOKEN = process.env.TIKTOK_ACCESS_TOKEN
+const ADVERTISER_ID = process.env.TIKTOK_ADVERTISER_ID
+const BASE_URL = 'https://business-api.tiktok.com/open_api/v1.3'
+
+if (!TOKEN) {
+  console.error(JSON.stringify({ error: 'TIKTOK_ACCESS_TOKEN environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const opts = {
+    method,
+    headers: {
+      'Access-Token': TOKEN,
+      'Content-Type': 'application/json',
+    },
+  }
+  if (body && method === 'POST') {
+    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._
+
+function getAdvertiserId() {
+  return args['advertiser-id'] || ADVERTISER_ID
+}
+
+async function main() {
+  let result
+
+  switch (cmd) {
+    case 'advertiser':
+      switch (sub) {
+        case 'info': {
+          const advId = getAdvertiserId()
+          if (!advId) { result = { error: 'TIKTOK_ADVERTISER_ID env or --advertiser-id required' }; break }
+          result = await api('GET', `/advertiser/info/?advertiser_ids=["${advId}"]`)
+          break
+        }
+        default:
+          result = { error: 'Unknown advertiser subcommand. Use: info' }
+      }
+      break
+
+    case 'campaigns':
+      switch (sub) {
+        case 'list': {
+          const advId = getAdvertiserId()
+          if (!advId) { result = { error: 'TIKTOK_ADVERTISER_ID env or --advertiser-id required' }; break }
+          result = await api('GET', `/campaign/get/?advertiser_id=${advId}&page=1&page_size=20`)
+          break
+        }
+        case 'create': {
+          const advId = getAdvertiserId()
+          if (!advId) { result = { error: 'TIKTOK_ADVERTISER_ID env or --advertiser-id required' }; break }
+          if (!args.name || !args.objective) { result = { error: '--name and --objective required' }; break }
+          const body = {
+            advertiser_id: advId,
+            campaign_name: args.name,
+            objective_type: args.objective,
+            budget_mode: args['budget-mode'] || 'BUDGET_MODE_DAY',
+          }
+          if (args.budget) body.budget = parseFloat(args.budget)
+          result = await api('POST', '/campaign/create/', body)
+          break
+        }
+        case 'update-status': {
+          const advId = getAdvertiserId()
+          if (!advId) { result = { error: 'TIKTOK_ADVERTISER_ID env or --advertiser-id required' }; break }
+          if (!args.ids || !args.status) { result = { error: '--ids and --status required' }; break }
+          result = await api('POST', '/campaign/status/update/', {
+            advertiser_id: advId,
+            campaign_ids: args.ids.split(','),
+            opt_status: args.status,
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown campaigns subcommand. Use: list, create, update-status' }
+      }
+      break
+
+    case 'adgroups':
+      switch (sub) {
+        case 'list': {
+          const advId = getAdvertiserId()
+          if (!advId) { result = { error: 'TIKTOK_ADVERTISER_ID env or --advertiser-id required' }; break }
+          let path = `/adgroup/get/?advertiser_id=${advId}`
+          if (args['campaign-id']) path += `&campaign_ids=["${args['campaign-id']}"]`
+          result = await api('GET', path)
+          break
+        }
+        default:
+          result = { error: 'Unknown adgroups subcommand. Use: list' }
+      }
+      break
+
+    case 'reports':
+      switch (sub) {
+        case 'get': {
+          const advId = getAdvertiserId()
+          if (!advId) { result = { error: 'TIKTOK_ADVERTISER_ID env or --advertiser-id required' }; break }
+          if (!args['start-date'] || !args['end-date']) { result = { error: '--start-date and --end-date required (YYYY-MM-DD)' }; break }
+          const body = {
+            advertiser_id: advId,
+            report_type: 'BASIC',
+            dimensions: args.dimensions ? args.dimensions.split(',') : ['campaign_id'],
+            metrics: args.metrics ? args.metrics.split(',') : ['spend', 'impressions', 'clicks', 'conversion'],
+            data_level: args['data-level'] || 'AUCTION_CAMPAIGN',
+            start_date: args['start-date'],
+            end_date: args['end-date'],
+          }
+          result = await api('POST', '/report/integrated/get/', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown reports subcommand. Use: get' }
+      }
+      break
+
+    case 'audiences':
+      switch (sub) {
+        case 'list': {
+          const advId = getAdvertiserId()
+          if (!advId) { result = { error: 'TIKTOK_ADVERTISER_ID env or --advertiser-id required' }; break }
+          result = await api('GET', `/dmp/custom_audience/list/?advertiser_id=${advId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown audiences subcommand. Use: list' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          advertiser: 'advertiser [info]',
+          campaigns: 'campaigns [list|create|update-status] [--name <name>] [--objective <obj>] [--budget-mode BUDGET_MODE_DAY] [--budget <amount>] [--ids <id1,id2>] [--status ENABLE|DISABLE]',
+          adgroups: 'adgroups [list] [--campaign-id <id>]',
+          reports: 'reports [get] --start-date YYYY-MM-DD --end-date YYYY-MM-DD [--dimensions campaign_id] [--metrics spend,impressions,clicks,conversion] [--data-level AUCTION_CAMPAIGN]',
+          audiences: 'audiences [list]',
+        },
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})