@miranda0808/maya-codex 0.1.0

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

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

package/payload/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": "<h1>Welcome!</h1>"
+  }]
+}
+```
+
+### 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: '<h1>Welcome!</h1>'
+});
+```
+
+## 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

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

package/payload/tools/integrations/snov.md

@@ -0,0 +1,94 @@
+# Snov.io
+
+Email finding, verification, and drip campaign platform for outreach.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for email finding, verification, prospects, drip campaigns |
+| MCP | - | Not available |
+| CLI | [✓](../clis/snov.js) | Zero-dependency Node.js CLI |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: OAuth2 client credentials
+- **Flow**: POST to `/oauth/access_token` with client_id + client_secret
+- **Env vars**: `SNOV_CLIENT_ID`, `SNOV_CLIENT_SECRET`
+- **Get keys**: [Snov.io > Integration > API](https://app.snov.io/integration/api)
+
+The CLI handles token acquisition automatically.
+
+## Common Agent Operations
+
+### Search emails by domain
+
+```bash
+node tools/clis/snov.js domain search --domain example.com --type all --limit 10
+```
+
+### Find a specific person's email
+
+```bash
+node tools/clis/snov.js email find --domain example.com --first-name John --last-name Doe
+```
+
+### Verify an email
+
+```bash
+node tools/clis/snov.js email verify --email john@example.com
+```
+
+### Find prospect by email
+
+```bash
+node tools/clis/snov.js prospect find --email john@example.com
+```
+
+### Add prospect to a list
+
+```bash
+node tools/clis/snov.js prospect add --email john@example.com --first-name John --last-name Doe --list-id 12345
+```
+
+### Manage prospect lists
+
+```bash
+# List all lists
+node tools/clis/snov.js lists list
+
+# Get prospects in a list
+node tools/clis/snov.js lists prospects --id 12345 --page 1 --per-page 50
+```
+
+### Check domain technology stack
+
+```bash
+node tools/clis/snov.js technology check --domain example.com
+```
+
+### Manage drip campaigns
+
+```bash
+# List campaigns
+node tools/clis/snov.js drips list
+
+# Get campaign details
+node tools/clis/snov.js drips get --id 12345
+
+# Add prospect to drip campaign
+node tools/clis/snov.js drips add-prospect --id 12345 --email john@example.com
+```
+
+## Rate Limits
+
+- Rate limits vary by plan
+- OAuth tokens expire after a set period; CLI handles refresh automatically
+
+## Use Cases
+
+- **Link building**: Find contacts and run automated drip outreach
+- **Prospecting**: Build and manage prospect lists
+- **Technology research**: Check what tech stack a target domain uses
+- **Email verification**: Clean lists before sending