@miranda0808/maya-codex 0.1.0

package/payload/tools/REGISTRY.md

@@ -0,0 +1,368 @@
+# Marketing Tools Registry
+
+Quick reference for AI agents to discover tool capabilities and integration methods.
+
+## How to Use This Registry
+
+1. **Find tools by category** - Browse sections below for tools in each domain
+2. **Check integration methods** - See what APIs, MCPs, CLIs, or SDKs are available
+3. **Read integration guides** - Detailed setup and common operations in `integrations/`
+
+---
+
+## Tool Index
+
+| Tool | Category | API | MCP | CLI | SDK | Guide |
+|------|----------|:---:|:---:|:---:|:---:|-------|
+| ga4 | Analytics | ✓ | ✓ | [✓](clis/ga4.js) | ✓ | [ga4.md](integrations/ga4.md) |
+| mixpanel | Analytics | ✓ | - | [✓](clis/mixpanel.js) | ✓ | [mixpanel.md](integrations/mixpanel.md) |
+| amplitude | Analytics | ✓ | - | [✓](clis/amplitude.js) | ✓ | [amplitude.md](integrations/amplitude.md) |
+| posthog | Analytics | ✓ | - | ✓ | ✓ | [posthog.md](integrations/posthog.md) |
+| segment | Analytics | ✓ | - | [✓](clis/segment.js) | ✓ | [segment.md](integrations/segment.md) |
+| adobe-analytics | Analytics | ✓ | - | [✓](clis/adobe-analytics.js) | ✓ | [adobe-analytics.md](integrations/adobe-analytics.md) |
+| plausible | Analytics | ✓ | - | [✓](clis/plausible.js) | - | [plausible.md](integrations/plausible.md) |
+| google-search-console | SEO | ✓ | - | [✓](clis/google-search-console.js) | ✓ | [google-search-console.md](integrations/google-search-console.md) |
+| semrush | SEO | ✓ | - | [✓](clis/semrush.js) | - | [semrush.md](integrations/semrush.md) |
+| ahrefs | SEO | ✓ | - | [✓](clis/ahrefs.js) | - | [ahrefs.md](integrations/ahrefs.md) |
+| dataforseo | SEO | ✓ | - | [✓](clis/dataforseo.js) | ✓ | [dataforseo.md](integrations/dataforseo.md) |
+| keywords-everywhere | SEO | ✓ | - | [✓](clis/keywords-everywhere.js) | - | [keywords-everywhere.md](integrations/keywords-everywhere.md) |
+| clearbit | Data Enrichment | ✓ | - | [✓](clis/clearbit.js) | ✓ | [clearbit.md](integrations/clearbit.md) |
+| apollo | Data Enrichment | ✓ | - | [✓](clis/apollo.js) | - | [apollo.md](integrations/apollo.md) |
+| hubspot | CRM | ✓ | - | ✓ | ✓ | [hubspot.md](integrations/hubspot.md) |
+| salesforce | CRM | ✓ | - | ✓ | ✓ | [salesforce.md](integrations/salesforce.md) |
+| stripe | Payments | ✓ | ✓ | ✓ | ✓ | [stripe.md](integrations/stripe.md) |
+| paddle | Payments | ✓ | - | [✓](clis/paddle.js) | ✓ | [paddle.md](integrations/paddle.md) |
+| rewardful | Referral | ✓ | - | [✓](clis/rewardful.js) | - | [rewardful.md](integrations/rewardful.md) |
+| tolt | Referral | ✓ | - | [✓](clis/tolt.js) | - | [tolt.md](integrations/tolt.md) |
+| dub-co | Links | ✓ | - | [✓](clis/dub.js) | ✓ | [dub-co.md](integrations/dub-co.md) |
+| mention-me | Referral | ✓ | - | [✓](clis/mention-me.js) | - | [mention-me.md](integrations/mention-me.md) |
+| partnerstack | Affiliate | ✓ | - | [✓](clis/partnerstack.js) | - | [partnerstack.md](integrations/partnerstack.md) |
+| mailchimp | Email | ✓ | ✓ | [✓](clis/mailchimp.js) | ✓ | [mailchimp.md](integrations/mailchimp.md) |
+| customer-io | Email | ✓ | - | [✓](clis/customer-io.js) | ✓ | [customer-io.md](integrations/customer-io.md) |
+| sendgrid | Email | ✓ | - | [✓](clis/sendgrid.js) | ✓ | [sendgrid.md](integrations/sendgrid.md) |
+| resend | Email | ✓ | ✓ | [✓](clis/resend.js) | ✓ | [resend.md](integrations/resend.md) |
+| kit | Email | ✓ | - | [✓](clis/kit.js) | ✓ | [kit.md](integrations/kit.md) |
+| beehiiv | Newsletter | ✓ | - | [✓](clis/beehiiv.js) | - | [beehiiv.md](integrations/beehiiv.md) |
+| klaviyo | Email/SMS | ✓ | - | [✓](clis/klaviyo.js) | ✓ | [klaviyo.md](integrations/klaviyo.md) |
+| postmark | Email | ✓ | - | [✓](clis/postmark.js) | ✓ | [postmark.md](integrations/postmark.md) |
+| brevo | Email/SMS | ✓ | - | [✓](clis/brevo.js) | ✓ | [brevo.md](integrations/brevo.md) |
+| activecampaign | Email/CRM | ✓ | - | [✓](clis/activecampaign.js) | ✓ | [activecampaign.md](integrations/activecampaign.md) |
+| hunter | Email Outreach | ✓ | - | [✓](clis/hunter.js) | - | [hunter.md](integrations/hunter.md) |
+| snov | Email Outreach | ✓ | - | [✓](clis/snov.js) | - | [snov.md](integrations/snov.md) |
+| lemlist | Email Outreach | ✓ | - | [✓](clis/lemlist.js) | - | [lemlist.md](integrations/lemlist.md) |
+| instantly | Email Outreach | ✓ | - | [✓](clis/instantly.js) | - | [instantly.md](integrations/instantly.md) |
+| google-ads | Ads | ✓ | ✓ | [✓](clis/google-ads.js) | ✓ | [google-ads.md](integrations/google-ads.md) |
+| meta-ads | Ads | ✓ | - | [✓](clis/meta-ads.js) | ✓ | [meta-ads.md](integrations/meta-ads.md) |
+| linkedin-ads | Ads | ✓ | - | [✓](clis/linkedin-ads.js) | - | [linkedin-ads.md](integrations/linkedin-ads.md) |
+| tiktok-ads | Ads | ✓ | - | [✓](clis/tiktok-ads.js) | ✓ | [tiktok-ads.md](integrations/tiktok-ads.md) |
+| zapier | Automation | ✓ | ✓ | [✓](clis/zapier.js) | - | [zapier.md](integrations/zapier.md) |
+| hotjar | CRO | ✓ | - | [✓](clis/hotjar.js) | - | [hotjar.md](integrations/hotjar.md) |
+| optimizely | A/B Testing | ✓ | - | [✓](clis/optimizely.js) | ✓ | [optimizely.md](integrations/optimizely.md) |
+| calendly | Scheduling | ✓ | - | [✓](clis/calendly.js) | - | [calendly.md](integrations/calendly.md) |
+| savvycal | Scheduling | ✓ | - | [✓](clis/savvycal.js) | - | [savvycal.md](integrations/savvycal.md) |
+| typeform | Forms | ✓ | - | [✓](clis/typeform.js) | ✓ | [typeform.md](integrations/typeform.md) |
+| intercom | Messaging | ✓ | - | [✓](clis/intercom.js) | ✓ | [intercom.md](integrations/intercom.md) |
+| buffer | Social | ✓ | - | [✓](clis/buffer.js) | - | [buffer.md](integrations/buffer.md) |
+| wistia | Video | ✓ | - | [✓](clis/wistia.js) | - | [wistia.md](integrations/wistia.md) |
+| trustpilot | Reviews | ✓ | - | [✓](clis/trustpilot.js) | - | [trustpilot.md](integrations/trustpilot.md) |
+| g2 | Reviews | ✓ | - | [✓](clis/g2.js) | - | [g2.md](integrations/g2.md) |
+| onesignal | Push | ✓ | - | [✓](clis/onesignal.js) | ✓ | [onesignal.md](integrations/onesignal.md) |
+| demio | Webinar | ✓ | - | [✓](clis/demio.js) | - | [demio.md](integrations/demio.md) |
+| livestorm | Webinar | ✓ | - | [✓](clis/livestorm.js) | - | [livestorm.md](integrations/livestorm.md) |
+| shopify | Commerce | ✓ | - | ✓ | ✓ | [shopify.md](integrations/shopify.md) |
+| wordpress | CMS | ✓ | - | ✓ | ✓ | [wordpress.md](integrations/wordpress.md) |
+| webflow | CMS | ✓ | - | ✓ | ✓ | [webflow.md](integrations/webflow.md) |
+
+---
+
+## By Category
+
+### Analytics
+
+Track user behavior, measure conversions, and analyze marketing performance.
+
+| Tool | Best For | MCP Available |
+|------|----------|:-------------:|
+| **ga4** | Web analytics, Google ecosystem | ✓ |
+| **mixpanel** | Product analytics, event tracking | - |
+| **amplitude** | Product analytics, cohort analysis | - |
+| **posthog** | Open-source analytics, session replay | - |
+| **segment** | Customer data platform, routing | - |
+| **adobe-analytics** | Enterprise analytics | - |
+| **plausible** | Privacy-focused analytics | - |
+
+**Agent recommendation**: Start with GA4 if using Google ecosystem. Use Mixpanel or Amplitude for deeper product analytics. Plausible for privacy-focused sites.
+
+### SEO
+
+Search engine optimization tools for keyword research, rank tracking, and site audits.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **google-search-console** | Free, authoritative search data | Direct from Google |
+| **semrush** | Competitive analysis, keyword research | Comprehensive |
+| **ahrefs** | Backlink analysis, content research | Best for links |
+| **dataforseo** | SERP tracking, backlinks, on-page audits | Comprehensive API |
+| **keywords-everywhere** | Quick keyword research, traffic estimates | Credit-based |
+
+**Agent recommendation**: Google Search Console is essential (free). Add Semrush or Ahrefs for competitive research. DataForSEO for programmatic SERP data. Keywords Everywhere for quick keyword lookups.
+
+### CRM
+
+Customer relationship management and sales tools.
+
+| Tool | Best For | CLI Available |
+|------|----------|:-------------:|
+| **hubspot** | SMB, marketing + sales alignment | ✓ |
+| **salesforce** | Enterprise, complex sales processes | ✓ |
+
+**Agent recommendation**: HubSpot for startups/SMBs, Salesforce for enterprise.
+
+### Payments
+
+Payment processing and subscription management.
+
+| Tool | Best For | MCP Available |
+|------|----------|:-------------:|
+| **stripe** | SaaS subscriptions, developer-friendly | ✓ |
+
+| **paddle** | SaaS billing with tax handling | - |
+
+**Agent recommendation**: Stripe is the default for SaaS. Paddle for built-in tax compliance.
+
+### Referral & Affiliate
+
+Tools for referral programs, affiliate tracking, and partner management.
+
+| Tool | Best For | Stripe Integration |
+|------|----------|:------------------:|
+| **rewardful** | Stripe-native affiliate programs | ✓ |
+| **tolt** | SaaS affiliate programs | ✓ |
+| **mention-me** | Enterprise referral programs | ✓ |
+| **dub-co** | Link tracking, attribution | - |
+| **partnerstack** | Enterprise partner programs | ✓ |
+
+**Agent recommendation**: Rewardful or Tolt for Stripe-based SaaS. PartnerStack for enterprise partner programs. Dub.co for link attribution.
+
+### Email
+
+Email marketing, transactional email, and automation platforms.
+
+| Tool | Best For | MCP Available |
+|------|----------|:-------------:|
+| **mailchimp** | SMB email marketing | ✓ |
+| **customer-io** | Behavior-based messaging | - |
+| **sendgrid** | Transactional email at scale | - |
+| **resend** | Developer-friendly transactional | ✓ |
+| **kit** | Creator/newsletter focused | - |
+| **beehiiv** | Newsletter platform | - |
+| **klaviyo** | E-commerce email + SMS | - |
+| **postmark** | Deliverability-focused transactional | - |
+| **brevo** | Email + SMS, popular in EU | - |
+| **activecampaign** | Email automation + CRM | - |
+
+**Agent recommendation**: Resend for transactional (dev-friendly). Postmark for deliverability. Customer.io for advanced automation. Kit for creators. Beehiiv for newsletters. Klaviyo for e-commerce email/SMS. ActiveCampaign for email + CRM combo.
+
+### Advertising
+
+Paid advertising platforms and campaign management.
+
+| Tool | Best For | MCP Available |
+|------|----------|:-------------:|
+| **google-ads** | Search intent, high-intent traffic | ✓ |
+| **meta-ads** | Demand gen, visual products, B2C | - |
+| **linkedin-ads** | B2B, job title targeting | - |
+| **tiktok-ads** | Younger demographics, video | - |
+
+**Agent recommendation**: Google Ads for search intent. Meta for demand generation. LinkedIn for B2B.
+
+### Automation
+
+Workflow automation and integration platforms.
+
+| Tool | Best For | MCP Available |
+|------|----------|:-------------:|
+| **zapier** | No-code integrations | ✓ |
+
+**Agent recommendation**: Zapier for connecting tools without code.
+
+### CRO & A/B Testing
+
+Conversion rate optimization, heatmaps, and experimentation.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **hotjar** | Heatmaps, recordings, surveys | Visual behavior data |
+| **optimizely** | A/B testing, feature flags | Enterprise experimentation |
+
+**Agent recommendation**: Hotjar for understanding user behavior. Optimizely for running experiments.
+
+### Scheduling
+
+Booking and appointment scheduling tools.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **calendly** | Meeting scheduling, lead gen | Most popular |
+| **savvycal** | Personalized scheduling | Developer-friendly |
+
+**Agent recommendation**: Calendly for general use. SavvyCal for personalized booking experiences.
+
+### Forms & Surveys
+
+Form builders and survey platforms.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **typeform** | Interactive forms, surveys | Conversational UX |
+
+**Agent recommendation**: Typeform for engaging forms and surveys.
+
+### Messaging
+
+In-app messaging, chat, and customer communication.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **intercom** | In-app messaging, support, product tours | Full customer platform |
+
+**Agent recommendation**: Intercom for in-app messaging and customer support.
+
+### Social Media
+
+Social media scheduling, management, and analytics.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **buffer** | Social scheduling, analytics | Multi-platform |
+
+**Agent recommendation**: Buffer for scheduling and analytics across social platforms.
+
+### Video
+
+Video hosting, analytics, and engagement.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **wistia** | Video hosting, marketing analytics | Best for marketing video |
+
+**Agent recommendation**: Wistia for marketing video hosting with analytics.
+
+### Data Enrichment
+
+Company and person data enrichment for sales and marketing.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **clearbit** | Company/person enrichment | Now HubSpot Breeze |
+| **apollo** | B2B prospecting, email finding | Large database |
+
+**Agent recommendation**: Clearbit for enrichment. Apollo for prospecting and outbound.
+
+### Reviews
+
+Review management and social proof platforms.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **trustpilot** | Consumer business reviews | Most recognized |
+| **g2** | Software/B2B reviews | Best for SaaS |
+
+**Agent recommendation**: Trustpilot for consumer products. G2 for B2B software.
+
+### Push Notifications
+
+Push notification delivery platforms.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **onesignal** | Multi-channel push notifications | Web + mobile |
+
+**Agent recommendation**: OneSignal for web and mobile push notifications.
+
+### Webinar
+
+Webinar and virtual event platforms.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **demio** | Marketing webinars | Simple, focused |
+| **livestorm** | Video engagement, webinars | Full event platform |
+
+**Agent recommendation**: Demio for marketing-focused webinars. Livestorm for full event engagement.
+
+### Email Outreach
+
+Cold email outreach and email finding tools for link building and sales prospecting.
+
+| Tool | Best For | Notes |
+|------|----------|-------|
+| **hunter** | Email finding, domain search | Largest email database |
+| **snov** | Email finding, drip campaigns | Built-in sequences |
+| **lemlist** | Cold email campaigns | Personalization features |
+| **instantly** | Cold email at scale | Email warmup built-in |
+
+**Agent recommendation**: Hunter for finding emails. Lemlist or Instantly for sending cold email campaigns. Snov for combined finding + outreach.
+
+### Commerce & CMS
+
+E-commerce platforms and content management systems.
+
+| Tool | Best For | CLI Available |
+|------|----------|:-------------:|
+| **shopify** | E-commerce, product sales | ✓ |
+| **wordpress** | Blogs, content sites | ✓ |
+| **webflow** | Design-focused marketing sites | ✓ |
+
+**Agent recommendation**: Shopify for e-commerce. Webflow for marketing sites. WordPress for blogs.
+
+---
+
+## CLI Tools
+
+Zero-dependency, single-file Node.js CLIs for tools that don't ship their own. See [`clis/README.md`](clis/README.md) for install instructions and usage.
+
+All CLIs follow a consistent pattern:
+- **No dependencies** — Node 18+ only, uses native `fetch`
+- **JSON output** — pipe to `jq`, save to file, or use in scripts
+- **Env var auth** — set `{TOOL}_API_KEY` and go
+- **Consistent commands** — `{tool} <resource> <action> [options]`
+
+---
+
+## MCP-Enabled Tools
+
+These tools have Model Context Protocol servers available, enabling direct agent interaction:
+
+- **ga4** - Google Analytics 4 data access
+- **stripe** - Payment and subscription management
+- **mailchimp** - Email campaign management
+- **google-ads** - Ad campaign management
+- **resend** - Transactional email sending
+- **zapier** - Workflow automation
+
+To use MCP tools, ensure the appropriate MCP server is configured in your environment.
+
+---
+
+## Quick Start by Use Case
+
+### Setting up analytics tracking
+1. Read [ga4.md](integrations/ga4.md) for web analytics
+2. Read [segment.md](integrations/segment.md) if routing to multiple tools
+
+### Launching a referral program
+1. Read [rewardful.md](integrations/rewardful.md) or [tolt.md](integrations/tolt.md) for Stripe-based programs
+2. Read [dub-co.md](integrations/dub-co.md) for link tracking
+
+### Setting up email automation
+1. Read [customer-io.md](integrations/customer-io.md) for behavior-based automation
+2. Read [resend.md](integrations/resend.md) for transactional email
+
+### Running email outreach for backlinks
+1. Read [hunter.md](integrations/hunter.md) for finding emails
+2. Read [lemlist.md](integrations/lemlist.md) or [instantly.md](integrations/instantly.md) for sending campaigns
+
+### Running paid ads
+1. Read [google-ads.md](integrations/google-ads.md) for search campaigns
+2. Read [meta-ads.md](integrations/meta-ads.md) for social campaigns

package/payload/tools/clis/README.md

@@ -0,0 +1,187 @@
+# Marketing CLIs
+
+Zero-dependency, single-file CLI tools for marketing platforms that don't ship their own.
+
+Every CLI is a standalone Node.js script (Node 18+) with no `npm install` required — just `chmod +x` and go.
+
+## Install
+
+### Option 1: Run directly
+
+```bash
+node tools/clis/ahrefs.js backlinks list --target example.com
+```
+
+### Option 2: Symlink for global access
+
+```bash
+# Symlink any CLI you want available globally
+ln -sf "$(pwd)/tools/clis/ahrefs.js" ~/.local/bin/ahrefs
+ln -sf "$(pwd)/tools/clis/resend.js" ~/.local/bin/resend
+
+# Then use directly
+ahrefs backlinks list --target example.com
+resend send --from you@example.com --to them@example.com --subject "Hello" --html "<p>Hi</p>"
+```
+
+### Option 3: Add the whole directory to PATH
+
+```bash
+export PATH="$PATH:/path/to/marketingskills/tools/clis"
+```
+
+## Authentication
+
+Every CLI reads credentials from environment variables:
+
+| CLI | Environment Variable |
+|-----|---------------------|
+| `activecampaign` | `ACTIVECAMPAIGN_API_KEY`, `ACTIVECAMPAIGN_API_URL` |
+| `adobe-analytics` | `ADOBE_ACCESS_TOKEN`, `ADOBE_CLIENT_ID`, `ADOBE_COMPANY_ID` |
+| `ahrefs` | `AHREFS_API_KEY` |
+| `amplitude` | `AMPLITUDE_API_KEY`, `AMPLITUDE_SECRET_KEY` |
+| `apollo` | `APOLLO_API_KEY` |
+| `beehiiv` | `BEEHIIV_API_KEY` |
+| `brevo` | `BREVO_API_KEY` |
+| `buffer` | `BUFFER_API_KEY` |
+| `calendly` | `CALENDLY_API_KEY` |
+| `clearbit` | `CLEARBIT_API_KEY` |
+| `customer-io` | `CUSTOMERIO_APP_KEY` (App API), `CUSTOMERIO_SITE_ID` + `CUSTOMERIO_API_KEY` (Track API) |
+| `dataforseo` | `DATAFORSEO_LOGIN`, `DATAFORSEO_PASSWORD` |
+| `demio` | `DEMIO_API_KEY`, `DEMIO_API_SECRET` |
+| `dub` | `DUB_API_KEY` |
+| `g2` | `G2_API_TOKEN` |
+| `ga4` | `GA4_ACCESS_TOKEN` |
+| `google-ads` | `GOOGLE_ADS_TOKEN`, `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_CUSTOMER_ID` |
+| `google-search-console` | `GSC_ACCESS_TOKEN` |
+| `hotjar` | `HOTJAR_CLIENT_ID`, `HOTJAR_CLIENT_SECRET` |
+| `intercom` | `INTERCOM_API_KEY` |
+| `keywords-everywhere` | `KEYWORDS_EVERYWHERE_API_KEY` |
+| `kit` | `KIT_API_KEY`, `KIT_API_SECRET` |
+| `klaviyo` | `KLAVIYO_API_KEY` |
+| `linkedin-ads` | `LINKEDIN_ACCESS_TOKEN` |
+| `livestorm` | `LIVESTORM_API_TOKEN` |
+| `mailchimp` | `MAILCHIMP_API_KEY` |
+| `mention-me` | `MENTIONME_API_KEY` |
+| `meta-ads` | `META_ACCESS_TOKEN`, `META_AD_ACCOUNT_ID` |
+| `mixpanel` | `MIXPANEL_TOKEN` (ingestion), `MIXPANEL_API_KEY` + `MIXPANEL_SECRET` (query) |
+| `onesignal` | `ONESIGNAL_REST_API_KEY`, `ONESIGNAL_APP_ID` |
+| `optimizely` | `OPTIMIZELY_API_KEY` |
+| `paddle` | `PADDLE_API_KEY`, `PADDLE_SANDBOX` (optional) |
+| `partnerstack` | `PARTNERSTACK_PUBLIC_KEY`, `PARTNERSTACK_SECRET_KEY` |
+| `plausible` | `PLAUSIBLE_API_KEY`, `PLAUSIBLE_BASE_URL` (optional, for self-hosted) |
+| `postmark` | `POSTMARK_API_KEY` |
+| `resend` | `RESEND_API_KEY` |
+| `rewardful` | `REWARDFUL_API_KEY` |
+| `savvycal` | `SAVVYCAL_API_KEY` |
+| `segment` | `SEGMENT_WRITE_KEY` (tracking), `SEGMENT_ACCESS_TOKEN` (profile) |
+| `semrush` | `SEMRUSH_API_KEY` |
+| `sendgrid` | `SENDGRID_API_KEY` |
+| `tiktok-ads` | `TIKTOK_ACCESS_TOKEN`, `TIKTOK_ADVERTISER_ID` |
+| `tolt` | `TOLT_API_KEY` |
+| `trustpilot` | `TRUSTPILOT_API_KEY`, `TRUSTPILOT_API_SECRET`, `TRUSTPILOT_BUSINESS_UNIT_ID` |
+| `typeform` | `TYPEFORM_API_KEY` |
+| `hunter` | `HUNTER_API_KEY` |
+| `instantly` | `INSTANTLY_API_KEY` |
+| `lemlist` | `LEMLIST_API_KEY` |
+| `snov` | `SNOV_CLIENT_ID`, `SNOV_CLIENT_SECRET` |
+| `wistia` | `WISTIA_API_KEY` |
+| `zapier` | `ZAPIER_API_KEY` |
+
+## Security
+
+**Never hardcode API keys or tokens in scripts.** All CLIs read credentials exclusively from environment variables.
+
+- Store keys in your shell profile (`~/.zshrc`, `~/.bashrc`) or a `.env` file
+- The `.env` file is gitignored — but double-check before committing
+- Use `--dry-run` on any command to preview the request without sending it (credentials are masked as `***`)
+- If you fork this repo, audit your commits to ensure no secrets are included
+
+## Command Pattern
+
+All CLIs follow the same structure:
+
+```
+{tool} <resource> <action> [options]
+```
+
+Examples:
+
+```bash
+ahrefs backlinks list --target example.com --limit 50
+semrush keywords overview --phrase "marketing automation" --database us
+mailchimp campaigns list --limit 20
+resend send --from you@example.com --to them@example.com --subject "Hello" --html "<p>Hi</p>"
+dub links create --url https://example.com/landing --key summer-sale
+```
+
+## Output
+
+All CLIs output JSON to stdout for easy piping:
+
+```bash
+# Pipe to jq
+ahrefs backlinks list --target example.com | jq '.backlinks[].url_from'
+
+# Save to file
+semrush keywords overview --phrase "saas marketing" --database us > keywords.json
+
+# Use in scripts
+DOMAINS=$(rewardful affiliates list | jq -r '.data[].email')
+```
+
+## Available CLIs
+
+| CLI | Category | Tool |
+|-----|----------|------|
+| `activecampaign.js` | Email/CRM | [ActiveCampaign](https://activecampaign.com) |
+| `adobe-analytics.js` | Analytics | [Adobe Analytics](https://business.adobe.com/products/analytics) |
+| `ahrefs.js` | SEO | [Ahrefs](https://ahrefs.com) |
+| `amplitude.js` | Analytics | [Amplitude](https://amplitude.com) |
+| `apollo.js` | Data Enrichment | [Apollo.io](https://apollo.io) |
+| `beehiiv.js` | Newsletter | [Beehiiv](https://beehiiv.com) |
+| `brevo.js` | Email/SMS | [Brevo](https://brevo.com) |
+| `buffer.js` | Social | [Buffer](https://buffer.com) |
+| `calendly.js` | Scheduling | [Calendly](https://calendly.com) |
+| `clearbit.js` | Data Enrichment | [Clearbit](https://clearbit.com) |
+| `customer-io.js` | Email | [Customer.io](https://customer.io) |
+| `dataforseo.js` | SEO | [DataForSEO](https://dataforseo.com) |
+| `demio.js` | Webinar | [Demio](https://demio.com) |
+| `dub.js` | Links | [Dub.co](https://dub.co) |
+| `g2.js` | Reviews | [G2](https://g2.com) |
+| `ga4.js` | Analytics | [Google Analytics 4](https://analytics.google.com) |
+| `google-ads.js` | Ads | [Google Ads](https://ads.google.com) |
+| `google-search-console.js` | SEO | [Google Search Console](https://search.google.com/search-console) |
+| `hotjar.js` | CRO | [Hotjar](https://hotjar.com) |
+| `hunter.js` | Email Outreach | [Hunter.io](https://hunter.io) |
+| `instantly.js` | Email Outreach | [Instantly.ai](https://instantly.ai) |
+| `intercom.js` | Messaging | [Intercom](https://intercom.com) |
+| `keywords-everywhere.js` | SEO | [Keywords Everywhere](https://keywordseverywhere.com) |
+| `kit.js` | Email | [Kit](https://kit.com) |
+| `klaviyo.js` | Email/SMS | [Klaviyo](https://klaviyo.com) |
+| `lemlist.js` | Email Outreach | [Lemlist](https://lemlist.com) |
+| `linkedin-ads.js` | Ads | [LinkedIn Ads](https://business.linkedin.com/marketing-solutions/ads) |
+| `livestorm.js` | Webinar | [Livestorm](https://livestorm.co) |
+| `mailchimp.js` | Email | [Mailchimp](https://mailchimp.com) |
+| `mention-me.js` | Referral | [Mention Me](https://www.mention-me.com) |
+| `meta-ads.js` | Ads | [Meta Ads](https://www.facebook.com/business/ads) |
+| `mixpanel.js` | Analytics | [Mixpanel](https://mixpanel.com) |
+| `onesignal.js` | Push | [OneSignal](https://onesignal.com) |
+| `optimizely.js` | A/B Testing | [Optimizely](https://optimizely.com) |
+| `paddle.js` | Payments | [Paddle](https://paddle.com) |
+| `partnerstack.js` | Affiliate | [PartnerStack](https://partnerstack.com) |
+| `plausible.js` | Analytics | [Plausible](https://plausible.io) |
+| `postmark.js` | Email | [Postmark](https://postmarkapp.com) |
+| `resend.js` | Email | [Resend](https://resend.com) |
+| `rewardful.js` | Referral | [Rewardful](https://www.getrewardful.com) |
+| `savvycal.js` | Scheduling | [SavvyCal](https://savvycal.com) |
+| `segment.js` | Analytics | [Segment](https://segment.com) |
+| `semrush.js` | SEO | [SEMrush](https://semrush.com) |
+| `sendgrid.js` | Email | [SendGrid](https://sendgrid.com) |
+| `snov.js` | Email Outreach | [Snov.io](https://snov.io) |
+| `tiktok-ads.js` | Ads | [TikTok Ads](https://ads.tiktok.com) |
+| `tolt.js` | Referral | [Tolt](https://tolt.io) |
+| `trustpilot.js` | Reviews | [Trustpilot](https://trustpilot.com) |
+| `typeform.js` | Forms | [Typeform](https://typeform.com) |
+| `wistia.js` | Video | [Wistia](https://wistia.com) |
+| `zapier.js` | Automation | [Zapier](https://zapier.com) |