@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/keywords-everywhere.md

@@ -0,0 +1,207 @@
+# Keywords Everywhere
+
+Keyword research API for search volume, CPC, competition, related keywords, and traffic data.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for keyword data, related keywords, traffic |
+| MCP | - | Community MCP server available |
+| CLI | ✓ | [keywords-everywhere.js](../clis/keywords-everywhere.js) |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: API Key (Bearer token)
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: https://keywordseverywhere.com/first-install-addon.html
+- **Limit**: 100 keywords per request
+
+## Common Agent Operations
+
+### Get keyword data (volume, CPC, competition)
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_keyword_data
+
+Authorization: Bearer {api_key}
+
+{
+  "country": "us",
+  "currency": "USD",
+  "dataSource": "gkp",
+  "kw": ["email marketing", "marketing automation", "crm software"]
+}
+```
+
+### Get related keywords
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_related_keywords
+
+Authorization: Bearer {api_key}
+
+{
+  "country": "us",
+  "currency": "USD",
+  "dataSource": "gkp",
+  "kw": ["email marketing"]
+}
+```
+
+### Get "People Also Search For" keywords
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_pasf_keywords
+
+Authorization: Bearer {api_key}
+
+{
+  "country": "us",
+  "currency": "USD",
+  "dataSource": "gkp",
+  "kw": ["email marketing"]
+}
+```
+
+### Get domain keywords (what a domain ranks for)
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_domain_keywords
+
+Authorization: Bearer {api_key}
+
+{
+  "country": "us",
+  "currency": "USD",
+  "domain": "example.com"
+}
+```
+
+### Get URL keywords (what a specific URL ranks for)
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_url_keywords
+
+Authorization: Bearer {api_key}
+
+{
+  "country": "us",
+  "currency": "USD",
+  "url": "https://example.com/page"
+}
+```
+
+### Get domain traffic
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_domain_traffic
+
+Authorization: Bearer {api_key}
+
+{
+  "country": "us",
+  "domain": "example.com"
+}
+```
+
+### Get URL traffic
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_url_traffic
+
+Authorization: Bearer {api_key}
+
+{
+  "country": "us",
+  "url": "https://example.com/page"
+}
+```
+
+### Get domain backlinks
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_domain_backlinks
+
+Authorization: Bearer {api_key}
+
+{
+  "domain": "example.com"
+}
+```
+
+### Get page backlinks
+
+```bash
+POST https://api.keywordseverywhere.com/v1/get_page_backlinks
+
+Authorization: Bearer {api_key}
+
+{
+  "url": "https://example.com/page"
+}
+```
+
+### Check credits
+
+```bash
+GET https://api.keywordseverywhere.com/v1/get_credits
+
+Authorization: Bearer {api_key}
+```
+
+### Get supported countries
+
+```bash
+GET https://api.keywordseverywhere.com/v1/get_countries
+
+Authorization: Bearer {api_key}
+```
+
+### Get supported currencies
+
+```bash
+GET https://api.keywordseverywhere.com/v1/get_currencies
+
+Authorization: Bearer {api_key}
+```
+
+## Key Metrics
+
+### Keyword Data
+- `vol` - Monthly search volume
+- `cpc.value` - Cost per click
+- `competition` - Competition score
+- `trend` - 12-month trend data
+
+### Traffic Data
+- `estimated_traffic` - Estimated monthly traffic
+- `keywords_count` - Number of ranking keywords
+
+## Parameters
+
+- `country` - Country code (us, uk, de, fr, etc.)
+- `currency` - Currency code (USD, GBP, EUR, etc.)
+- `dataSource` - Data source, default `gkp` (Google Keyword Planner)
+- `kw` - Array of keywords (max 100 per request)
+
+## When to Use
+
+- Quick keyword research with volume and CPC
+- Finding related keywords and PASF suggestions
+- Analyzing domain/URL keyword rankings
+- Traffic estimation for domains and pages
+- Backlink discovery
+
+## Rate Limits
+
+- 100 keywords per request
+- Credit-based pricing (1 credit per keyword)
+
+## Relevant Skills
+
+- seo-audit
+- content-strategy
+- programmatic-seo
+- competitor-alternatives

package/payload/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": "<p>Email content here</p>",
+  "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

package/payload/tools/integrations/klaviyo.md

@@ -0,0 +1,228 @@
+# Klaviyo
+
+E-commerce email and SMS marketing platform with profiles, flows, campaigns, segments, and event tracking.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API with JSON:API spec, revision-versioned |
+| MCP | - | Not available |
+| CLI | ✓ | [klaviyo.js](../clis/klaviyo.js) |
+| SDK | ✓ | Python, Node.js, Ruby, PHP, Java, C# |
+
+## Authentication
+
+- **Type**: Private API Key
+- **Header**: `Authorization: Klaviyo-API-Key {private_api_key}`
+- **Revision Header**: `revision: 2024-10-15` (required on all requests)
+- **Get key**: Account Settings > API Keys at https://www.klaviyo.com/settings/account/api-keys
+- **Note**: Private keys are prefixed with `pk_`; public keys (6-char site ID) are for client-side only
+
+## Common Agent Operations
+
+### List profiles
+
+```bash
+GET https://a.klaviyo.com/api/profiles/?page[size]=20
+
+# Filter by email
+GET https://a.klaviyo.com/api/profiles/?filter=equals(email,"user@example.com")
+```
+
+### Create profile
+
+```bash
+POST https://a.klaviyo.com/api/profiles/
+
+{
+  "data": {
+    "type": "profile",
+    "attributes": {
+      "email": "user@example.com",
+      "first_name": "Jane",
+      "last_name": "Doe",
+      "phone_number": "+15551234567"
+    }
+  }
+}
+```
+
+### Update profile
+
+```bash
+PATCH https://a.klaviyo.com/api/profiles/{profileId}/
+
+{
+  "data": {
+    "type": "profile",
+    "id": "{profileId}",
+    "attributes": {
+      "first_name": "Updated Name"
+    }
+  }
+}
+```
+
+### List all lists
+
+```bash
+GET https://a.klaviyo.com/api/lists/
+```
+
+### Create list
+
+```bash
+POST https://a.klaviyo.com/api/lists/
+
+{
+  "data": {
+    "type": "list",
+    "attributes": {
+      "name": "Newsletter Subscribers"
+    }
+  }
+}
+```
+
+### Add profiles to list
+
+```bash
+POST https://a.klaviyo.com/api/lists/{listId}/relationships/profiles/
+
+{
+  "data": [
+    { "type": "profile", "id": "{profileId1}" },
+    { "type": "profile", "id": "{profileId2}" }
+  ]
+}
+```
+
+### Track event
+
+```bash
+POST https://a.klaviyo.com/api/events/
+
+{
+  "data": {
+    "type": "event",
+    "attributes": {
+      "metric": {
+        "data": {
+          "type": "metric",
+          "attributes": { "name": "Placed Order" }
+        }
+      },
+      "profile": {
+        "data": {
+          "type": "profile",
+          "attributes": { "email": "user@example.com" }
+        }
+      },
+      "properties": {
+        "value": 99.99,
+        "items": ["Product A"]
+      },
+      "time": "2025-01-15T10:00:00Z"
+    }
+  }
+}
+```
+
+### List campaigns
+
+```bash
+GET https://a.klaviyo.com/api/campaigns/?filter=equals(messages.channel,"email")
+```
+
+### List flows
+
+```bash
+GET https://a.klaviyo.com/api/flows/
+```
+
+### Update flow status
+
+```bash
+PATCH https://a.klaviyo.com/api/flows/{flowId}/
+
+{
+  "data": {
+    "type": "flow",
+    "id": "{flowId}",
+    "attributes": {
+      "status": "live"
+    }
+  }
+}
+```
+
+### List metrics
+
+```bash
+GET https://a.klaviyo.com/api/metrics/
+```
+
+### List segments
+
+```bash
+GET https://a.klaviyo.com/api/segments/
+```
+
+## API Pattern
+
+Klaviyo uses the JSON:API specification. All request/response bodies use `{ "data": { "type": "...", "attributes": {...} } }` format. Relationships are managed via `/relationships/` sub-endpoints. The `revision` header is required on every request and determines API behavior version.
+
+## Key Metrics
+
+### Profile Fields
+- `email` - Email address
+- `phone_number` - Phone for SMS
+- `first_name`, `last_name` - Name fields
+- `properties` - Custom properties object
+- `subscriptions` - Email/SMS subscription status
+
+### Event Fields
+- `metric` - The metric/event name
+- `properties` - Custom event properties
+- `time` - Event timestamp
+- `value` - Monetary value (for revenue tracking)
+
+### Campaign/Flow Metrics
+- `send_count` - Number of sends
+- `open_rate` - Open percentage
+- `click_rate` - Click percentage
+- `revenue` - Attributed revenue
+
+## Parameters
+
+### Common Query Parameters
+- `page[size]` - Results per page (default 20, max 100)
+- `page[cursor]` - Cursor for pagination
+- `filter` - Filter expressions (e.g., `equals(email,"user@example.com")`)
+- `sort` - Sort field (prefix `-` for descending)
+- `include` - Include related resources
+- `fields[resource]` - Sparse fieldsets
+
+## When to Use
+
+- E-commerce email/SMS marketing automation
+- Syncing customer profiles from external systems
+- Tracking purchase events and customer behavior
+- Managing email flows and drip campaigns
+- Segmenting audiences for targeted campaigns
+- Reporting on campaign and flow performance
+
+## Rate Limits
+
+- Steady-state: 75 requests/second for most endpoints
+- Burst: up to 700 requests in 1 minute
+- Rate limit headers: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`
+- Lower limits on some write endpoints (profiles, events)
+
+## Relevant Skills
+
+- email-sequence
+- ecommerce-email
+- lifecycle-marketing
+- customer-segmentation

package/payload/tools/integrations/lemlist.md

@@ -0,0 +1,110 @@
+# Lemlist
+
+Cold email outreach platform with personalization and campaign management.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for campaigns, leads, activities, webhooks |
+| MCP | - | Not available |
+| CLI | [✓](../clis/lemlist.js) | Zero-dependency Node.js CLI |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: Basic Auth (empty username, API key as password)
+- **Header**: `Authorization: Basic base64(:api_key)`
+- **Env var**: `LEMLIST_API_KEY`
+- **Get key**: [Lemlist Settings > Integrations](https://app.lemlist.com/settings/integrations)
+
+## Common Agent Operations
+
+### List campaigns
+
+```bash
+node tools/clis/lemlist.js campaigns list --offset 0 --limit 20
+```
+
+### Get campaign details and stats
+
+```bash
+# Get campaign
+node tools/clis/lemlist.js campaigns get --id cam_abc123
+
+# Get campaign stats
+node tools/clis/lemlist.js campaigns stats --id cam_abc123
+
+# Export campaign data
+node tools/clis/lemlist.js campaigns export --id cam_abc123
+```
+
+### Manage leads in a campaign
+
+```bash
+# List leads
+node tools/clis/lemlist.js leads list --campaign-id cam_abc123
+
+# Add a lead
+node tools/clis/lemlist.js leads add --campaign-id cam_abc123 --email john@example.com --first-name John --last-name Doe --company "Example Inc"
+
+# Get lead details
+node tools/clis/lemlist.js leads get --campaign-id cam_abc123 --email john@example.com
+
+# Remove a lead
+node tools/clis/lemlist.js leads delete --campaign-id cam_abc123 --email john@example.com
+```
+
+### Manage unsubscribes
+
+```bash
+# List unsubscribed emails
+node tools/clis/lemlist.js unsubscribes list
+
+# Add to unsubscribe list
+node tools/clis/lemlist.js unsubscribes add --email john@example.com
+
+# Remove from unsubscribe list
+node tools/clis/lemlist.js unsubscribes delete --email john@example.com
+```
+
+### View activities
+
+```bash
+# All activities
+node tools/clis/lemlist.js activities list
+
+# Filter by campaign and type
+node tools/clis/lemlist.js activities list --campaign-id cam_abc123 --type emailsOpened
+```
+
+### Manage webhooks
+
+```bash
+# List hooks
+node tools/clis/lemlist.js hooks list
+
+# Create a webhook
+node tools/clis/lemlist.js hooks create --target-url https://example.com/webhook --event emailsOpened
+
+# Delete a webhook
+node tools/clis/lemlist.js hooks delete --id hook_123
+```
+
+### Team info
+
+```bash
+node tools/clis/lemlist.js team info
+```
+
+## Rate Limits
+
+- API rate limits vary by plan
+- Recommended: stay under 10 requests/second
+
+## Use Cases
+
+- **Link building outreach**: Add prospects to campaigns for backlink requests
+- **Campaign management**: Monitor open/reply rates across outreach campaigns
+- **Lead management**: Add, remove, and track leads across campaigns
+- **Webhook integration**: Get real-time notifications for email events