@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/typeform.md

@@ -0,0 +1,190 @@
+# Typeform
+
+Forms and surveys platform API for creating typeforms, retrieving responses, managing webhooks, themes, images, and workspaces.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Create, Responses, Webhooks APIs |
+| MCP | - | Not available |
+| CLI | ✓ | [typeform.js](../clis/typeform.js) |
+| SDK | ✓ | JavaScript (@typeform/js-api-client), Embed SDK |
+
+## Authentication
+
+- **Type**: Bearer Token (Personal Access Token or OAuth 2.0)
+- **Header**: `Authorization: Bearer {token}`
+- **Get key**: https://admin.typeform.com/account#/section/tokens
+
+## Common Agent Operations
+
+### List forms
+
+```bash
+GET https://api.typeform.com/forms
+```
+
+### Get a form
+
+```bash
+GET https://api.typeform.com/forms/{form_id}
+```
+
+### Create a form
+
+```bash
+POST https://api.typeform.com/forms
+
+{
+  "title": "Customer Feedback Survey",
+  "fields": [
+    {
+      "type": "short_text",
+      "title": "What is your name?"
+    },
+    {
+      "type": "rating",
+      "title": "How would you rate our service?",
+      "properties": {
+        "steps": 5
+      }
+    }
+  ]
+}
+```
+
+### Update a form
+
+```bash
+PUT https://api.typeform.com/forms/{form_id}
+
+{
+  "title": "Updated Survey Title"
+}
+```
+
+### Delete a form
+
+```bash
+DELETE https://api.typeform.com/forms/{form_id}
+```
+
+### Retrieve responses
+
+```bash
+GET https://api.typeform.com/forms/{form_id}/responses?page_size=25&since=2024-01-01T00:00:00Z
+```
+
+### Delete responses
+
+```bash
+DELETE https://api.typeform.com/forms/{form_id}/responses?included_response_ids={id1},{id2}
+```
+
+### List webhooks
+
+```bash
+GET https://api.typeform.com/forms/{form_id}/webhooks
+```
+
+### Create or update webhook
+
+```bash
+PUT https://api.typeform.com/forms/{form_id}/webhooks/{tag}
+
+{
+  "url": "https://example.com/webhook",
+  "enabled": true
+}
+```
+
+### Delete webhook
+
+```bash
+DELETE https://api.typeform.com/forms/{form_id}/webhooks/{tag}
+```
+
+### List themes
+
+```bash
+GET https://api.typeform.com/themes
+```
+
+### List images
+
+```bash
+GET https://api.typeform.com/images
+```
+
+### List workspaces
+
+```bash
+GET https://api.typeform.com/workspaces
+```
+
+### Get a workspace
+
+```bash
+GET https://api.typeform.com/workspaces/{workspace_id}
+```
+
+## Key Metrics
+
+### Response Data
+- `response_id` - Unique response identifier
+- `landed_at` / `submitted_at` - Timestamps
+- `answers` - Array of field answers
+- `variables` - Calculated variables
+- `hidden` - Hidden field values
+- `calculated` - Score calculations
+
+### Form Data
+- `id` - Form ID (from URL)
+- `title` - Form title
+- `fields` - Array of form fields
+- `logic` - Logic jumps
+- `settings` - Form settings (notifications, meta, etc.)
+- `_links` - Display and responses URLs
+
+## Parameters
+
+### Retrieve Responses
+- `page_size` - Results per page (default 25, max 1000)
+- `since` / `until` - Date range filter (ISO 8601 or Unix timestamp)
+- `after` / `before` - Pagination tokens
+- `response_type` - Filter: started, partial, completed (default: completed)
+- `query` - Text search within responses
+- `fields` - Show only specific fields in answers
+- `sort` - Sort order: `{fieldID},{asc|desc}`
+- `included_response_ids` / `excluded_response_ids` - Filter specific responses
+- `answered_fields` - Only responses containing specified fields
+
+### List Forms
+- `page` - Page number
+- `page_size` - Results per page (default 10, max 200)
+- `workspace_id` - Filter by workspace
+- `search` - Search by form title
+
+## When to Use
+
+- Collecting lead information and survey data
+- Building custom form experiences programmatically
+- Automating survey creation for campaigns
+- Analyzing form response data at scale
+- Setting up real-time response webhooks
+- Managing form themes and branding
+
+## Rate Limits
+
+- **Create & Responses APIs**: 2 requests per second per account
+- **Webhooks & Embed**: No rate limits (push-based)
+- Monitor for HTTP 429 responses
+
+## Relevant Skills
+
+- lead-generation
+- customer-research
+- page-cro
+- signup-flow-cro
+- customer-feedback

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

package/payload/tools/integrations/wistia.md

@@ -0,0 +1,164 @@
+# Wistia
+
+Video hosting, management, and analytics platform built for marketers with detailed engagement tracking.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Data API (v1/modern), Stats API, Upload API |
+| MCP | - | Not available |
+| CLI | ✓ | [wistia.js](../clis/wistia.js) |
+| SDK | ✓ | Ruby (official), community wrappers for other languages |
+
+## Authentication
+
+- **Type**: Bearer Token
+- **Header**: `Authorization: Bearer {api_token}`
+- **Get key**: Account Settings > API tab at https://account.wistia.com/account/api
+- **Note**: Only Account Owners can create/manage tokens. Tokens can only be copied when first created.
+
+## Common Agent Operations
+
+### List all projects
+
+```bash
+GET https://api.wistia.com/v1/projects.json?page=1&per_page=25
+```
+
+### Create a project
+
+```bash
+POST https://api.wistia.com/v1/projects.json
+
+{
+  "name": "Marketing Videos Q1"
+}
+```
+
+### List all media
+
+```bash
+GET https://api.wistia.com/v1/medias.json?page=1&per_page=25
+```
+
+### Get media details
+
+```bash
+GET https://api.wistia.com/v1/medias/{media_hashed_id}.json
+```
+
+### Get media stats
+
+```bash
+GET https://api.wistia.com/v1/medias/{media_hashed_id}/stats.json
+```
+
+### Get account-wide stats
+
+```bash
+GET https://api.wistia.com/v1/stats/account.json
+```
+
+### Get media engagement data (heatmap)
+
+```bash
+GET https://api.wistia.com/v1/stats/medias/{media_id}/engagement.json
+```
+
+### Get media stats by date
+
+```bash
+GET https://api.wistia.com/v1/stats/medias/{media_id}/by_date.json?start_date=2026-01-01&end_date=2026-01-31
+```
+
+### List visitors
+
+```bash
+GET https://api.wistia.com/v1/stats/visitors.json?page=1&per_page=25
+```
+
+### List viewing events
+
+```bash
+GET https://api.wistia.com/v1/stats/events.json?media_id={media_id}
+```
+
+### Update media metadata
+
+```bash
+PUT https://api.wistia.com/v1/medias/{media_hashed_id}.json
+
+{
+  "name": "Updated Video Title",
+  "description": "New description"
+}
+```
+
+### List captions for a video
+
+```bash
+GET https://api.wistia.com/v1/medias/{media_hashed_id}/captions.json
+```
+
+## API Versions
+
+Wistia has two API versions:
+- **v1** (`/v1/`) - Legacy, perpetually supported, no breaking changes
+- **modern** (`/modern/`) - Current version, date-based versioning via `X-Wistia-Api-Version` header
+
+The CLI uses v1 for maximum stability.
+
+## Key Metrics
+
+### Media Stats
+- `plays` - Total video plays
+- `visitors` - Unique visitors
+- `pageLoads` - Page load count
+- `averagePercentWatched` - Average watch percentage
+- `percentOfVisitorsClickingPlay` - Play click rate
+
+### Engagement Data
+- Heatmap data showing exactly where viewers watch, rewatch, and drop off
+- Per-second engagement breakdown
+
+### Account Stats
+- `total_medias` - Total video count
+- `total_plays` - Account-wide plays
+- `total_hours_watched` - Total hours of video watched
+
+## Parameters
+
+### Media List Parameters
+- `page` - Page number (default: 1)
+- `per_page` - Results per page (default: 25, max: 100)
+- `project_id` - Filter by project
+- `name` - Filter by name
+- `type` - Filter by type (Video, Audio, Image, etc.)
+
+### Stats Date Parameters
+- `start_date` - Start date (YYYY-MM-DD)
+- `end_date` - End date (YYYY-MM-DD)
+
+## When to Use
+
+- Hosting marketing and product videos with analytics
+- Tracking video engagement and viewer behavior
+- A/B testing video thumbnails and CTAs
+- Embedding videos with custom player branding
+- Analyzing which parts of videos drive engagement
+- Lead generation via video email gates
+
+## Rate Limits
+
+- 600 requests per minute per account
+- Exceeding returns HTTP 429 with `Retry-After` header
+- Asset access (media file downloads) does not count toward limit
+- Events data returns records from past 2 years only
+
+## Relevant Skills
+
+- video-marketing
+- content-repurposing
+- landing-page-optimization
+- lead-generation

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