@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/plausible.md

@@ -0,0 +1,177 @@
+# Plausible Analytics
+
+Privacy-focused, open-source web analytics with a simple API for stats queries without cookies or personal data collection.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Stats v2 Query, Sites Provisioning, Goals, Shared Links |
+| MCP | - | Not available |
+| CLI | ✓ | [plausible.js](../clis/plausible.js) |
+| SDK | - | REST API only |
+
+## Authentication
+
+- **Type**: Bearer Token
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: https://plausible.io/settings > API Keys
+- **Note**: Sites API requires Enterprise plan
+
+## Common Agent Operations
+
+### Stats Query (v2)
+
+```bash
+POST https://plausible.io/api/v2/query
+
+{
+  "site_id": "example.com",
+  "metrics": ["visitors", "pageviews", "bounce_rate", "visit_duration"],
+  "date_range": "30d"
+}
+```
+
+### Top Pages
+
+```bash
+POST https://plausible.io/api/v2/query
+
+{
+  "site_id": "example.com",
+  "metrics": ["visitors", "pageviews"],
+  "date_range": "30d",
+  "dimensions": ["event:page"]
+}
+```
+
+### Traffic Sources
+
+```bash
+POST https://plausible.io/api/v2/query
+
+{
+  "site_id": "example.com",
+  "metrics": ["visitors", "bounce_rate"],
+  "date_range": "30d",
+  "dimensions": ["visit:source"]
+}
+```
+
+### Time Series
+
+```bash
+POST https://plausible.io/api/v2/query
+
+{
+  "site_id": "example.com",
+  "metrics": ["visitors", "pageviews"],
+  "date_range": "30d",
+  "dimensions": ["time:day"]
+}
+```
+
+### Breakdown by Country
+
+```bash
+POST https://plausible.io/api/v2/query
+
+{
+  "site_id": "example.com",
+  "metrics": ["visitors", "percentage"],
+  "date_range": "30d",
+  "dimensions": ["visit:country"]
+}
+```
+
+### Filtered Query (specific page)
+
+```bash
+POST https://plausible.io/api/v2/query
+
+{
+  "site_id": "example.com",
+  "metrics": ["visitors", "pageviews", "bounce_rate"],
+  "date_range": "30d",
+  "filters": [["is", "event:page", ["/pricing"]]]
+}
+```
+
+### Realtime Visitors (v1)
+
+```bash
+GET https://plausible.io/api/v1/stats/realtime/visitors?site_id=example.com
+```
+
+### List Sites
+
+```bash
+GET https://plausible.io/api/v1/sites
+```
+
+## Key Metrics
+
+### Available Metrics
+- `visitors` - Unique visitors
+- `visits` - Total visits (sessions)
+- `pageviews` - Total page views
+- `views_per_visit` - Pages per session
+- `bounce_rate` - Bounce rate percentage
+- `visit_duration` - Average session duration (seconds)
+- `events` - Total events
+- `conversion_rate` - Goal conversion rate
+- `time_on_page` - Average time on page
+- `scroll_depth` - Average scroll depth
+- `percentage` - Share of total
+
+### Available Dimensions
+- `event:page` - Page path
+- `event:goal` - Goal name
+- `visit:source` - Traffic source
+- `visit:referrer` - Referrer URL
+- `visit:channel` - Traffic channel
+- `visit:utm_source`, `visit:utm_medium`, `visit:utm_campaign` - UTM params
+- `visit:device` - Device type
+- `visit:browser` - Browser name
+- `visit:os` - Operating system
+- `visit:country`, `visit:region`, `visit:city` - Location
+- `visit:entry_page`, `visit:exit_page` - Entry/exit pages
+- `time`, `time:day`, `time:week`, `time:month` - Time periods
+
+## Parameters
+
+### Stats Query (v2)
+- `site_id` (required) - Domain registered in Plausible
+- `metrics` (required) - Array of metrics to return
+- `date_range` (required) - Time period: "day", "7d", "30d", "month", "6mo", "12mo", "year", or custom ["2024-01-01", "2024-01-31"]
+- `dimensions` - Array of dimensions to group by
+- `filters` - Array of filter conditions: `[operator, dimension, values]`
+- `order_by` - Array of sort specs: `[[metric, "desc"]]`
+- `pagination` - `{ "limit": 100, "offset": 0 }`
+
+### Filter Operators
+- `is` / `is_not` - Exact match
+- `contains` / `contains_not` - Substring match
+- `matches` / `matches_not` - Wildcard match
+
+## When to Use
+
+- Privacy-first web analytics without cookies
+- Simple, lightweight traffic analysis
+- UTM campaign performance tracking
+- Goal and conversion tracking
+- Geographic and device breakdown
+- GDPR/CCPA-compliant analytics alternative to GA4
+
+## Rate Limits
+
+- 600 requests/hour per API key
+- All requests must be over HTTPS
+
+## Relevant Skills
+
+- analytics-tracking
+- content-strategy
+- programmatic-seo
+- page-cro
+- utm-tracking

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

package/payload/tools/integrations/postmark.md

@@ -0,0 +1,234 @@
+# Postmark
+
+Transactional email delivery service with fast delivery, templates, bounce management, and detailed analytics.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for email sending, templates, bounces, stats |
+| MCP | - | Not available |
+| CLI | ✓ | [postmark.js](../clis/postmark.js) |
+| SDK | ✓ | Node.js, Ruby, Python, PHP, Java, .NET, Go |
+
+## Authentication
+
+- **Type**: Server Token (or Account Token for account-level ops)
+- **Header**: `X-Postmark-Server-Token: {server_token}` (server-level)
+- **Header**: `X-Postmark-Account-Token: {account_token}` (account-level)
+- **Get key**: API Tokens tab at https://account.postmarkapp.com/servers
+- **Note**: Server tokens are per-server; account tokens apply across all servers
+
+## Common Agent Operations
+
+### Send single email
+
+```bash
+POST https://api.postmarkapp.com/email
+
+{
+  "From": "sender@example.com",
+  "To": "recipient@example.com",
+  "Subject": "Welcome!",
+  "HtmlBody": "<html><body><p>Hello!</p></body></html>",
+  "TextBody": "Hello!",
+  "MessageStream": "outbound",
+  "TrackOpens": true,
+  "TrackLinks": "HtmlAndText"
+}
+```
+
+### Send with template
+
+```bash
+POST https://api.postmarkapp.com/email/withTemplate
+
+{
+  "From": "sender@example.com",
+  "To": "recipient@example.com",
+  "TemplateId": 12345,
+  "TemplateModel": {
+    "name": "Jane",
+    "action_url": "https://example.com/verify"
+  },
+  "MessageStream": "outbound"
+}
+```
+
+### Send batch emails
+
+```bash
+POST https://api.postmarkapp.com/email/batch
+
+[
+  {
+    "From": "sender@example.com",
+    "To": "user1@example.com",
+    "Subject": "Notification",
+    "TextBody": "Hello user 1"
+  },
+  {
+    "From": "sender@example.com",
+    "To": "user2@example.com",
+    "Subject": "Notification",
+    "TextBody": "Hello user 2"
+  }
+]
+```
+
+### List templates
+
+```bash
+GET https://api.postmarkapp.com/templates?Count=100&Offset=0
+```
+
+### Get template
+
+```bash
+GET https://api.postmarkapp.com/templates/{templateIdOrAlias}
+```
+
+### Create template
+
+```bash
+POST https://api.postmarkapp.com/templates
+
+{
+  "Name": "Welcome Email",
+  "Alias": "welcome",
+  "Subject": "Welcome {{name}}!",
+  "HtmlBody": "<html><body><p>Hello {{name}}</p></body></html>",
+  "TextBody": "Hello {{name}}"
+}
+```
+
+### Get delivery stats
+
+```bash
+GET https://api.postmarkapp.com/deliverystats
+```
+
+### List bounces
+
+```bash
+GET https://api.postmarkapp.com/bounces?count=50&offset=0&type=HardBounce
+```
+
+### Activate bounce (reactivate recipient)
+
+```bash
+PUT https://api.postmarkapp.com/bounces/{bounceId}/activate
+```
+
+### Search outbound messages
+
+```bash
+GET https://api.postmarkapp.com/messages/outbound?count=50&offset=0&recipient=user@example.com
+```
+
+### Get outbound stats overview
+
+```bash
+GET https://api.postmarkapp.com/stats/outbound?fromdate=2025-01-01&todate=2025-01-31
+```
+
+### Get open stats
+
+```bash
+GET https://api.postmarkapp.com/stats/outbound/opens?fromdate=2025-01-01&todate=2025-01-31
+```
+
+### Get click stats
+
+```bash
+GET https://api.postmarkapp.com/stats/outbound/clicks?fromdate=2025-01-01&todate=2025-01-31
+```
+
+### Get server info
+
+```bash
+GET https://api.postmarkapp.com/server
+```
+
+### List suppressions
+
+```bash
+GET https://api.postmarkapp.com/message-streams/outbound/suppressions/dump
+```
+
+### Create suppression
+
+```bash
+POST https://api.postmarkapp.com/message-streams/outbound/suppressions
+
+{
+  "Suppressions": [
+    { "EmailAddress": "user@example.com" }
+  ]
+}
+```
+
+## API Pattern
+
+Postmark uses simple REST endpoints with PascalCase field names in request/response bodies. Authentication is via custom headers rather than Authorization. Pagination uses `Count` and `Offset` parameters. Email sending is synchronous with immediate delivery confirmation.
+
+## Key Metrics
+
+### Delivery Metrics
+- `Sent` - Total emails sent
+- `Bounced` - Bounce count by type (hard, soft, transient)
+- `SpamComplaints` - Spam complaint count
+- `Opens` - Open count and unique opens
+- `Clicks` - Click count and unique clicks
+
+### Bounce Types
+- `HardBounce` - Permanent delivery failure
+- `SoftBounce` - Temporary delivery failure
+- `Transient` - Temporary issue (retry)
+- `SpamNotification` - Marked as spam
+
+### Message Fields
+- `MessageID` - Unique message identifier
+- `SubmittedAt` - Submission timestamp
+- `Status` - Delivery status
+- `Recipients` - Recipient list
+
+## Parameters
+
+### Email Parameters
+- `From` - Sender address (must be verified)
+- `To` - Recipient (comma-separated for multiple)
+- `Subject` - Email subject
+- `HtmlBody` / `TextBody` - Email content
+- `MessageStream` - outbound (transactional) or broadcast
+- `TrackOpens` - Enable open tracking (boolean)
+- `TrackLinks` - None, HtmlAndText, HtmlOnly, TextOnly
+- `Tag` - Custom tag for categorization
+
+### Stats Parameters
+- `fromdate` - Start date (YYYY-MM-DD)
+- `todate` - End date (YYYY-MM-DD)
+- `tag` - Filter by tag
+
+## When to Use
+
+- Transactional emails (password resets, order confirmations, notifications)
+- Template-based email sending with dynamic variables
+- Monitoring email deliverability and bounce rates
+- Tracking email engagement (opens, clicks)
+- Managing email suppressions and bounces
+- High-reliability email delivery with fast performance
+
+## Rate Limits
+
+- 500 messages per batch request
+- 10 MB max per single message (including attachments)
+- 50 MB max per batch request
+- API rate limits vary by plan
+
+## Relevant Skills
+
+- email-sequence
+- transactional-email
+- email-deliverability
+- onboarding-email