diff --git a/AGENTS.md b/AGENTS.md
index dbdf724..a5bb382 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -152,6 +152,34 @@ Follow the [Conventional Commits](https://www.conventionalcommits.org/) specific
- [ ] `SKILL.md` is under 500 lines
- [ ] No sensitive data or credentials
+## Tool Integrations
+
+This repository includes a tools registry for agent-compatible marketing tools.
+
+- **Tool discovery**: Read `tools/REGISTRY.md` to see available tools and their capabilities
+- **Integration details**: See `tools/integrations/{tool}.md` for API endpoints, auth, and common operations
+- **MCP-enabled tools**: ga4, stripe, mailchimp, google-ads, resend, zapier
+
+### Registry Structure
+
+```
+tools/
+├── REGISTRY.md # Index of all tools with capabilities
+└── integrations/ # Detailed integration guides
+ ├── ga4.md
+ ├── stripe.md
+ ├── rewardful.md
+ └── ...
+```
+
+### When to Use Tools
+
+Skills reference relevant tools for implementation. For example:
+- `referral-program` skill → rewardful, tolt, dub-co, mention-me guides
+- `analytics-tracking` skill → ga4, mixpanel, segment guides
+- `email-sequence` skill → customer-io, mailchimp, resend guides
+- `paid-ads` skill → google-ads, meta-ads, linkedin-ads guides
+
## Skill Categories
See `README.md` for the current list of skills organized by category. When adding new skills, follow the naming patterns of existing skills in that category.
diff --git a/skills/analytics-tracking/SKILL.md b/skills/analytics-tracking/SKILL.md
index 1ef392c..63513d6 100644
--- a/skills/analytics-tracking/SKILL.md
+++ b/skills/analytics-tracking/SKILL.md
@@ -285,6 +285,20 @@ dataLayer.push({
---
+## Tool Integrations
+
+For implementation, see the [tools registry](../../tools/REGISTRY.md). Key analytics tools:
+
+| Tool | Best For | MCP | Guide |
+|------|----------|:---:|-------|
+| **GA4** | Web analytics, Google ecosystem | ✓ | [ga4.md](../../tools/integrations/ga4.md) |
+| **Mixpanel** | Product analytics, event tracking | - | [mixpanel.md](../../tools/integrations/mixpanel.md) |
+| **Amplitude** | Product analytics, cohort analysis | - | [amplitude.md](../../tools/integrations/amplitude.md) |
+| **PostHog** | Open-source analytics, session replay | - | [posthog.md](../../tools/integrations/posthog.md) |
+| **Segment** | Customer data platform, routing | - | [segment.md](../../tools/integrations/segment.md) |
+
+---
+
## Related Skills
- **ab-test-setup**: For experiment tracking
diff --git a/skills/email-sequence/SKILL.md b/skills/email-sequence/SKILL.md
index a44acd4..93007b7 100644
--- a/skills/email-sequence/SKILL.md
+++ b/skills/email-sequence/SKILL.md
@@ -283,6 +283,20 @@ What to measure and benchmarks
---
+## Tool Integrations
+
+For implementation, see the [tools registry](../../tools/REGISTRY.md). Key email tools:
+
+| Tool | Best For | MCP | Guide |
+|------|----------|:---:|-------|
+| **Customer.io** | Behavior-based automation | - | [customer-io.md](../../tools/integrations/customer-io.md) |
+| **Mailchimp** | SMB email marketing | ✓ | [mailchimp.md](../../tools/integrations/mailchimp.md) |
+| **Resend** | Developer-friendly transactional | ✓ | [resend.md](../../tools/integrations/resend.md) |
+| **SendGrid** | Transactional email at scale | - | [sendgrid.md](../../tools/integrations/sendgrid.md) |
+| **Kit** | Creator/newsletter focused | - | [kit.md](../../tools/integrations/kit.md) |
+
+---
+
## Related Skills
- **onboarding-cro**: For in-app onboarding (email supports this)
diff --git a/skills/paid-ads/SKILL.md b/skills/paid-ads/SKILL.md
index 9f2f7a4..0264ff4 100644
--- a/skills/paid-ads/SKILL.md
+++ b/skills/paid-ads/SKILL.md
@@ -289,6 +289,21 @@ Before launching campaigns, ensure proper tracking and account setup.
---
+## Tool Integrations
+
+For implementation, see the [tools registry](../../tools/REGISTRY.md). Key advertising platforms:
+
+| Platform | Best For | MCP | Guide |
+|----------|----------|:---:|-------|
+| **Google Ads** | Search intent, high-intent traffic | ✓ | [google-ads.md](../../tools/integrations/google-ads.md) |
+| **Meta Ads** | Demand gen, visual products, B2C | - | [meta-ads.md](../../tools/integrations/meta-ads.md) |
+| **LinkedIn Ads** | B2B, job title targeting | - | [linkedin-ads.md](../../tools/integrations/linkedin-ads.md) |
+| **TikTok Ads** | Younger demographics, video | - | [tiktok-ads.md](../../tools/integrations/tiktok-ads.md) |
+
+For tracking, see also: [ga4.md](../../tools/integrations/ga4.md), [segment.md](../../tools/integrations/segment.md)
+
+---
+
## Related Skills
- **copywriting**: For landing page copy that converts ad traffic
diff --git a/skills/referral-program/SKILL.md b/skills/referral-program/SKILL.md
index 2152e37..b1bc23b 100644
--- a/skills/referral-program/SKILL.md
+++ b/skills/referral-program/SKILL.md
@@ -231,6 +231,20 @@ They get [their reward] too.
---
+## Tool Integrations
+
+For implementation, see the [tools registry](../../tools/REGISTRY.md). Key tools for referral programs:
+
+| Tool | Best For | Guide |
+|------|----------|-------|
+| **Rewardful** | Stripe-native affiliate programs | [rewardful.md](../../tools/integrations/rewardful.md) |
+| **Tolt** | SaaS affiliate programs | [tolt.md](../../tools/integrations/tolt.md) |
+| **Mention Me** | Enterprise referral programs | [mention-me.md](../../tools/integrations/mention-me.md) |
+| **Dub.co** | Link tracking and attribution | [dub-co.md](../../tools/integrations/dub-co.md) |
+| **Stripe** | Payment processing (for commission tracking) | [stripe.md](../../tools/integrations/stripe.md) |
+
+---
+
## Related Skills
- **launch-strategy**: For launching referral program effectively
diff --git a/tools/REGISTRY.md b/tools/REGISTRY.md
new file mode 100644
index 0000000..6f81b9e
--- /dev/null
+++ b/tools/REGISTRY.md
@@ -0,0 +1,194 @@
+# 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 | ✓ | ✓ | - | ✓ | [ga4.md](integrations/ga4.md) |
+| mixpanel | Analytics | ✓ | - | - | ✓ | [mixpanel.md](integrations/mixpanel.md) |
+| amplitude | Analytics | ✓ | - | - | ✓ | [amplitude.md](integrations/amplitude.md) |
+| posthog | Analytics | ✓ | - | ✓ | ✓ | [posthog.md](integrations/posthog.md) |
+| segment | Analytics | ✓ | - | - | ✓ | [segment.md](integrations/segment.md) |
+| adobe-analytics | Analytics | ✓ | - | - | ✓ | [adobe-analytics.md](integrations/adobe-analytics.md) |
+| google-search-console | SEO | ✓ | - | - | ✓ | [google-search-console.md](integrations/google-search-console.md) |
+| semrush | SEO | ✓ | - | - | - | [semrush.md](integrations/semrush.md) |
+| ahrefs | SEO | ✓ | - | - | - | [ahrefs.md](integrations/ahrefs.md) |
+| hubspot | CRM | ✓ | - | ✓ | ✓ | [hubspot.md](integrations/hubspot.md) |
+| salesforce | CRM | ✓ | - | ✓ | ✓ | [salesforce.md](integrations/salesforce.md) |
+| stripe | Payments | ✓ | ✓ | ✓ | ✓ | [stripe.md](integrations/stripe.md) |
+| rewardful | Referral | ✓ | - | - | - | [rewardful.md](integrations/rewardful.md) |
+| tolt | Referral | ✓ | - | - | - | [tolt.md](integrations/tolt.md) |
+| dub-co | Links | ✓ | - | - | ✓ | [dub-co.md](integrations/dub-co.md) |
+| mention-me | Referral | ✓ | - | - | - | [mention-me.md](integrations/mention-me.md) |
+| mailchimp | Email | ✓ | ✓ | - | ✓ | [mailchimp.md](integrations/mailchimp.md) |
+| customer-io | Email | ✓ | - | - | ✓ | [customer-io.md](integrations/customer-io.md) |
+| sendgrid | Email | ✓ | - | - | ✓ | [sendgrid.md](integrations/sendgrid.md) |
+| resend | Email | ✓ | ✓ | - | ✓ | [resend.md](integrations/resend.md) |
+| kit | Email | ✓ | - | - | ✓ | [kit.md](integrations/kit.md) |
+| google-ads | Ads | ✓ | ✓ | - | ✓ | [google-ads.md](integrations/google-ads.md) |
+| meta-ads | Ads | ✓ | - | - | ✓ | [meta-ads.md](integrations/meta-ads.md) |
+| linkedin-ads | Ads | ✓ | - | - | - | [linkedin-ads.md](integrations/linkedin-ads.md) |
+| tiktok-ads | Ads | ✓ | - | - | ✓ | [tiktok-ads.md](integrations/tiktok-ads.md) |
+| zapier | Automation | ✓ | ✓ | - | - | [zapier.md](integrations/zapier.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 | - |
+
+**Agent recommendation**: Start with GA4 if using Google ecosystem. Use Mixpanel or Amplitude for deeper product analytics.
+
+### 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 |
+
+**Agent recommendation**: Google Search Console is essential (free). Add Semrush or Ahrefs for competitive research.
+
+### 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 | ✓ |
+
+**Agent recommendation**: Stripe is the default for SaaS and developer-focused products.
+
+### 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 | - |
+
+**Agent recommendation**: Rewardful or Tolt for Stripe-based SaaS. 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 | - |
+
+**Agent recommendation**: Resend for transactional (dev-friendly). Customer.io for advanced automation. Kit for creators.
+
+### 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.
+
+### 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.
+
+---
+
+## 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 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
diff --git a/tools/integrations/adobe-analytics.md b/tools/integrations/adobe-analytics.md
new file mode 100644
index 0000000..8179551
--- /dev/null
+++ b/tools/integrations/adobe-analytics.md
@@ -0,0 +1,156 @@
+# Adobe Analytics
+
+Enterprise analytics platform for cross-channel measurement and attribution.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Reporting API 2.0, Data Insertion API |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | ✓ | AppMeasurement.js, Mobile SDKs, Launch |
+
+## Authentication
+
+- **Type**: OAuth 2.0 (Service Account JWT)
+- **Setup**: Create integration in Adobe Developer Console
+- **Header**: `Authorization: Bearer {access_token}`
+
+## Common Agent Operations
+
+### Get report suite info
+
+```bash
+GET https://analytics.adobe.io/api/{company_id}/reportsuites
+
+Authorization: Bearer {access_token}
+x-api-key: {client_id}
+```
+
+### Get dimensions
+
+```bash
+GET https://analytics.adobe.io/api/{company_id}/dimensions?rsid={report_suite_id}
+
+Authorization: Bearer {access_token}
+x-api-key: {client_id}
+```
+
+### Get metrics
+
+```bash
+GET https://analytics.adobe.io/api/{company_id}/metrics?rsid={report_suite_id}
+
+Authorization: Bearer {access_token}
+x-api-key: {client_id}
+```
+
+### Run report
+
+```bash
+POST https://analytics.adobe.io/api/{company_id}/reports
+
+{
+ "rsid": "{report_suite_id}",
+ "globalFilters": [{
+ "type": "dateRange",
+ "dateRange": "2024-01-01T00:00:00/2024-01-31T23:59:59"
+ }],
+ "metricContainer": {
+ "metrics": [
+ {"id": "metrics/visits"},
+ {"id": "metrics/pageviews"},
+ {"id": "metrics/orders"}
+ ]
+ },
+ "dimension": "variables/evar1"
+}
+```
+
+### Get segments
+
+```bash
+GET https://analytics.adobe.io/api/{company_id}/segments?rsid={report_suite_id}
+
+Authorization: Bearer {access_token}
+x-api-key: {client_id}
+```
+
+### Data Insertion (server-side)
+
+```bash
+POST https://{tracking_server}/b/ss/{report_suite_id}/0
+
+
+
Email content here
", + "email_layout_template": "default" +} +``` + +## Key Concepts + +- **Subscribers** - Email contacts +- **Forms** - Signup forms +- **Sequences** - Automated email series +- **Tags** - Subscriber labels +- **Broadcasts** - One-time sends +- **Custom Fields** - Subscriber attributes + +## Subscriber States + +- `active` - Can receive emails +- `unsubscribed` - Opted out +- `bounced` - Email bounced +- `complained` - Marked as spam +- `inactive` - Cold subscriber + +## When to Use + +- Creator/newsletter businesses +- Simple email automation +- Form-based list building +- Tagging and segmentation +- Course email sequences + +## Rate Limits + +- 120 requests per minute +- Batch endpoints available + +## Relevant Skills + +- email-sequence +- content-strategy diff --git a/tools/integrations/linkedin-ads.md b/tools/integrations/linkedin-ads.md new file mode 100644 index 0000000..b9dc585 --- /dev/null +++ b/tools/integrations/linkedin-ads.md @@ -0,0 +1,164 @@ +# LinkedIn Ads + +B2B advertising platform with professional targeting. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Marketing API for campaigns, audiences, analytics | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | - | API-only (community libraries available) | + +## Authentication + +- **Type**: OAuth 2.0 +- **Header**: `Authorization: Bearer {access_token}` +- **Scopes**: `r_ads`, `r_ads_reporting`, `rw_ads` + +## Common Agent Operations + +### Get ad accounts + +```bash +GET https://api.linkedin.com/v2/adAccountsV2?q=search + +Authorization: Bearer {access_token} +``` + +### Get campaigns + +```bash +GET https://api.linkedin.com/v2/adCampaignsV2?q=search&search.account.values[0]=urn:li:sponsoredAccount:{account_id} + +Authorization: Bearer {access_token} +``` + +### Get campaign analytics + +```bash +GET https://api.linkedin.com/v2/adAnalyticsV2?q=analytics&pivot=CAMPAIGN&dateRange.start.year=2024&dateRange.start.month=1&dateRange.start.day=1&dateRange.end.year=2024&dateRange.end.month=1&dateRange.end.day=31&campaigns=urn:li:sponsoredCampaign:{campaign_id}&fields=impressions,clicks,costInLocalCurrency,conversions + +Authorization: Bearer {access_token} +``` + +### Create campaign + +```bash +POST https://api.linkedin.com/v2/adCampaignsV2 + +Authorization: Bearer {access_token} + +{ + "account": "urn:li:sponsoredAccount:{account_id}", + "name": "Campaign Name", + "type": "SPONSORED_UPDATES", + "costType": "CPC", + "unitCost": { + "amount": "5.00", + "currencyCode": "USD" + }, + "dailyBudget": { + "amount": "100.00", + "currencyCode": "USD" + }, + "status": "PAUSED" +} +``` + +### Update campaign status + +```bash +POST https://api.linkedin.com/v2/adCampaignsV2/{campaign_id} + +Authorization: Bearer {access_token} + +{ + "patch": { + "$set": { + "status": "ACTIVE" + } + } +} +``` + +### Get creatives + +```bash +GET https://api.linkedin.com/v2/adCreativesV2?q=search&search.campaign.values[0]=urn:li:sponsoredCampaign:{campaign_id} + +Authorization: Bearer {access_token} +``` + +### Get audience counts + +```bash +POST https://api.linkedin.com/v2/audienceCountsV2 + +{ + "audienceCriteria": { + "include": { + "and": [{ + "or": { + "urn:li:adTargetingFacet:titles": ["urn:li:title:123"] + } + }] + } + } +} +``` + +## Key Metrics + +| Metric | Description | +|--------|-------------| +| `impressions` | Ad impressions | +| `clicks` | Total clicks | +| `costInLocalCurrency` | Spend | +| `conversions` | Conversion count | +| `leadGenerationMailContactInfoShares` | Lead form submissions | + +## Campaign Types + +- `SPONSORED_UPDATES` - Sponsored content +- `TEXT_AD` - Text ads +- `SPONSORED_INMAILS` - Message ads +- `DYNAMIC` - Dynamic ads + +## Targeting Options + +### Job-Based +- Job titles +- Job functions +- Seniority levels +- Years of experience + +### Company-Based +- Company names +- Industries +- Company size +- Company followers + +### Professional +- Skills +- Groups +- Schools +- Degrees + +## When to Use + +- B2B advertising +- Job title targeting +- Account-based marketing +- Lead generation campaigns + +## Rate Limits + +- 100 requests/day (basic) +- 10,000 requests/day (Marketing Developer Platform) + +## Relevant Skills + +- paid-ads +- analytics-tracking diff --git a/tools/integrations/mailchimp.md b/tools/integrations/mailchimp.md new file mode 100644 index 0000000..09eac2b --- /dev/null +++ b/tools/integrations/mailchimp.md @@ -0,0 +1,150 @@ +# Mailchimp + +Email marketing platform for campaigns, automation, and audience management. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Marketing API for campaigns, audiences, automation | +| MCP | ✓ | Available via Mailchimp MCP server | +| CLI | - | Not available | +| SDK | ✓ | Official SDKs for multiple languages | + +## Authentication + +- **Type**: API Key or OAuth 2.0 +- **Header**: `Authorization: Bearer {api_key}` or `Authorization: apikey {api_key}` +- **Base URL**: `https://{dc}.api.mailchimp.com/3.0/` (dc = datacenter from API key) + +## Common Agent Operations + +### List audiences (lists) + +```bash +GET https://{dc}.api.mailchimp.com/3.0/lists +``` + +### Get audience members + +```bash +GET https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members?count=100 +``` + +### Add subscriber + +```bash +POST https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members + +{ + "email_address": "user@example.com", + "status": "subscribed", + "merge_fields": { + "FNAME": "John", + "LNAME": "Doe" + } +} +``` + +### Update subscriber + +```bash +PATCH https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members/{subscriber_hash} + +{ + "merge_fields": { + "FNAME": "Jane" + }, + "tags": ["customer", "premium"] +} +``` + +### Get campaigns + +```bash +GET https://{dc}.api.mailchimp.com/3.0/campaigns?count=20 +``` + +### Get campaign report + +```bash +GET https://{dc}.api.mailchimp.com/3.0/reports/{campaign_id} +``` + +### Create campaign + +```bash +POST https://{dc}.api.mailchimp.com/3.0/campaigns + +{ + "type": "regular", + "recipients": { + "list_id": "{list_id}" + }, + "settings": { + "subject_line": "Your Subject", + "from_name": "Your Name", + "reply_to": "reply@example.com" + } +} +``` + +### Send campaign + +```bash +POST https://{dc}.api.mailchimp.com/3.0/campaigns/{campaign_id}/actions/send +``` + +### List automations + +```bash +GET https://{dc}.api.mailchimp.com/3.0/automations +``` + +## Key Metrics + +### Campaign Report Fields +- `emails_sent` - Total sent +- `opens` - Open count +- `unique_opens` - Unique opens +- `open_rate` - Open rate +- `clicks` - Click count +- `click_rate` - Click rate +- `unsubscribes` - Unsubscribe count +- `bounces` - Bounce count + +### Subscriber Hash + +Calculate subscriber hash for updates: +```javascript +const hash = md5(email.toLowerCase()); +``` + +## Subscriber Statuses + +- `subscribed` - Active subscriber +- `unsubscribed` - Unsubscribed +- `cleaned` - Hard bounce +- `pending` - Awaiting confirmation +- `transactional` - Transactional only + +## When to Use + +- Managing email lists and subscribers +- Creating and sending email campaigns +- Setting up email automation +- Analyzing campaign performance +- Segmenting audiences +- A/B testing emails + +## Rate Limits + +- 10 concurrent connections +- 10 requests per second +- Batch endpoints for bulk operations + +## Relevant Skills + +- email-sequence +- analytics-tracking +- referral-program diff --git a/tools/integrations/mention-me.md b/tools/integrations/mention-me.md new file mode 100644 index 0000000..2734b8e --- /dev/null +++ b/tools/integrations/mention-me.md @@ -0,0 +1,160 @@ +# Mention Me + +Enterprise referral marketing platform for customer advocacy. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for referrals, customers, rewards | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | - | JavaScript widget for embedding | + +## Authentication + +- **Type**: API Key +- **Header**: `Authorization: Bearer {api_key}` +- **Environment**: Separate keys for sandbox and production + +## Common Agent Operations + +### Create referral offer + +```bash +POST https://api.mention-me.com/api/v2/referrer-offer + +{ + "email": "customer@example.com", + "firstname": "John", + "lastname": "Doe", + "order_number": "ORD-123", + "order_total": 99.99, + "order_currency": "USD" +} +``` + +### Get referral link for customer + +```bash +GET https://api.mention-me.com/api/v2/referrer/{customer_id}/share-links +``` + +### Record referee (referred customer) + +```bash +POST https://api.mention-me.com/api/v2/referee + +{ + "email": "referred@example.com", + "firstname": "Jane", + "referrer_code": "JOHN123", + "order_number": "ORD-456", + "order_total": 149.99 +} +``` + +### Get referral status + +```bash +GET https://api.mention-me.com/api/v2/referral/{referral_id} +``` + +### List referrals for customer + +```bash +GET https://api.mention-me.com/api/v2/referrer/{customer_id}/referrals +``` + +### Get reward balance + +```bash +GET https://api.mention-me.com/api/v2/referrer/{customer_id}/rewards +``` + +### Redeem reward + +```bash +POST https://api.mention-me.com/api/v2/referrer/{customer_id}/rewards/redeem + +{ + "reward_id": "RWD-123", + "order_number": "ORD-789" +} +``` + +## JavaScript Widget + +### Embed referral widget + +```html + + + +``` + +### Name share widget + +```javascript +MentionMe.push({ + type: 'nameShare', + customer: { + email: 'customer@example.com' + } +}); +``` + +## Webhook Events + +| Event | When | +|-------|------| +| `referral.created` | New referral tracked | +| `referral.converted` | Referral completed purchase | +| `reward.earned` | Reward unlocked | +| `reward.redeemed` | Reward used | + +## Key Features + +- **A/B testing** - Built-in experiment framework +- **Fraud prevention** - Automatic fraud detection +- **Multi-channel** - Share via link, email, social +- **Name sharing** - Refer by name, not code +- **Segmentation** - Different offers by segment +- **Analytics** - Referral program reporting + +## Key Objects + +- **Referrer** - Customer who refers +- **Referee** - Customer who is referred +- **Referral** - Connection between referrer and referee +- **Offer** - Referral program configuration +- **Reward** - Incentive earned + +## When to Use + +- Enterprise referral programs +- Multi-market referral campaigns +- A/B testing referral offers +- Fraud-resistant referral tracking +- Name-based sharing programs + +## Rate Limits + +- 1000 requests per minute +- Contact for higher limits + +## Relevant Skills + +- referral-program +- pricing-strategy +- analytics-tracking diff --git a/tools/integrations/meta-ads.md b/tools/integrations/meta-ads.md new file mode 100644 index 0000000..b74d300 --- /dev/null +++ b/tools/integrations/meta-ads.md @@ -0,0 +1,147 @@ +# Meta Ads (Facebook/Instagram) + +Advertising platform for Facebook, Instagram, Messenger, and Audience Network. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Marketing API for campaigns, audiences, reporting | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | Official SDKs for Python, PHP, Node.js | + +## Authentication + +- **Type**: OAuth 2.0 Access Token +- **Header**: Access token as query parameter +- **Setup**: Create app in Meta Business Suite, generate System User token + +## Common Agent Operations + +### Get ad accounts + +```bash +GET https://graph.facebook.com/v18.0/me/adaccounts?access_token={access_token}&fields=id,name,account_status +``` + +### Get campaigns + +```bash +GET https://graph.facebook.com/v18.0/act_{ad_account_id}/campaigns?access_token={access_token}&fields=id,name,status,objective,daily_budget +``` + +### Get campaign insights + +```bash +GET https://graph.facebook.com/v18.0/{campaign_id}/insights?access_token={access_token}&fields=impressions,clicks,spend,actions,cost_per_action_type&date_preset=last_30d +``` + +### Get ad sets + +```bash +GET https://graph.facebook.com/v18.0/act_{ad_account_id}/adsets?access_token={access_token}&fields=id,name,status,targeting,daily_budget,bid_amount +``` + +### Get ads + +```bash +GET https://graph.facebook.com/v18.0/{ad_set_id}/ads?access_token={access_token}&fields=id,name,status,creative +``` + +### Create campaign + +```bash +POST https://graph.facebook.com/v18.0/act_{ad_account_id}/campaigns + +access_token={access_token} +&name=Campaign Name +&objective=CONVERSIONS +&status=PAUSED +&special_ad_categories=[] +``` + +### Update campaign status + +```bash +POST https://graph.facebook.com/v18.0/{campaign_id} + +access_token={access_token} +&status=ACTIVE +``` + +### Get custom audiences + +```bash +GET https://graph.facebook.com/v18.0/act_{ad_account_id}/customaudiences?access_token={access_token}&fields=id,name,approximate_count +``` + +### Create lookalike audience + +```bash +POST https://graph.facebook.com/v18.0/act_{ad_account_id}/customaudiences + +access_token={access_token} +&name=Lookalike - Top Customers +&subtype=LOOKALIKE +&origin_audience_id={source_audience_id} +&lookalike_spec={"type":"similarity","country":"US"} +``` + +## Key Metrics + +| Metric | Description | +|--------|-------------| +| `impressions` | Ad impressions | +| `clicks` | All clicks | +| `spend` | Amount spent | +| `reach` | Unique people reached | +| `frequency` | Avg impressions per person | +| `cpm` | Cost per 1000 impressions | +| `cpc` | Cost per click | +| `actions` | Conversions array | +| `cost_per_action_type` | CPA by action | + +## Campaign Objectives + +- `AWARENESS` - Brand awareness +- `TRAFFIC` - Website traffic +- `ENGAGEMENT` - Post engagement +- `LEADS` - Lead generation +- `APP_PROMOTION` - App installs +- `SALES` - Conversions/catalog sales + +## Targeting Options + +```json +{ + "geo_locations": { + "countries": ["US"], + "cities": [{"key": "2420379"}] + }, + "age_min": 25, + "age_max": 45, + "genders": [1, 2], + "interests": [{"id": "6003139266461", "name": "Marketing"}], + "behaviors": [{"id": "6002714895372"}] +} +``` + +## When to Use + +- Creating/managing Facebook and Instagram ads +- Audience targeting and lookalikes +- Campaign performance analysis +- Retargeting setup + +## Rate Limits + +- 200 calls/hour per ad account +- 60 calls/hour for marketing API +- Use batch requests for efficiency + +## Relevant Skills + +- paid-ads +- analytics-tracking +- page-cro diff --git a/tools/integrations/mixpanel.md b/tools/integrations/mixpanel.md new file mode 100644 index 0000000..44833cb --- /dev/null +++ b/tools/integrations/mixpanel.md @@ -0,0 +1,137 @@ +# Mixpanel + +Product analytics platform for tracking user behavior and retention. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Ingestion API, Query API, Data Export | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | JavaScript, iOS, Android, Python, etc. | + +## Authentication + +- **Ingestion**: Project token (public) +- **Query API**: Service Account (username:secret as Basic auth) +- **Export**: API Secret + +## Common Agent Operations + +### Track event (Ingestion API) + +```bash +POST https://api.mixpanel.com/track + +{ + "event": "signup_completed", + "properties": { + "token": "{project_token}", + "distinct_id": "user_123", + "plan": "pro", + "time": 1705312800 + } +} +``` + +### Set user profile + +```bash +POST https://api.mixpanel.com/engage + +{ + "$token": "{project_token}", + "$distinct_id": "user_123", + "$set": { + "$email": "user@example.com", + "$name": "John Doe", + "plan": "pro" + } +} +``` + +### Query events (Query API) + +```bash +POST https://mixpanel.com/api/2.0/insights + +{ + "project_id": {project_id}, + "bookmark_id": null, + "params": { + "events": [{"event": "signup_completed"}], + "time_range": { + "from_date": "2024-01-01", + "to_date": "2024-01-31" + } + } +} +``` + +### Get funnel data + +```bash +GET https://mixpanel.com/api/2.0/funnels?funnel_id={funnel_id}&from_date=2024-01-01&to_date=2024-01-31 +``` + +### Export raw events + +```bash +GET https://data.mixpanel.com/api/2.0/export?from_date=2024-01-01&to_date=2024-01-01 +``` + +### Get retention data + +```bash +GET https://mixpanel.com/api/2.0/retention?from_date=2024-01-01&to_date=2024-01-31&retention_type=birth&born_event=signup_completed +``` + +## JavaScript SDK + +```javascript +// Initialize +mixpanel.init('YOUR_TOKEN'); + +// Identify user +mixpanel.identify('user_123'); + +// Set user properties +mixpanel.people.set({ + '$email': 'user@example.com', + 'plan': 'pro' +}); + +// Track event +mixpanel.track('Feature Used', { + 'feature_name': 'export' +}); +``` + +## Key Concepts + +- **Events** - User actions (signup, purchase, etc.) +- **Properties** - Attributes on events +- **User Profiles** - Persistent user data +- **Cohorts** - Saved user segments +- **Funnels** - Conversion sequences +- **Retention** - User return patterns + +## When to Use + +- Tracking product usage events +- Analyzing conversion funnels +- Measuring feature adoption +- Retention analysis +- User segmentation + +## Rate Limits + +- Ingestion: No hard limit (batch recommended) +- Query API: Varies by plan + +## Relevant Skills + +- analytics-tracking +- ab-test-setup +- onboarding-cro diff --git a/tools/integrations/posthog.md b/tools/integrations/posthog.md new file mode 100644 index 0000000..65b7bf3 --- /dev/null +++ b/tools/integrations/posthog.md @@ -0,0 +1,151 @@ +# PostHog + +Open-source product analytics with session replay and feature flags. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Capture API, Query API, Feature Flags API | +| MCP | - | Not available | +| CLI | ✓ | `posthog` CLI for local development | +| SDK | ✓ | JavaScript, Python, Ruby, Go, etc. | + +## Authentication + +- **Type**: API Key (Personal or Project) +- **Header**: `Authorization: Bearer {api_key}` +- **For capture**: Project API Key in payload + +## Common Agent Operations + +### Capture event + +```bash +POST https://app.posthog.com/capture/ + +{ + "api_key": "{project_api_key}", + "event": "signup_completed", + "distinct_id": "user_123", + "properties": { + "plan": "pro", + "$current_url": "https://example.com/signup" + } +} +``` + +### Batch events + +```bash +POST https://app.posthog.com/batch/ + +{ + "api_key": "{project_api_key}", + "batch": [ + {"event": "pageview", "distinct_id": "user_1"}, + {"event": "signup", "distinct_id": "user_2"} + ] +} +``` + +### Get person by distinct_id + +```bash +GET https://app.posthog.com/api/projects/{project_id}/persons/?distinct_id=user_123 + +Authorization: Bearer {api_key} +``` + +### Query events (HogQL) + +```bash +POST https://app.posthog.com/api/projects/{project_id}/query/ + +{ + "query": { + "kind": "HogQLQuery", + "query": "SELECT event, count() FROM events WHERE timestamp > now() - interval 7 day GROUP BY event ORDER BY count() DESC LIMIT 10" + } +} +``` + +### Get feature flag value + +```bash +POST https://app.posthog.com/decide?v=3 + +{ + "api_key": "{project_api_key}", + "distinct_id": "user_123" +} +``` + +### Get insights + +```bash +GET https://app.posthog.com/api/projects/{project_id}/insights/ + +Authorization: Bearer {api_key} +``` + +### Get session recordings + +```bash +GET https://app.posthog.com/api/projects/{project_id}/session_recordings/ + +Authorization: Bearer {api_key} +``` + +## JavaScript SDK + +```javascript +// Initialize +posthog.init('PROJECT_API_KEY', { + api_host: 'https://app.posthog.com' +}); + +// Identify user +posthog.identify('user_123', { + email: 'user@example.com', + plan: 'pro' +}); + +// Track event +posthog.capture('signup_completed', { + method: 'email' +}); + +// Check feature flag +if (posthog.isFeatureEnabled('new-pricing')) { + // Show new pricing +} +``` + +## Key Features + +- **Event tracking** - Product analytics +- **Session replay** - Watch user sessions +- **Feature flags** - Control feature rollout +- **A/B testing** - Built-in experiments +- **HogQL** - SQL-like query language +- **Self-hostable** - Run on your infrastructure + +## When to Use + +- Product analytics with privacy focus +- Session replay for UX insights +- Feature flag management +- Self-hosted analytics needs +- Open-source requirements + +## Rate Limits + +- Cloud: 10,000 events/second +- Self-hosted: Unlimited + +## Relevant Skills + +- analytics-tracking +- ab-test-setup +- onboarding-cro diff --git a/tools/integrations/resend.md b/tools/integrations/resend.md new file mode 100644 index 0000000..75af93d --- /dev/null +++ b/tools/integrations/resend.md @@ -0,0 +1,168 @@ +# Resend + +Developer-friendly transactional email service with modern API. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Simple REST API for sending emails | +| MCP | ✓ | Available via Resend MCP server | +| CLI | - | Not available | +| SDK | ✓ | Official SDKs for Node.js, Python, Go, etc. | + +## Authentication + +- **Type**: API Key +- **Header**: `Authorization: Bearer {api_key}` +- **Get key**: API Keys section in Resend dashboard + +## Common Agent Operations + +### Send email + +```bash +POST https://api.resend.com/emails + +{ + "from": "hello@example.com", + "to": ["user@example.com"], + "subject": "Welcome!", + "html": "Description
", + "vendor": "Brand", + "product_type": "Category", + "variants": [{ + "price": "99.00", + "sku": "SKU-001" + }] + } +} +``` + +### List orders + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/orders.json?status=any&limit=50 + +X-Shopify-Access-Token: {access_token} +``` + +### Get order + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/orders/{order_id}.json + +X-Shopify-Access-Token: {access_token} +``` + +### List customers + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/customers.json?limit=50 + +X-Shopify-Access-Token: {access_token} +``` + +### Search customers + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/customers/search.json?query=email:user@example.com + +X-Shopify-Access-Token: {access_token} +``` + +### Get analytics + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/reports.json + +X-Shopify-Access-Token: {access_token} +``` + +## GraphQL API + +```graphql +{ + products(first: 10) { + edges { + node { + id + title + totalInventory + priceRangeV2 { + minVariantPrice { + amount + } + } + } + } + } +} +``` + +## CLI Commands + +```bash +# Login +shopify login --store={shop} + +# Create theme +shopify theme init + +# Push theme +shopify theme push + +# Preview theme +shopify theme dev + +# Create app +shopify app create node +``` + +## Webhook Topics + +| Topic | When | +|-------|------| +| `orders/create` | New order | +| `orders/paid` | Order paid | +| `orders/fulfilled` | Order shipped | +| `customers/create` | New customer | +| `products/update` | Product changed | +| `checkouts/create` | Checkout started | + +## When to Use + +- E-commerce store management +- Product catalog operations +- Order processing +- Customer data management +- Inventory tracking + +## Rate Limits + +- REST: 2 requests/second +- GraphQL: 50 points/second +- Bulk operations available + +## Relevant Skills + +- analytics-tracking +- email-sequence +- referral-program diff --git a/tools/integrations/stripe.md b/tools/integrations/stripe.md new file mode 100644 index 0000000..cd5ab16 --- /dev/null +++ b/tools/integrations/stripe.md @@ -0,0 +1,148 @@ +# Stripe + +Payment processing, subscriptions, and billing for internet businesses. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Comprehensive REST API | +| MCP | ✓ | Available via Stripe MCP server | +| CLI | ✓ | `stripe` CLI for testing and webhooks | +| SDK | ✓ | Official SDKs for most languages | + +## Authentication + +- **Type**: API Key +- **Header**: `Authorization: Bearer sk_live_xxx` or `sk_test_xxx` +- **Keys**: Secret key (server), Publishable key (client) + +## Common Agent Operations + +### List customers + +```bash +GET https://api.stripe.com/v1/customers?limit=10 +``` + +### Get customer by email + +```bash +GET https://api.stripe.com/v1/customers?email=user@example.com +``` + +### Get subscription + +```bash +GET https://api.stripe.com/v1/subscriptions/{subscription_id} +``` + +### List subscriptions for customer + +```bash +GET https://api.stripe.com/v1/subscriptions?customer={customer_id} +``` + +### Create checkout session + +```bash +POST https://api.stripe.com/v1/checkout/sessions + +customer={customer_id} +&line_items[0][price]={price_id} +&line_items[0][quantity]=1 +&mode=subscription +&success_url=https://example.com/success +&cancel_url=https://example.com/cancel +``` + +### Create customer portal session + +```bash +POST https://api.stripe.com/v1/billing_portal/sessions + +customer={customer_id} +&return_url=https://example.com/account +``` + +### List recent invoices + +```bash +GET https://api.stripe.com/v1/invoices?customer={customer_id}&limit=10 +``` + +### Get payment intent + +```bash +GET https://api.stripe.com/v1/payment_intents/{payment_intent_id} +``` + +## Webhook Events + +Key events to handle: + +| Event | When | Action | +|-------|------|--------| +| `checkout.session.completed` | Successful checkout | Provision access | +| `customer.subscription.created` | New subscription | Update user record | +| `customer.subscription.updated` | Plan change | Update entitlements | +| `customer.subscription.deleted` | Cancellation | Revoke access | +| `invoice.payment_failed` | Payment failed | Notify user, retry | +| `invoice.paid` | Invoice paid | Confirm payment | + +### Verify webhook signature + +```javascript +const event = stripe.webhooks.constructEvent( + payload, + sig, + webhookSecret +); +``` + +## CLI Commands + +```bash +# Listen to webhooks locally +stripe listen --forward-to localhost:3000/webhooks + +# Trigger test events +stripe trigger checkout.session.completed + +# List recent events +stripe events list --limit 10 + +# Get resource +stripe customers retrieve cus_xxx +``` + +## Key Objects + +- **Customer** - User billing profile +- **Subscription** - Recurring billing +- **Price** - Pricing configuration +- **Product** - What you sell +- **Invoice** - Billing document +- **PaymentIntent** - One-time payment +- **Checkout Session** - Hosted payment page + +## When to Use + +- Processing payments +- Managing subscriptions +- Creating checkout flows +- Handling billing portal +- Querying customer data +- Revenue analytics + +## Rate Limits + +- 100 read requests per second +- 100 write requests per second +- Higher limits available on request + +## Relevant Skills + +- pricing-strategy +- referral-program (Stripe-integrated affiliate tools) +- analytics-tracking (revenue tracking) diff --git a/tools/integrations/tiktok-ads.md b/tools/integrations/tiktok-ads.md new file mode 100644 index 0000000..f400a43 --- /dev/null +++ b/tools/integrations/tiktok-ads.md @@ -0,0 +1,161 @@ +# TikTok Ads + +Advertising platform for TikTok's short-form video audience. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Marketing API for campaigns, audiences, reporting | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | Python SDK available | + +## Authentication + +- **Type**: Access Token +- **Header**: `Access-Token: {access_token}` +- **Setup**: Create app in TikTok for Business, get access token + +## Common Agent Operations + +### Get advertiser info + +```bash +GET https://business-api.tiktok.com/open_api/v1.3/advertiser/info/?advertiser_ids=["{advertiser_id}"] + +Access-Token: {access_token} +``` + +### Get campaigns + +```bash +GET https://business-api.tiktok.com/open_api/v1.3/campaign/get/?advertiser_id={advertiser_id}&page=1&page_size=20 + +Access-Token: {access_token} +``` + +### Get campaign report + +```bash +POST https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/ + +Access-Token: {access_token} + +{ + "advertiser_id": "{advertiser_id}", + "report_type": "BASIC", + "dimensions": ["campaign_id"], + "metrics": ["spend", "impressions", "clicks", "conversion"], + "data_level": "AUCTION_CAMPAIGN", + "start_date": "2024-01-01", + "end_date": "2024-01-31" +} +``` + +### Create campaign + +```bash +POST https://business-api.tiktok.com/open_api/v1.3/campaign/create/ + +Access-Token: {access_token} + +{ + "advertiser_id": "{advertiser_id}", + "campaign_name": "Campaign Name", + "objective_type": "CONVERSIONS", + "budget_mode": "BUDGET_MODE_DAY", + "budget": 100 +} +``` + +### Update campaign status + +```bash +POST https://business-api.tiktok.com/open_api/v1.3/campaign/status/update/ + +Access-Token: {access_token} + +{ + "advertiser_id": "{advertiser_id}", + "campaign_ids": ["{campaign_id}"], + "opt_status": "ENABLE" +} +``` + +### Get ad groups + +```bash +GET https://business-api.tiktok.com/open_api/v1.3/adgroup/get/?advertiser_id={advertiser_id}&campaign_ids=["{campaign_id}"] + +Access-Token: {access_token} +``` + +### Get audiences + +```bash +GET https://business-api.tiktok.com/open_api/v1.3/dmp/custom_audience/list/?advertiser_id={advertiser_id} + +Access-Token: {access_token} +``` + +## Key Metrics + +| Metric | Description | +|--------|-------------| +| `spend` | Amount spent | +| `impressions` | Ad impressions | +| `clicks` | Clicks | +| `ctr` | Click-through rate | +| `cpc` | Cost per click | +| `cpm` | Cost per 1000 impressions | +| `conversion` | Conversions | +| `cost_per_conversion` | CPA | +| `video_play_actions` | Video views | +| `video_watched_6s` | 6s views | + +## Campaign Objectives + +- `REACH` - Brand awareness +- `TRAFFIC` - Website traffic +- `VIDEO_VIEWS` - Video views +- `LEAD_GENERATION` - Lead forms +- `CONVERSIONS` - Website conversions +- `APP_PROMOTION` - App installs + +## Targeting Options + +### Demographics +- Age ranges +- Gender +- Languages +- Locations + +### Interests & Behavior +- Interest categories +- Video interactions +- Creator interactions +- Hashtag interactions + +### Custom Audiences +- Customer file uploads +- Website visitors (pixel) +- App activity +- Engagement audiences + +## When to Use + +- Reaching younger demographics (18-34) +- Video-first advertising +- Viral/creative campaigns +- App promotion + +## Rate Limits + +- 10 requests/second +- 100,000 requests/day + +## Relevant Skills + +- paid-ads +- analytics-tracking diff --git a/tools/integrations/tolt.md b/tools/integrations/tolt.md new file mode 100644 index 0000000..057753e --- /dev/null +++ b/tools/integrations/tolt.md @@ -0,0 +1,144 @@ +# Tolt + +Affiliate program management for SaaS, with Stripe and Paddle integration. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for affiliates, referrals, payouts | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | - | JavaScript snippet for tracking | + +## Authentication + +- **Type**: API Key +- **Header**: `Authorization: Bearer {api_key}` +- **Get key**: Settings > API in Tolt dashboard + +## Common Agent Operations + +### List affiliates + +```bash +GET https://api.tolt.io/v1/affiliates +``` + +### Get affiliate + +```bash +GET https://api.tolt.io/v1/affiliates/{affiliate_id} +``` + +### Create affiliate + +```bash +POST https://api.tolt.io/v1/affiliates + +{ + "email": "affiliate@example.com", + "name": "John Doe" +} +``` + +### List referrals + +```bash +GET https://api.tolt.io/v1/referrals?affiliate_id={affiliate_id} +``` + +### Get referral by customer + +```bash +GET https://api.tolt.io/v1/referrals?customer_id={stripe_customer_id} +``` + +### List commissions + +```bash +GET https://api.tolt.io/v1/commissions?affiliate_id={affiliate_id} +``` + +### Get payout history + +```bash +GET https://api.tolt.io/v1/payouts?affiliate_id={affiliate_id} +``` + +### Update affiliate + +```bash +PATCH https://api.tolt.io/v1/affiliates/{affiliate_id} + +{ + "commission_rate": 30, + "payout_method": "paypal", + "paypal_email": "affiliate@paypal.com" +} +``` + +## JavaScript Tracking + +### Install snippet + +```html + +``` + +### Track signup + +```javascript +window.tolt.signup(stripeCustomerId); +``` + +### Identify existing customer + +```javascript +window.tolt.identify(stripeCustomerId); +``` + +## Webhook Events + +| Event | When | +|-------|------| +| `affiliate.created` | New affiliate registered | +| `affiliate.approved` | Affiliate approved | +| `referral.created` | New referral tracked | +| `referral.converted` | Referral converted to customer | +| `commission.created` | Commission earned | +| `payout.completed` | Payout sent | + +## Key Features + +- **Stripe native** - Automatic commission tracking +- **Paddle support** - Works with Paddle billing +- **Affiliate dashboard** - White-labeled portal +- **Payout automation** - PayPal and Wise payouts +- **Custom commission tiers** - Different rates per affiliate + +## Key Objects + +- **Affiliate** - Partner in your program +- **Referral** - Tracked conversion +- **Commission** - Earned affiliate payment +- **Payout** - Processed payment to affiliate +- **Program** - Campaign configuration + +## When to Use + +- Setting up SaaS affiliate programs +- Managing affiliate relationships +- Tracking Stripe or Paddle-based referrals +- Processing affiliate payouts +- Building affiliate dashboards + +## Rate Limits + +- 100 requests per minute +- Higher limits on enterprise plans + +## Relevant Skills + +- referral-program +- pricing-strategy diff --git a/tools/integrations/webflow.md b/tools/integrations/webflow.md new file mode 100644 index 0000000..3b7e745 --- /dev/null +++ b/tools/integrations/webflow.md @@ -0,0 +1,198 @@ +# Webflow + +Visual web design and CMS platform for marketing sites. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for sites, CMS, forms | +| MCP | - | Not available | +| CLI | ✓ | Webflow CLI for devlink and apps | +| SDK | ✓ | Official SDK for Node.js | + +## Authentication + +- **Type**: API Token (Site token or OAuth) +- **Header**: `Authorization: Bearer {api_token}` +- **Get token**: Site Settings > Integrations > API Access + +## Common Agent Operations + +### List sites + +```bash +GET https://api.webflow.com/v2/sites + +Authorization: Bearer {api_token} +``` + +### Get site + +```bash +GET https://api.webflow.com/v2/sites/{site_id} + +Authorization: Bearer {api_token} +``` + +### List collections + +```bash +GET https://api.webflow.com/v2/sites/{site_id}/collections + +Authorization: Bearer {api_token} +``` + +### List collection items + +```bash +GET https://api.webflow.com/v2/collections/{collection_id}/items + +Authorization: Bearer {api_token} +``` + +### Get collection item + +```bash +GET https://api.webflow.com/v2/collections/{collection_id}/items/{item_id} + +Authorization: Bearer {api_token} +``` + +### Create collection item + +```bash +POST https://api.webflow.com/v2/collections/{collection_id}/items + +Authorization: Bearer {api_token} + +{ + "fieldData": { + "name": "Item Name", + "slug": "item-name", + "custom-field": "value" + } +} +``` + +### Update collection item + +```bash +PATCH https://api.webflow.com/v2/collections/{collection_id}/items/{item_id} + +Authorization: Bearer {api_token} + +{ + "fieldData": { + "custom-field": "new value" + } +} +``` + +### Publish collection items + +```bash +POST https://api.webflow.com/v2/collections/{collection_id}/items/publish + +Authorization: Bearer {api_token} + +{ + "itemIds": ["item_id_1", "item_id_2"] +} +``` + +### List form submissions + +```bash +GET https://api.webflow.com/v2/sites/{site_id}/forms/{form_id}/submissions + +Authorization: Bearer {api_token} +``` + +### Publish site + +```bash +POST https://api.webflow.com/v2/sites/{site_id}/publish + +Authorization: Bearer {api_token} + +{ + "publishToWebflowSubdomain": true, + "publishToCustomDomains": true +} +``` + +## Node.js SDK + +```javascript +const Webflow = require('webflow-api'); + +const webflow = new Webflow({ token: 'api_token' }); + +// List sites +const sites = await webflow.sites.list(); + +// Get collection items +const items = await webflow.collections.items.listItems(collectionId); + +// Create item +const item = await webflow.collections.items.createItem(collectionId, { + fieldData: { + name: 'New Item', + slug: 'new-item' + } +}); +``` + +## CLI Commands + +```bash +# Install +npm install -g @webflow/webflow-cli + +# Login +webflow login + +# Initialize devlink +webflow devlink init + +# Sync components +webflow devlink sync +``` + +## CMS Structure + +- **Collections** - Content types (like blog posts, team members) +- **Items** - Individual entries in a collection +- **Fields** - Data fields on items + +## Common Field Types + +- `PlainText` - Simple text +- `RichText` - Formatted content +- `Image` - Image upload +- `Link` - URL or page reference +- `Reference` - Link to another collection +- `Multi-Reference` - Multiple collection links +- `Switch` - Boolean toggle +- `Number` - Numeric value +- `Date` - Date/time + +## When to Use + +- Marketing site CMS management +- Blog/content publishing +- Form submission handling +- Automated content updates +- Programmatic SEO pages + +## Rate Limits + +- 60 requests/minute (general) +- 10 requests/minute (publishing) + +## Relevant Skills + +- programmatic-seo +- content-strategy +- page-cro diff --git a/tools/integrations/wordpress.md b/tools/integrations/wordpress.md new file mode 100644 index 0000000..6c3d4b5 --- /dev/null +++ b/tools/integrations/wordpress.md @@ -0,0 +1,175 @@ +# WordPress + +Content management system for blogs and websites. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API (WP REST API) | +| MCP | - | Not available | +| CLI | ✓ | WP-CLI for server-side management | +| SDK | ✓ | Various client libraries | + +## Authentication + +- **Type**: Application Password, JWT, or OAuth +- **Header**: `Authorization: Basic {base64(username:app_password)}` +- **Setup**: Users > Your Profile > Application Passwords + +## Common Agent Operations + +### List posts + +```bash +GET https://example.com/wp-json/wp/v2/posts?per_page=10 + +Authorization: Basic {base64(username:app_password)} +``` + +### Get post + +```bash +GET https://example.com/wp-json/wp/v2/posts/{post_id} + +Authorization: Basic {base64(username:app_password)} +``` + +### Create post + +```bash +POST https://example.com/wp-json/wp/v2/posts + +Authorization: Basic {base64(username:app_password)} + +{ + "title": "Post Title", + "content": "Post content here
", + "status": "draft", + "categories": [1], + "tags": [5, 6] +} +``` + +### Update post + +```bash +PUT https://example.com/wp-json/wp/v2/posts/{post_id} + +Authorization: Basic {base64(username:app_password)} + +{ + "title": "Updated Title", + "status": "publish" +} +``` + +### List pages + +```bash +GET https://example.com/wp-json/wp/v2/pages?per_page=20 + +Authorization: Basic {base64(username:app_password)} +``` + +### List categories + +```bash +GET https://example.com/wp-json/wp/v2/categories +``` + +### Create category + +```bash +POST https://example.com/wp-json/wp/v2/categories + +{ + "name": "Category Name", + "slug": "category-name" +} +``` + +### Upload media + +```bash +POST https://example.com/wp-json/wp/v2/media + +Authorization: Basic {base64(username:app_password)} +Content-Disposition: attachment; filename="image.jpg" +Content-Type: image/jpeg + +[binary image data] +``` + +### List users + +```bash +GET https://example.com/wp-json/wp/v2/users + +Authorization: Basic {base64(username:app_password)} +``` + +## WP-CLI Commands + +```bash +# List posts +wp post list --post_type=post --post_status=publish + +# Create post +wp post create --post_title="Title" --post_content="Content" --post_status=publish + +# Update post +wp post update 123 --post_title="New Title" + +# Export database +wp db export backup.sql + +# Search/replace in database +wp search-replace 'old-domain.com' 'new-domain.com' + +# Install plugin +wp plugin install yoast-seo --activate + +# Update plugins +wp plugin update --all +``` + +## Post Statuses + +- `publish` - Live on site +- `draft` - Not published +- `pending` - Awaiting review +- `private` - Private post +- `future` - Scheduled +- `trash` - In trash + +## Common Endpoints + +| Endpoint | Resource | +|----------|----------| +| `/wp/v2/posts` | Blog posts | +| `/wp/v2/pages` | Pages | +| `/wp/v2/media` | Images/files | +| `/wp/v2/categories` | Categories | +| `/wp/v2/tags` | Tags | +| `/wp/v2/users` | Users | +| `/wp/v2/comments` | Comments | + +## When to Use + +- Blog content management +- Page updates +- Media management +- Site configuration +- Plugin/theme management + +## Rate Limits + +- No default limits +- Server/host dependent + +## Relevant Skills + +- content-strategy +- seo-audit +- programmatic-seo diff --git a/tools/integrations/zapier.md b/tools/integrations/zapier.md new file mode 100644 index 0000000..d83de56 --- /dev/null +++ b/tools/integrations/zapier.md @@ -0,0 +1,150 @@ +# Zapier + +Workflow automation platform connecting apps without code. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for Zaps, tasks, and webhooks | +| MCP | ✓ | Available via Zapier MCP server | +| CLI | - | Not available | +| SDK | - | API and webhooks only | + +## Authentication + +- **Type**: API Key +- **Header**: `X-API-Key: {api_key}` +- **Get key**: Settings > API in Zapier account + +## Common Agent Operations + +### List Zaps + +```bash +GET https://api.zapier.com/v1/zaps +``` + +### Get Zap details + +```bash +GET https://api.zapier.com/v1/zaps/{zap_id} +``` + +### Turn Zap on/off + +```bash +POST https://api.zapier.com/v1/zaps/{zap_id}/on +POST https://api.zapier.com/v1/zaps/{zap_id}/off +``` + +### Get task history + +```bash +GET https://api.zapier.com/v1/zaps/{zap_id}/tasks +``` + +### Get profile info + +```bash +GET https://api.zapier.com/v1/profiles/me +``` + +## Webhooks (Triggers) + +### Catch Hook (receive data) + +Create a "Webhooks by Zapier" trigger to receive data: + +```bash +POST https://hooks.zapier.com/hooks/catch/{webhook_id}/ + +{ + "event": "user.created", + "user_id": "123", + "email": "user@example.com" +} +``` + +### Send data to Zapier + +Most common: trigger a Zap from your app: + +```bash +POST https://hooks.zapier.com/hooks/catch/{account_id}/{hook_id}/ + +{ + "name": "John Doe", + "email": "john@example.com", + "plan": "pro" +} +``` + +## Common Marketing Automations + +### Lead capture to CRM +``` +Typeform → Zapier → HubSpot +``` + +### New customer notifications +``` +Stripe (new customer) → Zapier → Slack +``` + +### Email sequence triggers +``` +Form submission → Zapier → Customer.io +``` + +### Social proof automation +``` +New review → Zapier → Twitter/Slack +``` + +### Referral tracking +``` +New referral → Zapier → Spreadsheet + Slack +``` + +## Webhook Payload Structure + +When sending to Zapier, structure data as flat JSON: + +```json +{ + "customer_name": "John Doe", + "customer_email": "john@example.com", + "plan_name": "Pro", + "plan_price": 99, + "signup_date": "2024-01-15" +} +``` + +## Key Concepts + +- **Zap** - Automated workflow +- **Trigger** - Event that starts a Zap +- **Action** - Task performed by Zap +- **Task** - Single action execution +- **Filter** - Conditional logic +- **Path** - Branching logic + +## When to Use + +- Connecting marketing tools without code +- Automating lead routing +- Syncing data between platforms +- Triggering notifications +- Building marketing workflows + +## Rate Limits + +- 100 requests per minute +- Task limits by plan tier + +## Relevant Skills + +- email-sequence +- analytics-tracking +- referral-program