@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/activecampaign.md

@@ -0,0 +1,337 @@
+# ActiveCampaign
+
+Email marketing automation platform with CRM, contacts, deals pipeline, tags, automations, and campaign management.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v3 for contacts, deals, automations, campaigns, tags |
+| MCP | - | Not available |
+| CLI | ✓ | [activecampaign.js](../clis/activecampaign.js) |
+| SDK | ✓ | Python, PHP, Node.js, Ruby |
+
+## Authentication
+
+- **Type**: API Token
+- **Header**: `Api-Token: {api_token}`
+- **Base URL**: `https://{yourAccountName}.api-us1.com/api/3`
+- **Get key**: Settings > Developer tab in your ActiveCampaign account
+- **Note**: Each user has a unique API key. Base URL is account-specific (found in Settings > Developer).
+
+## Common Agent Operations
+
+### Get current user
+
+```bash
+GET https://{account}.api-us1.com/api/3/users/me
+```
+
+### List contacts
+
+```bash
+GET https://{account}.api-us1.com/api/3/contacts?limit=20&offset=0
+
+# Search by email
+GET https://{account}.api-us1.com/api/3/contacts?email=user@example.com
+
+# Search by name
+GET https://{account}.api-us1.com/api/3/contacts?search=Jane
+```
+
+### Create contact
+
+```bash
+POST https://{account}.api-us1.com/api/3/contacts
+
+{
+  "contact": {
+    "email": "user@example.com",
+    "firstName": "Jane",
+    "lastName": "Doe",
+    "phone": "+15551234567"
+  }
+}
+```
+
+### Update contact
+
+```bash
+PUT https://{account}.api-us1.com/api/3/contacts/{contactId}
+
+{
+  "contact": {
+    "firstName": "Updated",
+    "lastName": "Name"
+  }
+}
+```
+
+### Sync contact (create or update)
+
+```bash
+POST https://{account}.api-us1.com/api/3/contact/sync
+
+{
+  "contact": {
+    "email": "user@example.com",
+    "firstName": "Jane",
+    "lastName": "Doe"
+  }
+}
+```
+
+### Delete contact
+
+```bash
+DELETE https://{account}.api-us1.com/api/3/contacts/{contactId}
+```
+
+### List all lists
+
+```bash
+GET https://{account}.api-us1.com/api/3/lists?limit=20&offset=0
+```
+
+### Create list
+
+```bash
+POST https://{account}.api-us1.com/api/3/lists
+
+{
+  "list": {
+    "name": "Newsletter",
+    "stringid": "newsletter",
+    "sender_url": "https://example.com",
+    "sender_reminder": "You signed up for our newsletter."
+  }
+}
+```
+
+### Subscribe contact to list
+
+```bash
+POST https://{account}.api-us1.com/api/3/contactLists
+
+{
+  "contactList": {
+    "list": "1",
+    "contact": "1",
+    "status": 1
+  }
+}
+```
+
+### Unsubscribe contact from list
+
+```bash
+POST https://{account}.api-us1.com/api/3/contactLists
+
+{
+  "contactList": {
+    "list": "1",
+    "contact": "1",
+    "status": 2
+  }
+}
+```
+
+### List campaigns
+
+```bash
+GET https://{account}.api-us1.com/api/3/campaigns?limit=20&offset=0
+```
+
+### List deals
+
+```bash
+GET https://{account}.api-us1.com/api/3/deals?limit=20&offset=0
+
+# Filter by pipeline stage
+GET https://{account}.api-us1.com/api/3/deals?filters[stage]=1
+```
+
+### Create deal
+
+```bash
+POST https://{account}.api-us1.com/api/3/deals
+
+{
+  "deal": {
+    "title": "New Enterprise Deal",
+    "value": 50000,
+    "currency": "usd",
+    "group": "1",
+    "stage": "1",
+    "owner": "1",
+    "contact": "1"
+  }
+}
+```
+
+### Update deal
+
+```bash
+PUT https://{account}.api-us1.com/api/3/deals/{dealId}
+
+{
+  "deal": {
+    "stage": "2",
+    "value": 75000
+  }
+}
+```
+
+### List automations
+
+```bash
+GET https://{account}.api-us1.com/api/3/automations?limit=20&offset=0
+```
+
+### Add contact to automation
+
+```bash
+POST https://{account}.api-us1.com/api/3/contactAutomations
+
+{
+  "contactAutomation": {
+    "contact": "1",
+    "automation": "1"
+  }
+}
+```
+
+### List tags
+
+```bash
+GET https://{account}.api-us1.com/api/3/tags?limit=20&offset=0
+```
+
+### Create tag
+
+```bash
+POST https://{account}.api-us1.com/api/3/tags
+
+{
+  "tag": {
+    "tag": "VIP Customer",
+    "tagType": "contact"
+  }
+}
+```
+
+### Add tag to contact
+
+```bash
+POST https://{account}.api-us1.com/api/3/contactTags
+
+{
+  "contactTag": {
+    "contact": "1",
+    "tag": "1"
+  }
+}
+```
+
+### List pipelines (deal groups)
+
+```bash
+GET https://{account}.api-us1.com/api/3/dealGroups?limit=20&offset=0
+```
+
+### List webhooks
+
+```bash
+GET https://{account}.api-us1.com/api/3/webhooks?limit=20&offset=0
+```
+
+### Create webhook
+
+```bash
+POST https://{account}.api-us1.com/api/3/webhooks
+
+{
+  "webhook": {
+    "name": "Contact Updated",
+    "url": "https://example.com/webhook",
+    "events": ["subscribe", "unsubscribe"],
+    "sources": ["public", "admin", "api", "system"]
+  }
+}
+```
+
+## API Pattern
+
+ActiveCampaign uses REST with resource wrapping (e.g., `{ "contact": {...} }`). Responses include the resource object plus metadata. Related resources are managed via junction endpoints (e.g., `/contactLists`, `/contactTags`, `/contactAutomations`). The base URL is account-specific. Pagination uses `limit` and `offset` parameters.
+
+## Key Metrics
+
+### Contact Fields
+- `email` - Email address
+- `firstName`, `lastName` - Name fields
+- `phone` - Phone number
+- `cdate` - Creation date
+- `udate` - Last updated date
+- `deals` - Related deals count
+
+### Deal Fields
+- `title` - Deal name
+- `value` - Deal value in cents
+- `currency` - Currency code
+- `stage` - Pipeline stage ID
+- `group` - Pipeline (deal group) ID
+- `owner` - Assigned user ID
+- `status` - 0 (open), 1 (won), 2 (lost)
+
+### Campaign Metrics
+- `sends` - Total sends
+- `opens` - Opens count
+- `clicks` - Clicks count
+- `uniqueopens` - Unique opens
+- `uniquelinks` - Unique clicks
+
+## Parameters
+
+### Contact List Status
+- `1` - Subscribed (active)
+- `2` - Unsubscribed
+
+### Deal Status
+- `0` - Open
+- `1` - Won
+- `2` - Lost
+
+### Tag Types
+- `contact` - Contact tags
+- `deal` - Deal tags
+
+### Common Query Parameters
+- `limit` - Results per page (default 20)
+- `offset` - Skip N results
+- `search` - Text search
+- `email` - Filter contacts by email
+- `filters[stage]` - Filter deals by stage
+- `filters[owner]` - Filter deals by owner
+
+## When to Use
+
+- Marketing automation with complex conditional workflows
+- CRM with deal pipeline management
+- Contact management with tagging and segmentation
+- Email campaign creation and tracking
+- Triggering automations based on external events
+- B2B sales pipeline tracking integrated with marketing
+
+## Rate Limits
+
+- 5 requests per second per account
+- Rate limit applies across all API users on the same account
+- 429 responses include `Retry-After` header
+
+## Relevant Skills
+
+- email-sequence
+- lifecycle-marketing
+- crm-integration
+- sales-pipeline
+- marketing-automation

package/payload/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
+
+<?xml version="1.0" encoding="UTF-8"?>
+<request>
+  <visitorID>user_123</visitorID>
+  <events>event1</events>
+  <eVar1>campaign_name</eVar1>
+  <prop1>page_type</prop1>
+</request>
+```
+
+## 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

package/payload/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