@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/dataforseo.md

@@ -0,0 +1,165 @@
+# DataForSEO
+
+Comprehensive SEO data API for SERP results, keyword research, backlinks, and on-page analysis.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | SERP, Keywords Data, Backlinks, On-Page, Labs |
+| MCP | - | Not available |
+| CLI | ✓ | [dataforseo.js](../clis/dataforseo.js) |
+| SDK | ✓ | Python, TypeScript, PHP, Java, C# |
+
+## Authentication
+
+- **Type**: Basic Auth
+- **Header**: `Authorization: Basic {base64(login:password)}`
+- **Get credentials**: API Access tab at https://app.dataforseo.com/api-access
+- **Note**: API password is auto-generated, different from account password
+
+## Common Agent Operations
+
+### SERP - Google organic (live)
+
+```bash
+POST https://api.dataforseo.com/v3/serp/google/organic/live/regular
+
+[{
+  "keyword": "marketing automation",
+  "location_name": "United States",
+  "language_name": "English"
+}]
+```
+
+### Keywords - Search volume (live)
+
+```bash
+POST https://api.dataforseo.com/v3/keywords_data/google_ads/search_volume/live
+
+[{
+  "keywords": ["email marketing", "marketing automation", "crm software"],
+  "location_code": 2840,
+  "language_code": "en"
+}]
+```
+
+### Keywords - Keywords for site (live)
+
+```bash
+POST https://api.dataforseo.com/v3/keywords_data/google_ads/keywords_for_site/live
+
+[{
+  "target": "example.com",
+  "location_code": 2840,
+  "language_code": "en"
+}]
+```
+
+### Backlinks - Summary
+
+```bash
+POST https://api.dataforseo.com/v3/backlinks/summary/live
+
+[{
+  "target": "example.com",
+  "internal_list_limit": 10,
+  "backlinks_status_type": "live"
+}]
+```
+
+### Backlinks - List
+
+```bash
+POST https://api.dataforseo.com/v3/backlinks/backlinks/live
+
+[{
+  "target": "example.com",
+  "mode": "as_is",
+  "limit": 100,
+  "backlinks_status_type": "live"
+}]
+```
+
+### Backlinks - Referring domains
+
+```bash
+POST https://api.dataforseo.com/v3/backlinks/referring_domains/live
+
+[{
+  "target": "example.com",
+  "limit": 100
+}]
+```
+
+### Backlinks - Index (database stats)
+
+```bash
+GET https://api.dataforseo.com/v3/backlinks/index
+```
+
+### On-Page - Instant pages audit
+
+```bash
+POST https://api.dataforseo.com/v3/on_page/instant_pages
+
+[{
+  "url": "https://example.com/page",
+  "enable_javascript": true
+}]
+```
+
+### SERP - Locations list
+
+```bash
+GET https://api.dataforseo.com/v3/serp/google/locations
+```
+
+### SERP - Languages list
+
+```bash
+GET https://api.dataforseo.com/v3/serp/google/languages
+```
+
+## API Pattern
+
+DataForSEO uses two methods for most endpoints:
+- **Live** (`/live`) - Synchronous, results in same response
+- **Task-based** (`/task_post` + `/task_get/$id`) - Async for large requests
+
+Request bodies are always JSON arrays (even for single requests).
+
+## Key Metrics
+
+### Keyword Metrics
+- `search_volume` - Monthly search volume
+- `competition` - Competition level (0-1)
+- `cpc` - Cost per click
+- `monthly_searches` - Monthly breakdown array
+
+### Backlink Metrics
+- `total_backlinks` - Total backlink count
+- `referring_domains` - Unique referring domains
+- `domain_rank` - Domain authority score
+- `backlinks_spam_score` - Spam score
+
+## When to Use
+
+- Programmatic SERP tracking at scale
+- Keyword research with search volume data
+- Backlink analysis and monitoring
+- On-page SEO audits
+- Competitor analysis
+
+## Rate Limits
+
+- Rate limit headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`
+- Backlinks API: 2000 requests/minute, 30 simultaneous
+- Varies by endpoint and plan
+
+## Relevant Skills
+
+- seo-audit
+- programmatic-seo
+- content-strategy
+- competitor-alternatives

package/payload/tools/integrations/demio.md

@@ -0,0 +1,182 @@
+# Demio
+
+Webinar platform for hosting live, automated, and on-demand webinars with built-in registration and attendee tracking.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Events, Registration, Participants, Sessions |
+| MCP | - | Not available |
+| CLI | ✓ | [demio.js](../clis/demio.js) |
+| SDK | ✓ | PHP (official), Ruby (community) |
+
+## Authentication
+
+- **Type**: API Key + API Secret
+- **Headers**: `Api-Key: {key}` and `Api-Secret: {secret}`
+- **Get credentials**: Account Settings > API (Owner access required)
+- **Docs**: https://publicdemioapi.docs.apiary.io/
+
+## Common Agent Operations
+
+### Ping (health check)
+
+```bash
+GET https://my.demio.com/api/v1/ping
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+```
+
+### List all events
+
+```bash
+GET https://my.demio.com/api/v1/events
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+```
+
+### List events by type
+
+```bash
+GET https://my.demio.com/api/v1/events?type=upcoming
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+```
+
+### Get a specific event
+
+```bash
+GET https://my.demio.com/api/v1/event/{event_id}
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+```
+
+### Get event date details
+
+```bash
+GET https://my.demio.com/api/v1/event/{event_id}/date/{date_id}
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+```
+
+### Register attendee for event
+
+```bash
+POST https://my.demio.com/api/v1/event/register
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+  Content-Type: application/json
+
+{
+  "id": 12345,
+  "name": "Jane Doe",
+  "email": "jane@example.com"
+}
+```
+
+### Register attendee for specific date
+
+```bash
+POST https://my.demio.com/api/v1/event/register
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+  Content-Type: application/json
+
+{
+  "id": 12345,
+  "date_id": 67890,
+  "name": "Jane Doe",
+  "email": "jane@example.com"
+}
+```
+
+### Get participants for event date
+
+```bash
+GET https://my.demio.com/api/v1/date/{date_id}/participants
+
+Headers:
+  Api-Key: {API_KEY}
+  Api-Secret: {API_SECRET}
+```
+
+## API Pattern
+
+Demio uses a straightforward REST API:
+- All requests require both `Api-Key` and `Api-Secret` headers
+- Responses are JSON objects
+- Registration returns a `join_link` URL for the attendee
+- Events have multiple "dates" (sessions), each with a unique `date_id`
+
+## Key Metrics
+
+### Event Metrics
+- `id` - Event ID
+- `name` - Event name
+- `date_id` - Session/date identifier
+- `status` - Event status (upcoming, past, active)
+- `type` - Event type (live, automated, on-demand)
+- `registration_url` - Public registration page URL
+
+### Participant Metrics
+- `name` - Participant name
+- `email` - Participant email
+- `status` - Attendance status (registered, attended, missed)
+- `attended_minutes` - Duration of attendance
+- `join_link` - Unique join URL for the participant
+
+## Parameters
+
+### Event List Filters
+- `type` - Filter by event type: `upcoming`, `past`, `all`
+
+### Registration Fields
+- `id` - Event ID (required)
+- `name` - Registrant name (required)
+- `email` - Registrant email (required)
+- `date_id` - Specific session date ID (optional)
+- `ref_url` - Referral URL for tracking (optional)
+
+### Custom Fields
+- Custom fields are supported via their UID (not display name)
+- Check your event settings for available custom field UIDs
+
+## When to Use
+
+- Automating webinar registration from landing pages or forms
+- Syncing webinar attendee data with CRM
+- Building custom registration flows for webinars
+- Tracking webinar attendance and engagement
+- Triggering follow-up sequences based on attendance status
+- Managing multiple webinar sessions programmatically
+
+## Rate Limits
+
+- **180 requests per minute** (3 per second)
+- **Free Trial**: 100 API calls per day
+- **Paid Plans**: 5,000 API calls per day (reset at 00:00 UTC)
+- Contact Demio to request higher daily limits
+- Exceeding limits returns an error response
+
+## Relevant Skills
+
+- webinar-marketing
+- lead-generation
+- event-marketing
+- content-strategy
+- lifecycle-marketing

package/payload/tools/integrations/dub-co.md

@@ -0,0 +1,160 @@
+# Dub.co
+
+Link management and attribution platform for modern marketing teams.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for links, analytics, domains |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | ✓ | TypeScript SDK available |
+
+## Authentication
+
+- **Type**: API Key
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: Settings > API Keys in Dub dashboard
+
+## Common Agent Operations
+
+### Create short link
+
+```bash
+POST https://api.dub.co/links
+
+{
+  "url": "https://example.com/landing-page",
+  "domain": "link.example.com",
+  "key": "summer-sale",
+  "tags": ["campaign:summer", "channel:email"]
+}
+```
+
+### Get link by key
+
+```bash
+GET https://api.dub.co/links?domain=link.example.com&key=summer-sale
+```
+
+### List links
+
+```bash
+GET https://api.dub.co/links?domain=link.example.com&page=1
+```
+
+### Get link analytics
+
+```bash
+GET https://api.dub.co/analytics?domain=link.example.com&key=summer-sale&interval=30d
+```
+
+### Get clicks by location
+
+```bash
+GET https://api.dub.co/analytics/country?domain=link.example.com&key=summer-sale
+```
+
+### Get clicks by device
+
+```bash
+GET https://api.dub.co/analytics/device?domain=link.example.com&key=summer-sale
+```
+
+### Update link
+
+```bash
+PATCH https://api.dub.co/links/{link_id}
+
+{
+  "url": "https://example.com/new-landing-page",
+  "tags": ["campaign:summer", "channel:social"]
+}
+```
+
+### Delete link
+
+```bash
+DELETE https://api.dub.co/links/{link_id}
+```
+
+### Bulk create links
+
+```bash
+POST https://api.dub.co/links/bulk
+
+[
+  {"url": "https://example.com/page1", "key": "page1"},
+  {"url": "https://example.com/page2", "key": "page2"}
+]
+```
+
+## TypeScript SDK
+
+### Install
+
+```bash
+npm install dub
+```
+
+### Usage
+
+```typescript
+import { Dub } from "dub";
+
+const dub = new Dub({ token: "YOUR_API_KEY" });
+
+// Create link
+const link = await dub.links.create({
+  url: "https://example.com",
+  domain: "link.example.com"
+});
+
+// Get analytics
+const analytics = await dub.analytics.retrieve({
+  domain: "link.example.com",
+  key: "summer-sale"
+});
+```
+
+## Key Features
+
+- **Custom domains** - Use your own branded domains
+- **Link analytics** - Clicks, locations, devices, referrers
+- **Tags** - Organize links by campaign, channel, etc.
+- **QR codes** - Auto-generated for each link
+- **Password protection** - Secure sensitive links
+- **Expiration** - Time-limited links
+- **Geo-targeting** - Redirect based on location
+
+## Analytics Dimensions
+
+- `clicks` - Total click count
+- `country` - Clicks by country
+- `city` - Clicks by city
+- `device` - Clicks by device type
+- `browser` - Clicks by browser
+- `os` - Clicks by operating system
+- `referer` - Clicks by referrer
+
+## When to Use
+
+- Creating trackable marketing links
+- Building referral link systems
+- Tracking campaign attribution
+- A/B testing landing pages via links
+- Generating branded short URLs
+- Analyzing link performance
+
+## Rate Limits
+
+- Free: 1,000 links, 5 API requests/second
+- Pro: Unlimited links, 50 API requests/second
+- Enterprise: Custom limits
+
+## Relevant Skills
+
+- referral-program
+- analytics-tracking
+- paid-ads

package/payload/tools/integrations/g2.md

@@ -0,0 +1,179 @@
+# G2
+
+Software review and research platform for B2B buyers. Access reviews, product data, competitor comparisons, and buyer intent signals.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Reviews, Products, Reports, Categories, Tracking |
+| MCP | - | Not available |
+| CLI | ✓ | [g2.js](../clis/g2.js) |
+| SDK | - | REST API with JSON:API format |
+
+## Authentication
+
+- **Type**: API Token
+- **Header**: `Authorization: Token token={YOUR_API_TOKEN}`
+- **Content-Type**: `application/vnd.api+json` (JSON:API)
+- **Get token**: G2 Admin Portal > Integrations > API Tokens
+- **Docs**: https://data.g2.com/api/docs
+
+## Common Agent Operations
+
+### List reviews (survey responses)
+
+```bash
+GET https://data.g2.com/api/v1/survey-responses?page[size]=25&page[number]=1
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### Get a specific review
+
+```bash
+GET https://data.g2.com/api/v1/survey-responses/{id}
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### Filter reviews by product
+
+```bash
+GET https://data.g2.com/api/v1/survey-responses?filter[product_id]={product_id}&page[size]=25
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### List products
+
+```bash
+GET https://data.g2.com/api/v1/products?page[size]=25&page[number]=1
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### Get a specific product
+
+```bash
+GET https://data.g2.com/api/v1/products/{id}
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### List reports
+
+```bash
+GET https://data.g2.com/api/v1/reports?page[size]=25&page[number]=1
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### List categories
+
+```bash
+GET https://data.g2.com/api/v1/categories?page[size]=25&page[number]=1
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### Get competitor comparisons
+
+```bash
+GET https://data.g2.com/api/v1/competitor-comparisons?filter[product_id]={product_id}&page[size]=25
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+### Get tracking events (buyer intent)
+
+```bash
+GET https://data.g2.com/api/v1/tracking-events?filter[start_date]=2025-01-01&filter[end_date]=2025-12-31
+
+Headers:
+  Authorization: Token token={API_TOKEN}
+  Content-Type: application/vnd.api+json
+```
+
+## API Pattern
+
+G2 follows the JSON:API specification (https://jsonapi.org/):
+- Responses use `data`, `attributes`, `relationships`, `meta` structure
+- Pagination: `page[number]` and `page[size]` query parameters
+- Filtering: `filter[field]=value` query parameters
+- Reviews returned newest-first by default (10 per page default)
+
+## Key Metrics
+
+### Review Metrics
+- `star_rating` - Overall star rating
+- `title` - Review title
+- `comment_answers` - Structured review responses (likes, dislikes, recommendations)
+- `submitted_at` - Review submission date
+- `is_public` - Whether the review is publicly visible
+
+### Product Metrics
+- `name` - Product name
+- `slug` - URL slug on G2
+- `avg_rating` - Average star rating
+- `total_reviews` - Total review count
+- `category` - G2 category placement
+
+### Buyer Intent (Tracking)
+- `company_name` - Visiting company name
+- `page_visited` - G2 page URL visited
+- `visited_at` - Visit timestamp
+- `activity_type` - Type of buyer activity
+
+## Parameters
+
+### Pagination
+- `page[number]` - Page number (default: 1)
+- `page[size]` - Items per page (default: 10, max: 100)
+
+### Review Filters
+- `filter[product_id]` - Filter by product ID
+- `filter[state]` - Filter by review state
+
+### Tracking Filters
+- `filter[start_date]` - Start date (YYYY-MM-DD)
+- `filter[end_date]` - End date (YYYY-MM-DD)
+
+## When to Use
+
+- Monitoring and analyzing software product reviews
+- Tracking buyer intent signals from G2 visitors
+- Pulling competitor comparison data for positioning
+- Feeding review data into CRM or marketing automation
+- Building social proof content from G2 reviews
+- Tracking G2 category rankings and report placements
+
+## Rate Limits
+
+- 10,000 requests per hour per API token
+- Implement exponential backoff on 429 responses
+- Cache results where possible to reduce API calls
+
+## Relevant Skills
+
+- competitor-alternatives
+- social-proof
+- reputation-management
+- customer-feedback
+- review-generation