diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..28fd24c --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +# Remotion video project +video/ 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/skills/referral-program/references/affiliate-programs.md b/skills/referral-program/references/affiliate-programs.md index ac0d59b..2467be5 100644 --- a/skills/referral-program/references/affiliate-programs.md +++ b/skills/referral-program/references/affiliate-programs.md @@ -93,6 +93,7 @@ Provide affiliates with: - Ambassador — Enterprise referral programs - Friendbuy — E-commerce and subscription - GrowSurf — SaaS and tech companies +- Mention Me — AI-powered referral marketing - Viral Loops — Template-based campaigns **Built-in options:** 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 + + + + user_123 + event1 + campaign_name + page_type + +``` + +## AppMeasurement.js + +```javascript +// Initialize +var s = s_gi('report_suite_id'); +s.trackingServer = 'metrics.example.com'; + +// Set variables +s.pageName = 'Home Page'; +s.channel = 'Marketing'; +s.eVar1 = 'campaign_name'; +s.events = 'event1'; + +// Track page view +s.t(); + +// Track link +s.tl(this, 'o', 'Button Click'); +``` + +## Key Concepts + +- **Report Suite** - Data container +- **eVars** - Conversion variables (persistent) +- **props** - Traffic variables (hit-level) +- **Events** - Success metrics +- **Segments** - User/visit filters +- **Calculated Metrics** - Derived metrics + +## Common Dimensions + +- `variables/page` - Page name +- `variables/evar1` - Custom conversion variable +- `variables/prop1` - Custom traffic variable +- `variables/marketingchannel` - Marketing channel +- `variables/referringdomain` - Referring domain + +## Common Metrics + +- `metrics/visits` - Visits +- `metrics/pageviews` - Page views +- `metrics/uniquevisitors` - Unique visitors +- `metrics/orders` - Orders +- `metrics/revenue` - Revenue + +## When to Use + +- Enterprise-scale analytics +- Cross-channel attribution +- Integration with Adobe Experience Cloud +- Advanced segmentation +- Data warehouse exports + +## Rate Limits + +- 12 requests/second per company +- 120 requests/minute + +## Relevant Skills + +- analytics-tracking +- ab-test-setup +- paid-ads diff --git a/tools/integrations/ahrefs.md b/tools/integrations/ahrefs.md new file mode 100644 index 0000000..c03d050 --- /dev/null +++ b/tools/integrations/ahrefs.md @@ -0,0 +1,142 @@ +# Ahrefs + +SEO toolset for backlink analysis, keyword research, and competitive research. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for Site Explorer, Keywords Explorer | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | - | API-only | + +## Authentication + +- **Type**: API Token +- **Header**: `Authorization: Bearer {api_token}` +- **Get token**: Account Settings > API in Ahrefs dashboard + +## Common Agent Operations + +### Domain rating + +```bash +GET https://api.ahrefs.com/v3/site-explorer/domain-rating?target=example.com + +Authorization: Bearer {api_token} +``` + +### Backlinks overview + +```bash +GET https://api.ahrefs.com/v3/site-explorer/backlinks-stats?target=example.com&mode=domain + +Authorization: Bearer {api_token} +``` + +### Referring domains + +```bash +GET https://api.ahrefs.com/v3/site-explorer/refdomains?target=example.com&mode=domain&limit=100 + +Authorization: Bearer {api_token} +``` + +### Backlinks list + +```bash +GET https://api.ahrefs.com/v3/site-explorer/backlinks?target=example.com&mode=domain&limit=100 + +Authorization: Bearer {api_token} +``` + +### Organic keywords + +```bash +GET https://api.ahrefs.com/v3/site-explorer/organic-keywords?target=example.com&mode=domain&country=us&limit=100 + +Authorization: Bearer {api_token} +``` + +### Top pages + +```bash +GET https://api.ahrefs.com/v3/site-explorer/top-pages?target=example.com&mode=domain&country=us&limit=50 + +Authorization: Bearer {api_token} +``` + +### Keyword overview + +```bash +GET https://api.ahrefs.com/v3/keywords-explorer/overview?keywords=keyword1,keyword2&country=us + +Authorization: Bearer {api_token} +``` + +### Keyword suggestions + +```bash +GET https://api.ahrefs.com/v3/keywords-explorer/matching-terms?keyword=seed+keyword&country=us&limit=100 + +Authorization: Bearer {api_token} +``` + +### SERP overview + +```bash +GET https://api.ahrefs.com/v3/keywords-explorer/serp-overview?keyword=target+keyword&country=us + +Authorization: Bearer {api_token} +``` + +## Key Metrics + +### Domain Metrics +- `domain_rating` - Domain Rating (DR) +- `ahrefs_rank` - Ahrefs Rank +- `referring_domains` - Referring domains count +- `backlinks` - Total backlinks +- `organic_traffic` - Estimated organic traffic + +### Keyword Metrics +- `volume` - Monthly search volume +- `keyword_difficulty` - KD score (0-100) +- `cpc` - Cost per click +- `clicks` - Estimated monthly clicks +- `global_volume` - Global search volume + +### Backlink Fields +- `url_from` - Source URL +- `url_to` - Target URL +- `anchor` - Anchor text +- `domain_rating_source` - Source DR +- `first_seen` - First discovery date + +## Modes + +- `domain` - Entire domain +- `subdomains` - Domain + subdomains +- `prefix` - URL prefix +- `exact` - Exact URL + +## When to Use + +- Backlink analysis +- Link building research +- Keyword research +- Competitive analysis +- Content gap analysis +- Site audits + +## Rate Limits + +- Varies by plan +- 500-5000 rows per request + +## Relevant Skills + +- seo-audit +- content-strategy +- competitor-alternatives diff --git a/tools/integrations/amplitude.md b/tools/integrations/amplitude.md new file mode 100644 index 0000000..e7b7904 --- /dev/null +++ b/tools/integrations/amplitude.md @@ -0,0 +1,135 @@ +# Amplitude + +Product analytics platform for user behavior, retention, and experimentation. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | HTTP API for events, User Profile API, Export API | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | JavaScript, iOS, Android, Python, etc. | + +## Authentication + +- **HTTP API**: API Key (public for events) +- **Export/Dashboard API**: API Key + Secret Key + +## Common Agent Operations + +### Track event + +```bash +POST https://api2.amplitude.com/2/httpapi + +{ + "api_key": "{api_key}", + "events": [{ + "user_id": "user_123", + "event_type": "signup_completed", + "event_properties": { + "plan": "pro" + }, + "user_properties": { + "email": "user@example.com" + } + }] +} +``` + +### Batch events + +```bash +POST https://api2.amplitude.com/batch + +{ + "api_key": "{api_key}", + "events": [ + {"user_id": "user_1", "event_type": "pageview"}, + {"user_id": "user_2", "event_type": "signup"} + ] +} +``` + +### Get user activity + +```bash +GET https://amplitude.com/api/2/useractivity?user={user_id} + +Authorization: Basic {base64(api_key:secret_key)} +``` + +### Export events + +```bash +GET https://amplitude.com/api/2/export?start=20240101T00&end=20240131T23 + +Authorization: Basic {base64(api_key:secret_key)} +``` + +### Get retention data + +```bash +GET https://amplitude.com/api/2/retention?e={"event_type":"signup_completed"}&start=20240101&end=20240131 + +Authorization: Basic {base64(api_key:secret_key)} +``` + +### Query with SQL (Snowflake) + +For Amplitude customers with SQL access: +```sql +SELECT event_type, COUNT(*) as count +FROM events +WHERE event_time > '2024-01-01' +GROUP BY event_type +``` + +## JavaScript SDK + +```javascript +// Initialize +amplitude.init('API_KEY'); + +// Identify user +amplitude.setUserId('user_123'); + +// Set user properties +const identify = new amplitude.Identify(); +identify.set('plan', 'pro'); +amplitude.identify(identify); + +// Track event +amplitude.track('Feature Used', { + feature_name: 'export' +}); +``` + +## Key Concepts + +- **Events** - User actions with properties +- **User Properties** - Persistent user attributes +- **Cohorts** - Behavioral segments +- **Funnels** - Multi-step conversion analysis +- **Retention** - User return patterns +- **Journeys** - User path analysis + +## When to Use + +- Tracking product analytics +- Analyzing user funnels +- Cohort analysis and retention +- Experimentation and A/B testing +- User journey mapping + +## Rate Limits + +- HTTP API: 1000 events/second +- Export API: 360 requests/hour + +## Relevant Skills + +- analytics-tracking +- ab-test-setup +- onboarding-cro diff --git a/tools/integrations/customer-io.md b/tools/integrations/customer-io.md new file mode 100644 index 0000000..2d5f5ab --- /dev/null +++ b/tools/integrations/customer-io.md @@ -0,0 +1,187 @@ +# Customer.io + +Behavior-based messaging platform for email, push, SMS, and in-app. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Track API, App API, Journeys API | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | JavaScript, iOS, Android, Ruby, Python | + +## Authentication + +- **Track API**: Site ID + API Key (Basic auth) +- **App API**: Bearer token +- **Header**: `Authorization: Basic {base64(site_id:api_key)}` + +## Common Agent Operations + +### Identify customer + +```bash +PUT https://track.customer.io/api/v1/customers/{customer_id} + +Authorization: Basic {base64(site_id:api_key)} + +{ + "email": "user@example.com", + "created_at": 1705312800, + "first_name": "John", + "plan": "pro" +} +``` + +### Track event + +```bash +POST https://track.customer.io/api/v1/customers/{customer_id}/events + +Authorization: Basic {base64(site_id:api_key)} + +{ + "name": "purchase", + "data": { + "product": "Pro Plan", + "amount": 99 + } +} +``` + +### Track anonymous event + +```bash +POST https://track.customer.io/api/v1/events + +Authorization: Basic {base64(site_id:api_key)} + +{ + "name": "page_viewed", + "data": { + "page": "/pricing" + }, + "anonymous_id": "anon_123" +} +``` + +### Delete customer + +```bash +DELETE https://track.customer.io/api/v1/customers/{customer_id} + +Authorization: Basic {base64(site_id:api_key)} +``` + +### Get customer (App API) + +```bash +GET https://api.customer.io/v1/customers/{customer_id}/attributes + +Authorization: Bearer {app_api_key} +``` + +### List campaigns + +```bash +GET https://api.customer.io/v1/campaigns + +Authorization: Bearer {app_api_key} +``` + +### Get campaign metrics + +```bash +GET https://api.customer.io/v1/campaigns/{campaign_id}/metrics + +Authorization: Bearer {app_api_key} +``` + +### Trigger broadcast + +```bash +POST https://api.customer.io/v1/campaigns/{campaign_id}/triggers + +Authorization: Bearer {app_api_key} + +{ + "emails": ["user@example.com"], + "data": { + "coupon_code": "SAVE20" + } +} +``` + +### Send transactional email + +```bash +POST https://api.customer.io/v1/send/email + +Authorization: Bearer {app_api_key} + +{ + "transactional_message_id": "1", + "to": "user@example.com", + "identifiers": { + "id": "user_123" + }, + "message_data": { + "order_id": "ORD-456" + } +} +``` + +## JavaScript SDK + +```javascript +// Initialize +_cio.identify({ + id: 'user_123', + email: 'user@example.com', + created_at: 1705312800, + plan: 'pro' +}); + +// Track event +_cio.track('purchase', { + product: 'Pro Plan', + amount: 99 +}); + +// Track page view +_cio.page(); +``` + +## Key Concepts + +- **People** - Customers and leads +- **Segments** - Dynamic groups based on attributes/behavior +- **Campaigns** - Automated message sequences +- **Broadcasts** - One-time sends +- **Transactional** - Triggered messages + +## Attribute Types + +- Standard: `email`, `created_at`, `unsubscribed` +- Custom: Any key you define +- Computed: Aggregations from events + +## When to Use + +- Behavior-based email automation +- Multi-channel messaging (email, push, SMS) +- Onboarding sequences +- Re-engagement campaigns +- Transactional messages + +## Rate Limits + +- Track API: 100 requests/second +- App API: 10 requests/second + +## Relevant Skills + +- email-sequence +- onboarding-cro +- analytics-tracking diff --git a/tools/integrations/dub-co.md b/tools/integrations/dub-co.md new file mode 100644 index 0000000..e3d49a4 --- /dev/null +++ b/tools/integrations/dub-co.md @@ -0,0 +1,160 @@ +# Dub.co + +Link management and attribution platform for modern marketing teams. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for links, analytics, domains | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | TypeScript SDK available | + +## Authentication + +- **Type**: API Key +- **Header**: `Authorization: Bearer {api_key}` +- **Get key**: Settings > API Keys in Dub dashboard + +## Common Agent Operations + +### Create short link + +```bash +POST https://api.dub.co/links + +{ + "url": "https://example.com/landing-page", + "domain": "link.example.com", + "key": "summer-sale", + "tags": ["campaign:summer", "channel:email"] +} +``` + +### Get link by key + +```bash +GET https://api.dub.co/links?domain=link.example.com&key=summer-sale +``` + +### List links + +```bash +GET https://api.dub.co/links?domain=link.example.com&page=1 +``` + +### Get link analytics + +```bash +GET https://api.dub.co/analytics?domain=link.example.com&key=summer-sale&interval=30d +``` + +### Get clicks by location + +```bash +GET https://api.dub.co/analytics/country?domain=link.example.com&key=summer-sale +``` + +### Get clicks by device + +```bash +GET https://api.dub.co/analytics/device?domain=link.example.com&key=summer-sale +``` + +### Update link + +```bash +PATCH https://api.dub.co/links/{link_id} + +{ + "url": "https://example.com/new-landing-page", + "tags": ["campaign:summer", "channel:social"] +} +``` + +### Delete link + +```bash +DELETE https://api.dub.co/links/{link_id} +``` + +### Bulk create links + +```bash +POST https://api.dub.co/links/bulk + +[ + {"url": "https://example.com/page1", "key": "page1"}, + {"url": "https://example.com/page2", "key": "page2"} +] +``` + +## TypeScript SDK + +### Install + +```bash +npm install dub +``` + +### Usage + +```typescript +import { Dub } from "dub"; + +const dub = new Dub({ token: "YOUR_API_KEY" }); + +// Create link +const link = await dub.links.create({ + url: "https://example.com", + domain: "link.example.com" +}); + +// Get analytics +const analytics = await dub.analytics.retrieve({ + domain: "link.example.com", + key: "summer-sale" +}); +``` + +## Key Features + +- **Custom domains** - Use your own branded domains +- **Link analytics** - Clicks, locations, devices, referrers +- **Tags** - Organize links by campaign, channel, etc. +- **QR codes** - Auto-generated for each link +- **Password protection** - Secure sensitive links +- **Expiration** - Time-limited links +- **Geo-targeting** - Redirect based on location + +## Analytics Dimensions + +- `clicks` - Total click count +- `country` - Clicks by country +- `city` - Clicks by city +- `device` - Clicks by device type +- `browser` - Clicks by browser +- `os` - Clicks by operating system +- `referer` - Clicks by referrer + +## When to Use + +- Creating trackable marketing links +- Building referral link systems +- Tracking campaign attribution +- A/B testing landing pages via links +- Generating branded short URLs +- Analyzing link performance + +## Rate Limits + +- Free: 1,000 links, 5 API requests/second +- Pro: Unlimited links, 50 API requests/second +- Enterprise: Custom limits + +## Relevant Skills + +- referral-program +- analytics-tracking +- paid-ads diff --git a/tools/integrations/ga4.md b/tools/integrations/ga4.md new file mode 100644 index 0000000..1cddfab --- /dev/null +++ b/tools/integrations/ga4.md @@ -0,0 +1,126 @@ +# Google Analytics 4 (GA4) + +Web analytics platform for tracking user behavior, conversions, and marketing performance. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Data API for reports, Admin API for configuration | +| MCP | ✓ | Available via Google Analytics MCP server | +| CLI | - | Use gcloud for some operations | +| SDK | ✓ | gtag.js, Google Analytics SDK for mobile | + +## Authentication + +- **Type**: OAuth 2.0 or Service Account +- **Scopes**: `https://www.googleapis.com/auth/analytics.readonly` (read), `https://www.googleapis.com/auth/analytics.edit` (write) +- **Setup**: Create credentials in Google Cloud Console + +## Common Agent Operations + +### Run a report (Data API) + +```bash +POST https://analyticsdata.googleapis.com/v1beta/properties/{property_id}:runReport + +{ + "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}], + "dimensions": [{"name": "sessionSource"}], + "metrics": [{"name": "sessions"}, {"name": "conversions"}] +} +``` + +### Get real-time data + +```bash +POST https://analyticsdata.googleapis.com/v1beta/properties/{property_id}:runRealtimeReport + +{ + "dimensions": [{"name": "country"}], + "metrics": [{"name": "activeUsers"}] +} +``` + +### List conversion events + +```bash +GET https://analyticsadmin.googleapis.com/v1beta/properties/{property_id}/conversionEvents +``` + +### Create a conversion event + +```bash +POST https://analyticsadmin.googleapis.com/v1beta/properties/{property_id}/conversionEvents + +{ + "eventName": "purchase" +} +``` + +## Client-Side Tracking + +### Send custom event (gtag.js) + +```javascript +gtag('event', 'signup_completed', { + 'method': 'email', + 'plan': 'free' +}); +``` + +### Send event via Measurement Protocol + +```bash +POST https://www.google-analytics.com/mp/collect?measurement_id={measurement_id}&api_secret={api_secret} + +{ + "client_id": "client_123", + "events": [{ + "name": "purchase", + "params": { + "value": 99.99, + "currency": "USD" + } + }] +} +``` + +## Key Dimensions & Metrics + +### Common Dimensions +- `sessionSource` - Traffic source +- `sessionMedium` - Traffic medium +- `sessionCampaignName` - Campaign name +- `landingPage` - Entry page +- `deviceCategory` - Device type +- `country` - User country + +### Common Metrics +- `sessions` - Total sessions +- `activeUsers` - Active users +- `newUsers` - New users +- `conversions` - Conversion events +- `engagementRate` - Engaged sessions rate +- `averageSessionDuration` - Session duration + +## When to Use + +- Tracking website traffic and user behavior +- Measuring marketing campaign performance +- Setting up conversion tracking +- Analyzing user journeys and funnels +- Attribution modeling + +## Rate Limits + +- Data API: 10 requests per second per property +- Admin API: Varies by endpoint +- Measurement Protocol: 1M hits/day for free tier + +## Relevant Skills + +- analytics-tracking +- ab-test-setup +- seo-audit +- page-cro diff --git a/tools/integrations/google-ads.md b/tools/integrations/google-ads.md new file mode 100644 index 0000000..312d4b9 --- /dev/null +++ b/tools/integrations/google-ads.md @@ -0,0 +1,159 @@ +# Google Ads + +Pay-per-click advertising platform for search, display, and video campaigns. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Google Ads API for campaign management | +| MCP | ✓ | Available via Google Ads MCP server | +| CLI | - | Use gcloud or API scripts | +| SDK | ✓ | Client libraries for multiple languages | + +## Authentication + +- **Type**: OAuth 2.0 +- **Scopes**: `https://www.googleapis.com/auth/adwords` +- **Setup**: Create credentials in Google Cloud Console, link to Google Ads account +- **Headers**: `developer-token`, `login-customer-id` (for MCC) + +## Common Agent Operations + +### Get account info + +```bash +POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream + +{ + "query": "SELECT customer.id, customer.descriptive_name FROM customer" +} +``` + +### List campaigns + +```bash +POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream + +{ + "query": "SELECT campaign.id, campaign.name, campaign.status, campaign_budget.amount_micros FROM campaign ORDER BY campaign.id" +} +``` + +### Get campaign performance + +```bash +POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream + +{ + "query": "SELECT campaign.name, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS" +} +``` + +### Get ad group performance + +```bash +POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream + +{ + "query": "SELECT ad_group.name, metrics.impressions, metrics.clicks, metrics.conversions FROM ad_group WHERE segments.date DURING LAST_7_DAYS" +} +``` + +### Get keyword performance + +```bash +POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream + +{ + "query": "SELECT ad_group_criterion.keyword.text, metrics.impressions, metrics.clicks, metrics.average_cpc FROM keyword_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.clicks DESC LIMIT 50" +} +``` + +### Pause campaign + +```bash +POST https://googleads.googleapis.com/v14/customers/{customer_id}/campaigns:mutate + +{ + "operations": [{ + "update": { + "resourceName": "customers/{customer_id}/campaigns/{campaign_id}", + "status": "PAUSED" + }, + "updateMask": "status" + }] +} +``` + +### Update budget + +```bash +POST https://googleads.googleapis.com/v14/customers/{customer_id}/campaignBudgets:mutate + +{ + "operations": [{ + "update": { + "resourceName": "customers/{customer_id}/campaignBudgets/{budget_id}", + "amountMicros": "50000000" + }, + "updateMask": "amountMicros" + }] +} +``` + +## Key Metrics + +| Metric | Description | +|--------|-------------| +| `metrics.impressions` | Ad impressions | +| `metrics.clicks` | Clicks | +| `metrics.cost_micros` | Cost in micros (divide by 1M) | +| `metrics.conversions` | Conversions | +| `metrics.conversions_value` | Conversion value | +| `metrics.average_cpc` | Average cost per click | +| `metrics.ctr` | Click-through rate | +| `metrics.conversion_rate` | Conversion rate | + +## Campaign Types + +- `SEARCH` - Search network text ads +- `DISPLAY` - Display network +- `SHOPPING` - Product shopping ads +- `VIDEO` - YouTube video ads +- `PERFORMANCE_MAX` - AI-optimized across channels +- `DEMAND_GEN` - Discovery/Demand Gen + +## GAQL (Google Ads Query Language) + +```sql +SELECT + campaign.name, + metrics.clicks, + metrics.conversions +FROM campaign +WHERE + campaign.status = 'ENABLED' + AND segments.date DURING LAST_30_DAYS +ORDER BY metrics.conversions DESC +LIMIT 10 +``` + +## When to Use + +- Managing search advertising campaigns +- Analyzing campaign performance +- Adjusting budgets and bids +- Keyword research and management +- Conversion tracking analysis + +## Rate Limits + +- 15,000 operations per day (basic) +- Higher limits with developer token levels + +## Relevant Skills + +- paid-ads +- analytics-tracking +- page-cro diff --git a/tools/integrations/google-search-console.md b/tools/integrations/google-search-console.md new file mode 100644 index 0000000..e7a03ac --- /dev/null +++ b/tools/integrations/google-search-console.md @@ -0,0 +1,147 @@ +# Google Search Console + +Free tool for monitoring website search performance and indexing. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Search Analytics API, URL Inspection API | +| MCP | - | Not available | +| CLI | - | Use gcloud or API scripts | +| SDK | ✓ | Google API client libraries | + +## Authentication + +- **Type**: OAuth 2.0 or Service Account +- **Scopes**: `https://www.googleapis.com/auth/webmasters.readonly` +- **Setup**: Create credentials in Google Cloud Console + +## Common Agent Operations + +### Get search analytics + +```bash +POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query + +{ + "startDate": "2024-01-01", + "endDate": "2024-01-31", + "dimensions": ["query"], + "rowLimit": 100 +} +``` + +### Get performance by page + +```bash +POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query + +{ + "startDate": "2024-01-01", + "endDate": "2024-01-31", + "dimensions": ["page"], + "rowLimit": 50 +} +``` + +### Get performance by country + +```bash +POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query + +{ + "startDate": "2024-01-01", + "endDate": "2024-01-31", + "dimensions": ["country", "query"], + "rowLimit": 100 +} +``` + +### Inspect URL + +```bash +POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect + +{ + "inspectionUrl": "https://example.com/page", + "siteUrl": "https://example.com/" +} +``` + +### List sitemaps + +```bash +GET https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/sitemaps + +Authorization: Bearer {access_token} +``` + +### Submit sitemap + +```bash +PUT https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/sitemaps/{sitemap_url} + +Authorization: Bearer {access_token} +``` + +### Request indexing + +```bash +POST https://indexing.googleapis.com/v3/urlNotifications:publish + +{ + "url": "https://example.com/new-page", + "type": "URL_UPDATED" +} +``` + +## Dimensions + +- `query` - Search query +- `page` - Page URL +- `country` - Country code +- `device` - Device type (MOBILE, DESKTOP, TABLET) +- `date` - Date +- `searchAppearance` - Search result type + +## Metrics + +- `clicks` - Clicks from search +- `impressions` - Search impressions +- `ctr` - Click-through rate +- `position` - Average position + +## Filters + +```json +{ + "dimensionFilterGroups": [{ + "filters": [{ + "dimension": "query", + "operator": "contains", + "expression": "keyword" + }] + }] +} +``` + +## When to Use + +- Analyzing search performance +- Finding keyword opportunities +- Monitoring indexing status +- Submitting new pages for indexing +- Identifying crawl issues +- Tracking position changes + +## Rate Limits + +- 200 queries per minute +- 1,200 requests per minute + +## Relevant Skills + +- seo-audit +- programmatic-seo +- analytics-tracking diff --git a/tools/integrations/hubspot.md b/tools/integrations/hubspot.md new file mode 100644 index 0000000..5ea3927 --- /dev/null +++ b/tools/integrations/hubspot.md @@ -0,0 +1,178 @@ +# HubSpot + +CRM platform for marketing, sales, and customer service. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for CRM, Marketing, Sales | +| MCP | - | Not available | +| CLI | ✓ | `hs` CLI for local development | +| SDK | ✓ | Official client libraries | + +## Authentication + +- **Type**: Private App Token or OAuth 2.0 +- **Header**: `Authorization: Bearer {access_token}` +- **Get token**: Settings > Integrations > Private Apps + +## Common Agent Operations + +### Get contacts + +```bash +GET https://api.hubapi.com/crm/v3/objects/contacts?limit=10 + +Authorization: Bearer {access_token} +``` + +### Search contacts + +```bash +POST https://api.hubapi.com/crm/v3/objects/contacts/search + +{ + "filterGroups": [{ + "filters": [{ + "propertyName": "email", + "operator": "EQ", + "value": "user@example.com" + }] + }] +} +``` + +### Create contact + +```bash +POST https://api.hubapi.com/crm/v3/objects/contacts + +{ + "properties": { + "email": "user@example.com", + "firstname": "John", + "lastname": "Doe", + "company": "Example Inc" + } +} +``` + +### Update contact + +```bash +PATCH https://api.hubapi.com/crm/v3/objects/contacts/{contact_id} + +{ + "properties": { + "lifecyclestage": "customer" + } +} +``` + +### Get deals + +```bash +GET https://api.hubapi.com/crm/v3/objects/deals?limit=10&properties=dealname,amount,dealstage + +Authorization: Bearer {access_token} +``` + +### Create deal + +```bash +POST https://api.hubapi.com/crm/v3/objects/deals + +{ + "properties": { + "dealname": "New Deal", + "amount": "10000", + "dealstage": "appointmentscheduled", + "pipeline": "default" + } +} +``` + +### Associate contact with deal + +```bash +PUT https://api.hubapi.com/crm/v3/objects/deals/{deal_id}/associations/contacts/{contact_id}/deal_to_contact +``` + +### Get form submissions + +```bash +GET https://api.hubapi.com/form-integrations/v1/submissions/forms/{form_guid} + +Authorization: Bearer {access_token} +``` + +### Get marketing emails + +```bash +GET https://api.hubapi.com/marketing/v3/emails?limit=10 + +Authorization: Bearer {access_token} +``` + +## CLI Commands + +```bash +# Install +npm install -g @hubspot/cli + +# Initialize project +hs init + +# Upload files +hs upload src dest + +# Watch for changes +hs watch src dest + +# List portals +hs accounts list +``` + +## Key Objects + +- **Contacts** - People in CRM +- **Companies** - Organizations +- **Deals** - Sales opportunities +- **Tickets** - Support tickets +- **Products** - Items for sale +- **Line Items** - Deal line items + +## Common Properties + +### Contact Properties +- `email` - Email address +- `firstname`, `lastname` - Name +- `lifecyclestage` - Funnel stage +- `hs_lead_status` - Lead status + +### Deal Properties +- `dealname` - Deal name +- `amount` - Deal value +- `dealstage` - Pipeline stage +- `closedate` - Expected close + +## When to Use + +- Managing contacts and leads +- Tracking sales deals +- Marketing automation +- Form submissions +- Email campaigns +- Customer service tickets + +## Rate Limits + +- 100 requests per 10 seconds +- Higher limits on enterprise plans + +## Relevant Skills + +- email-sequence +- analytics-tracking +- referral-program diff --git a/tools/integrations/kit.md b/tools/integrations/kit.md new file mode 100644 index 0000000..ce64bb0 --- /dev/null +++ b/tools/integrations/kit.md @@ -0,0 +1,167 @@ +# Kit (formerly ConvertKit) + +Email marketing platform for creators and newsletter businesses. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for subscribers, forms, sequences | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | JavaScript, Ruby gems available | + +## Authentication + +- **Type**: API Key or API Secret +- **Parameter**: `api_key={key}` or `api_secret={secret}` in query/body +- **Get key**: Settings > Advanced in Kit dashboard + +## Common Agent Operations + +### List subscribers + +```bash +GET https://api.convertkit.com/v3/subscribers?api_secret={api_secret}&page=1 + +``` + +### Get subscriber + +```bash +GET https://api.convertkit.com/v3/subscribers/{subscriber_id}?api_secret={api_secret} +``` + +### Add subscriber to form + +```bash +POST https://api.convertkit.com/v3/forms/{form_id}/subscribe + +{ + "api_key": "{api_key}", + "email": "user@example.com", + "first_name": "John", + "fields": { + "company": "Example Inc" + } +} +``` + +### Add subscriber to sequence + +```bash +POST https://api.convertkit.com/v3/sequences/{sequence_id}/subscribe + +{ + "api_key": "{api_key}", + "email": "user@example.com" +} +``` + +### Tag subscriber + +```bash +POST https://api.convertkit.com/v3/tags/{tag_id}/subscribe + +{ + "api_key": "{api_key}", + "email": "user@example.com" +} +``` + +### Remove tag from subscriber + +```bash +DELETE https://api.convertkit.com/v3/subscribers/{subscriber_id}/tags/{tag_id}?api_secret={api_secret} +``` + +### Update subscriber + +```bash +PUT https://api.convertkit.com/v3/subscribers/{subscriber_id} + +{ + "api_secret": "{api_secret}", + "first_name": "Jane", + "fields": { + "plan": "pro" + } +} +``` + +### Unsubscribe + +```bash +PUT https://api.convertkit.com/v3/unsubscribe + +{ + "api_secret": "{api_secret}", + "email": "user@example.com" +} +``` + +### List forms + +```bash +GET https://api.convertkit.com/v3/forms?api_key={api_key} +``` + +### List sequences + +```bash +GET https://api.convertkit.com/v3/sequences?api_key={api_key} +``` + +### List tags + +```bash +GET https://api.convertkit.com/v3/tags?api_key={api_key} +``` + +### Create broadcast + +```bash +POST https://api.convertkit.com/v3/broadcasts + +{ + "api_secret": "{api_secret}", + "subject": "Newsletter Subject", + "content": "

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": "

Welcome to our app!

" +} +``` + +### Send with React template + +```bash +POST https://api.resend.com/emails + +{ + "from": "hello@example.com", + "to": ["user@example.com"], + "subject": "Welcome!", + "react": "WelcomeEmail", + "props": { + "name": "John" + } +} +``` + +### Get email status + +```bash +GET https://api.resend.com/emails/{email_id} +``` + +### List emails + +```bash +GET https://api.resend.com/emails +``` + +### Send batch emails + +```bash +POST https://api.resend.com/emails/batch + +[ + { + "from": "hello@example.com", + "to": ["user1@example.com"], + "subject": "Welcome User 1" + }, + { + "from": "hello@example.com", + "to": ["user2@example.com"], + "subject": "Welcome User 2" + } +] +``` + +### List domains + +```bash +GET https://api.resend.com/domains +``` + +### Verify domain + +```bash +POST https://api.resend.com/domains/{domain_id}/verify +``` + +## Node.js SDK + +### Install + +```bash +npm install resend +``` + +### Usage + +```typescript +import { Resend } from 'resend'; + +const resend = new Resend('re_xxx'); + +await resend.emails.send({ + from: 'hello@example.com', + to: 'user@example.com', + subject: 'Welcome!', + html: '

Welcome!

' +}); +``` + +### With React Email + +```typescript +import { WelcomeEmail } from './emails/welcome'; + +await resend.emails.send({ + from: 'hello@example.com', + to: 'user@example.com', + subject: 'Welcome!', + react: WelcomeEmail({ name: 'John' }) +}); +``` + +## Email Statuses + +- `queued` - Email queued for delivery +- `sent` - Email sent to recipient server +- `delivered` - Email delivered +- `opened` - Email opened (if tracking enabled) +- `clicked` - Link clicked (if tracking enabled) +- `bounced` - Email bounced +- `complained` - Marked as spam + +## Webhook Events + +| Event | When | +|-------|------| +| `email.sent` | Email sent | +| `email.delivered` | Email delivered | +| `email.opened` | Email opened | +| `email.clicked` | Link clicked | +| `email.bounced` | Email bounced | +| `email.complained` | Spam complaint | + +## When to Use + +- Sending transactional emails +- Welcome emails, password resets +- Receipt and notification emails +- Developer-friendly email integration +- React-based email templates + +## Rate Limits + +- Free: 100 emails/day, 3,000/month +- Pro: 100 emails/second +- Higher limits on scale plans + +## Relevant Skills + +- email-sequence +- onboarding-cro diff --git a/tools/integrations/rewardful.md b/tools/integrations/rewardful.md new file mode 100644 index 0000000..3cc0789 --- /dev/null +++ b/tools/integrations/rewardful.md @@ -0,0 +1,147 @@ +# Rewardful + +Affiliate and referral tracking for Stripe-based SaaS businesses. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API for affiliates, referrals, commissions | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | - | API-only, JavaScript snippet for tracking | + +## Authentication + +- **Type**: API Key +- **Header**: `Authorization: Bearer {api_secret}` +- **Get key**: Settings > API in Rewardful dashboard + +## Common Agent Operations + +### List affiliates + +```bash +GET https://api.getrewardful.com/v1/affiliates +``` + +### Get affiliate by ID + +```bash +GET https://api.getrewardful.com/v1/affiliates/{affiliate_id} +``` + +### Search affiliate by email + +```bash +GET https://api.getrewardful.com/v1/affiliates?email=affiliate@example.com +``` + +### Get referral by Stripe customer + +```bash +GET https://api.getrewardful.com/v1/referrals?stripe_customer_id={customer_id} +``` + +### List referrals for affiliate + +```bash +GET https://api.getrewardful.com/v1/referrals?affiliate_id={affiliate_id} +``` + +### Get commission details + +```bash +GET https://api.getrewardful.com/v1/commissions/{commission_id} +``` + +### List commissions + +```bash +GET https://api.getrewardful.com/v1/commissions?affiliate_id={affiliate_id} +``` + +### Create affiliate link + +```bash +POST https://api.getrewardful.com/v1/affiliates/{affiliate_id}/links + +{ + "token": "custom-link-token", + "url": "https://example.com/pricing" +} +``` + +### Update affiliate + +```bash +PUT https://api.getrewardful.com/v1/affiliates/{affiliate_id} + +{ + "first_name": "John", + "last_name": "Doe", + "paypal_email": "john@example.com" +} +``` + +## JavaScript Tracking + +### Install snippet + +```html + + +``` + +### Track conversion manually + +```javascript +rewardful('convert', { email: 'customer@example.com' }); +``` + +## Webhook Events + +| Event | When | +|-------|------| +| `affiliate.created` | New affiliate signs up | +| `affiliate.approved` | Affiliate approved | +| `referral.created` | New referral tracked | +| `referral.converted` | Referral becomes customer | +| `commission.created` | Commission generated | +| `commission.paid` | Commission paid out | + +## Key Objects + +- **Affiliate** - Partner promoting your product +- **Referral** - Tracked visit/lead from affiliate +- **Commission** - Earned payment for affiliate +- **Campaign** - Program with specific terms +- **Link** - Tracking URL for affiliate + +## Integration with Stripe + +Rewardful automatically: +1. Tracks referral cookie when user visits via affiliate link +2. Associates Stripe customer with referral on checkout +3. Creates commissions when subscriptions are paid +4. Handles recurring commissions for subscriptions + +## When to Use + +- Setting up affiliate/referral programs for SaaS +- Tracking referral attribution from Stripe payments +- Managing affiliate relationships +- Processing affiliate payouts +- Analyzing referral program performance + +## Rate Limits + +- 120 requests per minute +- Contact support for higher limits + +## Relevant Skills + +- referral-program +- pricing-strategy diff --git a/tools/integrations/salesforce.md b/tools/integrations/salesforce.md new file mode 100644 index 0000000..b75e77f --- /dev/null +++ b/tools/integrations/salesforce.md @@ -0,0 +1,150 @@ +# Salesforce + +Enterprise CRM platform for sales, service, and marketing. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST API, SOAP API, Bulk API | +| MCP | - | Not available | +| CLI | ✓ | Salesforce CLI (`sf`) | +| SDK | ✓ | JSforce, simple-salesforce, etc. | + +## Authentication + +- **Type**: OAuth 2.0 (Web Server Flow or JWT Bearer) +- **Header**: `Authorization: Bearer {access_token}` +- **Instance URL**: Use instance_url from auth response + +## Common Agent Operations + +### Query records (SOQL) + +```bash +GET https://{instance}.salesforce.com/services/data/v59.0/query?q=SELECT+Id,Name,Email+FROM+Contact+LIMIT+10 + +Authorization: Bearer {access_token} +``` + +### Get record by ID + +```bash +GET https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/{record_id} + +Authorization: Bearer {access_token} +``` + +### Create record + +```bash +POST https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact + +{ + "FirstName": "John", + "LastName": "Doe", + "Email": "john@example.com", + "AccountId": "{account_id}" +} +``` + +### Update record + +```bash +PATCH https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/{record_id} + +{ + "Title": "Senior Developer" +} +``` + +### Search records (SOSL) + +```bash +GET https://{instance}.salesforce.com/services/data/v59.0/search?q=FIND+{searchTerm}+IN+ALL+FIELDS+RETURNING+Contact(Id,Name,Email) + +Authorization: Bearer {access_token} +``` + +### Get opportunities + +```bash +GET https://{instance}.salesforce.com/services/data/v59.0/query?q=SELECT+Id,Name,Amount,StageName,CloseDate+FROM+Opportunity+WHERE+IsClosed=false + +Authorization: Bearer {access_token} +``` + +### Describe object + +```bash +GET https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/describe + +Authorization: Bearer {access_token} +``` + +## CLI Commands + +```bash +# Authenticate +sf org login web + +# Query records +sf data query --query "SELECT Id, Name FROM Account LIMIT 10" + +# Create record +sf data create record --sobject Account --values "Name='New Account'" + +# Deploy metadata +sf project deploy start + +# Run Apex +sf apex run --file script.apex +``` + +## SOQL Examples + +```sql +-- Get contacts with accounts +SELECT Id, Name, Email, Account.Name +FROM Contact +WHERE Account.Industry = 'Technology' + +-- Get opportunities by stage +SELECT StageName, COUNT(Id) +FROM Opportunity +GROUP BY StageName + +-- Get recent leads +SELECT Id, Name, Company, Status +FROM Lead +WHERE CreatedDate = LAST_N_DAYS:30 +ORDER BY CreatedDate DESC +``` + +## Key Objects + +- **Lead** - Potential customer +- **Contact** - Person at account +- **Account** - Company/organization +- **Opportunity** - Sales deal +- **Case** - Support ticket +- **Campaign** - Marketing campaign + +## When to Use + +- Enterprise CRM operations +- Complex sales processes +- Multi-object relationships +- Custom object management +- Marketing campaign tracking + +## Rate Limits + +- 15,000 API calls per 24 hours (Enterprise) +- Higher limits available + +## Relevant Skills + +- email-sequence +- analytics-tracking +- paid-ads diff --git a/tools/integrations/segment.md b/tools/integrations/segment.md new file mode 100644 index 0000000..980e18a --- /dev/null +++ b/tools/integrations/segment.md @@ -0,0 +1,159 @@ +# Segment + +Customer data platform for collecting, routing, and activating user data. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Tracking API, Profile API, Config API | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | analytics.js, iOS, Android, server libraries | + +## Authentication + +- **Tracking**: Write Key (per source) +- **API**: Access Token (OAuth 2.0) +- **Header**: `Authorization: Bearer {access_token}` + +## Common Agent Operations + +### Track event + +```bash +POST https://api.segment.io/v1/track + +Authorization: Basic {base64(write_key:)} + +{ + "userId": "user_123", + "event": "signup_completed", + "properties": { + "plan": "pro", + "method": "email" + } +} +``` + +### Identify user + +```bash +POST https://api.segment.io/v1/identify + +Authorization: Basic {base64(write_key:)} + +{ + "userId": "user_123", + "traits": { + "email": "user@example.com", + "name": "John Doe", + "plan": "pro" + } +} +``` + +### Track page view + +```bash +POST https://api.segment.io/v1/page + +Authorization: Basic {base64(write_key:)} + +{ + "userId": "user_123", + "name": "Pricing", + "properties": { + "title": "Pricing - Example", + "url": "https://example.com/pricing" + } +} +``` + +### Batch events + +```bash +POST https://api.segment.io/v1/batch + +Authorization: Basic {base64(write_key:)} + +{ + "batch": [ + {"type": "identify", "userId": "user_1", "traits": {"plan": "free"}}, + {"type": "track", "userId": "user_1", "event": "signup"} + ] +} +``` + +### Get user profile (Profile API) + +```bash +GET https://profiles.segment.com/v1/spaces/{space_id}/collections/users/profiles/user_id:{user_id}/traits + +Authorization: Basic {base64(access_token:)} +``` + +### Get user events + +```bash +GET https://profiles.segment.com/v1/spaces/{space_id}/collections/users/profiles/user_id:{user_id}/events + +Authorization: Basic {base64(access_token:)} +``` + +## JavaScript SDK + +```javascript +// Initialize +analytics.load('WRITE_KEY'); + +// Identify user +analytics.identify('user_123', { + email: 'user@example.com', + plan: 'pro' +}); + +// Track event +analytics.track('Feature Used', { + feature_name: 'export' +}); + +// Page view +analytics.page('Pricing'); +``` + +## Key Concepts + +- **Sources** - Where data comes from (website, app, server) +- **Destinations** - Where data goes (analytics, CRM, ads) +- **Tracking Plan** - Schema for events and properties +- **Protocols** - Data governance and validation +- **Personas** - Unified user profiles +- **Audiences** - Computed user segments + +## Common Destinations + +- Analytics: GA4, Mixpanel, Amplitude +- CRM: HubSpot, Salesforce +- Email: Customer.io, Mailchimp +- Ads: Google Ads, Meta +- Data Warehouse: BigQuery, Snowflake + +## When to Use + +- Centralizing event tracking +- Routing data to multiple tools +- Maintaining consistent tracking +- Building unified user profiles +- Syncing audiences across platforms + +## Rate Limits + +- 500 requests/second per source +- Batch up to 500KB or 32KB per event + +## Relevant Skills + +- analytics-tracking +- email-sequence +- paid-ads diff --git a/tools/integrations/semrush.md b/tools/integrations/semrush.md new file mode 100644 index 0000000..931212a --- /dev/null +++ b/tools/integrations/semrush.md @@ -0,0 +1,121 @@ +# SEMrush + +SEO and competitive analysis platform for keyword research and site audits. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Analytics API, Projects API | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | - | API-only | + +## Authentication + +- **Type**: API Key +- **Parameter**: `key={api_key}` in query string +- **Get key**: My Profile > API in SEMrush dashboard + +## Common Agent Operations + +### Domain overview + +```bash +GET https://api.semrush.com/?type=domain_ranks&key={api_key}&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=example.com +``` + +### Organic keywords + +```bash +GET https://api.semrush.com/?type=domain_organic&key={api_key}&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr&domain=example.com&database=us&display_limit=100 +``` + +### Keyword overview + +```bash +GET https://api.semrush.com/?type=phrase_all&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr&phrase=keyword&database=us +``` + +### Related keywords + +```bash +GET https://api.semrush.com/?type=phrase_related&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr,Td&phrase=keyword&database=us&display_limit=50 +``` + +### Keyword difficulty + +```bash +GET https://api.semrush.com/?type=phrase_kdi&key={api_key}&export_columns=Ph,Kd&phrase=keyword&database=us +``` + +### Backlinks overview + +```bash +GET https://api.semrush.com/?type=backlinks_overview&key={api_key}&target=example.com&target_type=root_domain +``` + +### Backlinks list + +```bash +GET https://api.semrush.com/?type=backlinks&key={api_key}&target=example.com&target_type=root_domain&export_columns=source_url,source_title,target_url,anchor&display_limit=100 +``` + +### Competitors + +```bash +GET https://api.semrush.com/?type=domain_organic_organic&key={api_key}&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&domain=example.com&database=us&display_limit=20 +``` + +## Response Format + +Responses are CSV by default. Add `&export_escape=1` for proper escaping. + +## Export Columns + +### Domain Report +- `Db` - Database +- `Dn` - Domain +- `Rk` - Rank +- `Or` - Organic keywords +- `Ot` - Organic traffic +- `Oc` - Organic cost + +### Keyword Report +- `Ph` - Phrase/keyword +- `Nq` - Search volume +- `Cp` - CPC +- `Co` - Competition +- `Kd` - Keyword difficulty +- `Nr` - Number of results + +### Backlinks +- `source_url` - Linking page +- `target_url` - Target page +- `anchor` - Anchor text +- `source_title` - Page title + +## Databases + +Use country code: `us`, `uk`, `de`, `fr`, `ca`, `au`, etc. + +## When to Use + +- Keyword research +- Competitive analysis +- Backlink analysis +- Site audits +- Rank tracking +- Content gap analysis + +## Rate Limits + +- Varies by plan (10-30K units/day) +- Each API call costs units + +## Relevant Skills + +- seo-audit +- programmatic-seo +- content-strategy +- competitor-alternatives diff --git a/tools/integrations/sendgrid.md b/tools/integrations/sendgrid.md new file mode 100644 index 0000000..a16d1a3 --- /dev/null +++ b/tools/integrations/sendgrid.md @@ -0,0 +1,161 @@ +# SendGrid + +Email delivery platform for transactional and marketing emails. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | Mail Send API, Marketing API | +| MCP | - | Not available | +| CLI | - | Not available | +| SDK | ✓ | Official libraries for most languages | + +## Authentication + +- **Type**: API Key +- **Header**: `Authorization: Bearer {api_key}` +- **Get key**: Settings > API Keys in SendGrid dashboard + +## Common Agent Operations + +### Send email + +```bash +POST https://api.sendgrid.com/v3/mail/send + +Authorization: Bearer {api_key} + +{ + "personalizations": [{ + "to": [{"email": "user@example.com"}] + }], + "from": {"email": "hello@example.com"}, + "subject": "Welcome!", + "content": [{ + "type": "text/html", + "value": "

Welcome!

" + }] +} +``` + +### Send with template + +```bash +POST https://api.sendgrid.com/v3/mail/send + +{ + "personalizations": [{ + "to": [{"email": "user@example.com"}], + "dynamic_template_data": { + "name": "John", + "order_id": "12345" + } + }], + "from": {"email": "hello@example.com"}, + "template_id": "d-xxx" +} +``` + +### Add contact to list + +```bash +PUT https://api.sendgrid.com/v3/marketing/contacts + +{ + "list_ids": ["list-id"], + "contacts": [{ + "email": "user@example.com", + "first_name": "John", + "last_name": "Doe" + }] +} +``` + +### Search contacts + +```bash +POST https://api.sendgrid.com/v3/marketing/contacts/search + +{ + "query": "email LIKE 'user@%'" +} +``` + +### Get email statistics + +```bash +GET https://api.sendgrid.com/v3/stats?start_date=2024-01-01&end_date=2024-01-31 + +Authorization: Bearer {api_key} +``` + +### Get bounces + +```bash +GET https://api.sendgrid.com/v3/suppression/bounces + +Authorization: Bearer {api_key} +``` + +### Get spam reports + +```bash +GET https://api.sendgrid.com/v3/suppression/spam_reports + +Authorization: Bearer {api_key} +``` + +### Validate email + +```bash +POST https://api.sendgrid.com/v3/validations/email + +{ + "email": "user@example.com" +} +``` + +## Webhook Events + +| Event | Description | +|-------|-------------| +| `processed` | Email accepted | +| `delivered` | Email delivered | +| `open` | Email opened | +| `click` | Link clicked | +| `bounce` | Hard/soft bounce | +| `dropped` | Email dropped | +| `spamreport` | Marked as spam | +| `unsubscribe` | Unsubscribed | + +## Node.js SDK + +```javascript +const sgMail = require('@sendgrid/mail'); +sgMail.setApiKey('SG.xxx'); + +await sgMail.send({ + to: 'user@example.com', + from: 'hello@example.com', + subject: 'Welcome!', + html: '

Welcome!

' +}); +``` + +## When to Use + +- Transactional email at scale +- Marketing email campaigns +- Email validation +- Deliverability management + +## Rate Limits + +- Free: 100 emails/day +- Paid: Varies by plan (up to millions/month) + +## Relevant Skills + +- email-sequence +- analytics-tracking diff --git a/tools/integrations/shopify.md b/tools/integrations/shopify.md new file mode 100644 index 0000000..a3c20b8 --- /dev/null +++ b/tools/integrations/shopify.md @@ -0,0 +1,176 @@ +# Shopify + +E-commerce platform for online stores and retail. + +## Capabilities + +| Integration | Available | Notes | +|-------------|-----------|-------| +| API | ✓ | REST Admin API, Storefront API, GraphQL | +| MCP | - | Not available | +| CLI | ✓ | Shopify CLI for themes and apps | +| SDK | ✓ | Official libraries for multiple languages | + +## Authentication + +- **Type**: Access Token (Custom App or OAuth) +- **Header**: `X-Shopify-Access-Token: {access_token}` +- **Base URL**: `https://{shop}.myshopify.com/admin/api/2024-01/` + +## Common Agent Operations + +### Get shop info + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/shop.json + +X-Shopify-Access-Token: {access_token} +``` + +### List products + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/products.json?limit=50 + +X-Shopify-Access-Token: {access_token} +``` + +### Get product + +```bash +GET https://{shop}.myshopify.com/admin/api/2024-01/products/{product_id}.json + +X-Shopify-Access-Token: {access_token} +``` + +### Create product + +```bash +POST https://{shop}.myshopify.com/admin/api/2024-01/products.json + +X-Shopify-Access-Token: {access_token} + +{ + "product": { + "title": "Product Name", + "body_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