feat: add 23 new CLI tools and integration guides
New tools across 13 categories: - Email/Newsletter: beehiiv, klaviyo, postmark, brevo, activecampaign - Data Enrichment: clearbit, apollo - CRO/Testing: hotjar, optimizely - Analytics: plausible - Scheduling: calendly, savvycal - Forms: typeform - Messaging: intercom - Social: buffer - Video: wistia - Payments: paddle - Affiliate: partnerstack - Reviews: trustpilot, g2 - Push: onesignal - Webinar: demio, livestorm Each tool includes a zero-dependency CLI and integration guide. Registry and CLI README updated with all new entries. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Executable
+365
@@ -0,0 +1,365 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
const API_KEY = process.env.BREVO_API_KEY
|
||||
const BASE_URL = 'https://api.brevo.com/v3'
|
||||
|
||||
if (!API_KEY) {
|
||||
console.error(JSON.stringify({ error: 'BREVO_API_KEY environment variable required' }))
|
||||
process.exit(1)
|
||||
}
|
||||
|
||||
async function api(method, path, body) {
|
||||
const res = await fetch(`${BASE_URL}${path}`, {
|
||||
method,
|
||||
headers: {
|
||||
'api-key': API_KEY,
|
||||
'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
|
||||
const limit = args.limit ? Number(args.limit) : 50
|
||||
const offset = args.offset ? Number(args.offset) : 0
|
||||
|
||||
switch (cmd) {
|
||||
case 'account':
|
||||
switch (sub) {
|
||||
case 'get':
|
||||
result = await api('GET', '/account')
|
||||
break
|
||||
default:
|
||||
result = { error: 'Unknown account subcommand. Use: get' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'contacts':
|
||||
switch (sub) {
|
||||
case 'list': {
|
||||
const params = new URLSearchParams()
|
||||
params.set('limit', String(limit))
|
||||
params.set('offset', String(offset))
|
||||
if (args.sort) params.set('sort', args.sort)
|
||||
result = await api('GET', `/contacts?${params.toString()}`)
|
||||
break
|
||||
}
|
||||
case 'get': {
|
||||
const id = args.id || args.email
|
||||
if (!id) { result = { error: '--id or --email required' }; break }
|
||||
result = await api('GET', `/contacts/${encodeURIComponent(id)}`)
|
||||
break
|
||||
}
|
||||
case 'create': {
|
||||
const email = args.email
|
||||
if (!email) { result = { error: '--email required' }; break }
|
||||
const body = { email }
|
||||
if (args['first-name'] || args['last-name']) {
|
||||
body.attributes = {}
|
||||
if (args['first-name']) body.attributes.FIRSTNAME = args['first-name']
|
||||
if (args['last-name']) body.attributes.LASTNAME = args['last-name']
|
||||
}
|
||||
if (args['list-ids']) body.listIds = args['list-ids'].split(',').map(Number)
|
||||
result = await api('POST', '/contacts', body)
|
||||
break
|
||||
}
|
||||
case 'update': {
|
||||
const id = args.id || args.email
|
||||
if (!id) { result = { error: '--id or --email required' }; break }
|
||||
const body = {}
|
||||
if (args['first-name'] || args['last-name']) {
|
||||
body.attributes = {}
|
||||
if (args['first-name']) body.attributes.FIRSTNAME = args['first-name']
|
||||
if (args['last-name']) body.attributes.LASTNAME = args['last-name']
|
||||
}
|
||||
if (args['list-ids']) body.listIds = args['list-ids'].split(',').map(Number)
|
||||
if (args['unlink-list-ids']) body.unlinkListIds = args['unlink-list-ids'].split(',').map(Number)
|
||||
result = await api('PUT', `/contacts/${encodeURIComponent(id)}`, body)
|
||||
break
|
||||
}
|
||||
case 'delete': {
|
||||
const id = args.id || args.email
|
||||
if (!id) { result = { error: '--id or --email required' }; break }
|
||||
result = await api('DELETE', `/contacts/${encodeURIComponent(id)}`)
|
||||
break
|
||||
}
|
||||
case 'import': {
|
||||
const emails = args.emails?.split(',')
|
||||
if (!emails) { result = { error: '--emails required (comma-separated)' }; break }
|
||||
const body = {
|
||||
jsonBody: emails.map(e => ({ email: e.trim() })),
|
||||
}
|
||||
if (args['list-ids']) body.listIds = args['list-ids'].split(',').map(Number)
|
||||
result = await api('POST', '/contacts/import', body)
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown contacts subcommand. Use: list, get, create, update, delete, import' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'lists':
|
||||
switch (sub) {
|
||||
case 'list': {
|
||||
const params = new URLSearchParams()
|
||||
params.set('limit', String(limit))
|
||||
params.set('offset', String(offset))
|
||||
if (args.sort) params.set('sort', args.sort)
|
||||
result = await api('GET', `/contacts/lists?${params.toString()}`)
|
||||
break
|
||||
}
|
||||
case 'get': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
result = await api('GET', `/contacts/lists/${id}`)
|
||||
break
|
||||
}
|
||||
case 'create': {
|
||||
const name = args.name
|
||||
if (!name) { result = { error: '--name required' }; break }
|
||||
const body = { name, folderId: args.folder ? Number(args.folder) : 1 }
|
||||
result = await api('POST', '/contacts/lists', body)
|
||||
break
|
||||
}
|
||||
case 'update': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
const body = {}
|
||||
if (args.name) body.name = args.name
|
||||
if (args.folder) body.folderId = Number(args.folder)
|
||||
result = await api('PUT', `/contacts/lists/${id}`, body)
|
||||
break
|
||||
}
|
||||
case 'delete': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
result = await api('DELETE', `/contacts/lists/${id}`)
|
||||
break
|
||||
}
|
||||
case 'contacts': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
const params = new URLSearchParams()
|
||||
params.set('limit', String(limit))
|
||||
params.set('offset', String(offset))
|
||||
result = await api('GET', `/contacts/lists/${id}/contacts?${params.toString()}`)
|
||||
break
|
||||
}
|
||||
case 'add-contacts': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
const emails = args.emails?.split(',')
|
||||
if (!emails) { result = { error: '--emails required (comma-separated)' }; break }
|
||||
result = await api('POST', `/contacts/lists/${id}/contacts/add`, { emails })
|
||||
break
|
||||
}
|
||||
case 'remove-contacts': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
const emails = args.emails?.split(',')
|
||||
if (!emails) { result = { error: '--emails required (comma-separated)' }; break }
|
||||
result = await api('POST', `/contacts/lists/${id}/contacts/remove`, { emails })
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown lists subcommand. Use: list, get, create, update, delete, contacts, add-contacts, remove-contacts' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'email':
|
||||
switch (sub) {
|
||||
case 'send': {
|
||||
const senderEmail = args.from
|
||||
const to = args.to
|
||||
const subject = args.subject
|
||||
if (!senderEmail) { result = { error: '--from required' }; break }
|
||||
if (!to) { result = { error: '--to required' }; break }
|
||||
if (!subject) { result = { error: '--subject required' }; break }
|
||||
const body = {
|
||||
sender: { email: senderEmail },
|
||||
to: to.split(',').map(e => ({ email: e.trim() })),
|
||||
subject,
|
||||
}
|
||||
if (args['sender-name']) body.sender.name = args['sender-name']
|
||||
if (args.html) body.htmlContent = args.html
|
||||
if (args.text) body.textContent = args.text
|
||||
if (!args.html && !args.text) body.textContent = ''
|
||||
if (args['reply-to']) body.replyTo = { email: args['reply-to'] }
|
||||
if (args.tags) body.tags = args.tags.split(',')
|
||||
result = await api('POST', '/smtp/email', body)
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown email subcommand. Use: send' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'campaigns':
|
||||
switch (sub) {
|
||||
case 'list': {
|
||||
const params = new URLSearchParams()
|
||||
params.set('limit', String(limit))
|
||||
params.set('offset', String(offset))
|
||||
if (args.type) params.set('type', args.type)
|
||||
if (args.status) params.set('status', args.status)
|
||||
if (args.sort) params.set('sort', args.sort)
|
||||
result = await api('GET', `/emailCampaigns?${params.toString()}`)
|
||||
break
|
||||
}
|
||||
case 'get': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
result = await api('GET', `/emailCampaigns/${id}`)
|
||||
break
|
||||
}
|
||||
case 'create': {
|
||||
const name = args.name
|
||||
if (!name) { result = { error: '--name required' }; break }
|
||||
const body = {
|
||||
name,
|
||||
sender: { email: args.from || '' },
|
||||
subject: args.subject || '',
|
||||
}
|
||||
if (args['sender-name']) body.sender.name = args['sender-name']
|
||||
if (args.html) body.htmlContent = args.html
|
||||
if (args['list-ids']) body.recipients = { listIds: args['list-ids'].split(',').map(Number) }
|
||||
result = await api('POST', '/emailCampaigns', body)
|
||||
break
|
||||
}
|
||||
case 'update': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
const body = {}
|
||||
if (args.name) body.name = args.name
|
||||
if (args.subject) body.subject = args.subject
|
||||
if (args.html) body.htmlContent = args.html
|
||||
result = await api('PUT', `/emailCampaigns/${id}`, body)
|
||||
break
|
||||
}
|
||||
case 'delete': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
result = await api('DELETE', `/emailCampaigns/${id}`)
|
||||
break
|
||||
}
|
||||
case 'send-now': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
result = await api('POST', `/emailCampaigns/${id}/sendNow`)
|
||||
break
|
||||
}
|
||||
case 'send-test': {
|
||||
const id = args.id
|
||||
if (!id) { result = { error: '--id required' }; break }
|
||||
const emails = args.emails?.split(',')
|
||||
if (!emails) { result = { error: '--emails required (comma-separated)' }; break }
|
||||
result = await api('POST', `/emailCampaigns/${id}/sendTest`, { emailTo: emails })
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown campaigns subcommand. Use: list, get, create, update, delete, send-now, send-test' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'sms':
|
||||
switch (sub) {
|
||||
case 'send': {
|
||||
const sender = args.from
|
||||
const recipient = args.to
|
||||
const content = args.content
|
||||
if (!sender) { result = { error: '--from required (sender name)' }; break }
|
||||
if (!recipient) { result = { error: '--to required (phone number)' }; break }
|
||||
if (!content) { result = { error: '--content required' }; break }
|
||||
result = await api('POST', '/transactionalSMS/sms', {
|
||||
sender,
|
||||
recipient,
|
||||
content,
|
||||
type: args.type || 'transactional',
|
||||
})
|
||||
break
|
||||
}
|
||||
case 'campaigns': {
|
||||
const params = new URLSearchParams()
|
||||
params.set('limit', String(limit))
|
||||
params.set('offset', String(offset))
|
||||
if (args.status) params.set('status', args.status)
|
||||
result = await api('GET', `/smsCampaigns?${params.toString()}`)
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown sms subcommand. Use: send, campaigns' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'senders':
|
||||
switch (sub) {
|
||||
case 'list':
|
||||
result = await api('GET', '/senders')
|
||||
break
|
||||
case 'create': {
|
||||
const name = args.name
|
||||
const email = args.email
|
||||
if (!name) { result = { error: '--name required' }; break }
|
||||
if (!email) { result = { error: '--email required' }; break }
|
||||
result = await api('POST', '/senders', { name, email })
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown senders subcommand. Use: list, create' }
|
||||
}
|
||||
break
|
||||
|
||||
default:
|
||||
result = {
|
||||
error: 'Unknown command',
|
||||
usage: {
|
||||
account: 'account [get]',
|
||||
contacts: 'contacts [list | get --email <email> | create --email <email> | update --email <email> | delete --email <email> | import --emails <e1,e2>]',
|
||||
lists: 'lists [list | get --id <id> | create --name <name> | delete --id <id> | contacts --id <id> | add-contacts --id <id> --emails <e1,e2> | remove-contacts --id <id> --emails <e1,e2>]',
|
||||
email: 'email [send --from <from> --to <to> --subject <subj>]',
|
||||
campaigns: 'campaigns [list | get --id <id> | create --name <name> | send-now --id <id> | send-test --id <id> --emails <e1,e2>]',
|
||||
sms: 'sms [send --from <name> --to <phone> --content <msg> | campaigns]',
|
||||
senders: 'senders [list | create --name <name> --email <email>]',
|
||||
options: '--limit <n> --offset <n> --status <status>',
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log(JSON.stringify(result, null, 2))
|
||||
}
|
||||
|
||||
main().catch(err => {
|
||||
console.error(JSON.stringify({ error: err.message }))
|
||||
process.exit(1)
|
||||
})
|
||||
Reference in New Issue
Block a user