arkaos 4.25.0 → 4.27.0

package/departments/marketing/tools/integrations/optimizely.md

@@ -0,0 +1,171 @@
+# Optimizely
+
+A/B testing and experimentation platform with a REST API for managing projects, experiments, campaigns, and results.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Projects, Experiments, Campaigns, Audiences, Results |
+| MCP | - | Not available |
+| CLI | ✓ | [optimizely.js](../clis/optimizely.js) |
+| SDK | ✓ | JavaScript, Python, Ruby, Java, Go, C#, PHP, React, Swift, Android |
+
+## Authentication
+
+- **Type**: Bearer Token (Personal Access Token or OAuth 2.0)
+- **Header**: `Authorization: Bearer {personal_token}`
+- **Get token**: https://app.optimizely.com/v2/profile/api > Generate New Token
+
+## Common Agent Operations
+
+### List Projects
+
+```bash
+GET https://api.optimizely.com/v2/projects
+```
+
+### Get Project
+
+```bash
+GET https://api.optimizely.com/v2/projects/{project_id}
+```
+
+### List Experiments
+
+```bash
+GET https://api.optimizely.com/v2/experiments?project_id={project_id}
+```
+
+### Get Experiment
+
+```bash
+GET https://api.optimizely.com/v2/experiments/{experiment_id}
+```
+
+### Get Experiment Results
+
+```bash
+GET https://api.optimizely.com/v2/experiments/{experiment_id}/results
+```
+
+### Create Experiment
+
+```bash
+POST https://api.optimizely.com/v2/experiments
+
+{
+  "project_id": 12345,
+  "name": "Homepage CTA Test",
+  "type": "a/b",
+  "variations": [
+    { "name": "Control", "weight": 5000 },
+    { "name": "Variation 1", "weight": 5000 }
+  ],
+  "metrics": [{ "event_id": 67890 }],
+  "status": "not_started"
+}
+```
+
+### Update Experiment
+
+```bash
+PATCH https://api.optimizely.com/v2/experiments/{experiment_id}
+
+{
+  "status": "running"
+}
+```
+
+### List Campaigns
+
+```bash
+GET https://api.optimizely.com/v2/campaigns?project_id={project_id}
+```
+
+### Get Campaign Results
+
+```bash
+GET https://api.optimizely.com/v2/campaigns/{campaign_id}/results
+```
+
+### List Audiences
+
+```bash
+GET https://api.optimizely.com/v2/audiences?project_id={project_id}
+```
+
+### List Events
+
+```bash
+GET https://api.optimizely.com/v2/events?project_id={project_id}
+```
+
+### List Pages
+
+```bash
+GET https://api.optimizely.com/v2/pages?project_id={project_id}
+```
+
+## Key Metrics
+
+### Experiment Results
+- `variation_id` - Variation identifier
+- `variation_name` - Variation display name
+- `visitors` - Unique visitors per variation
+- `conversions` - Conversion count
+- `conversion_rate` - Rate as decimal
+- `improvement` - Percentage improvement vs. control
+- `statistical_significance` - Confidence level
+- `is_baseline` - Whether this is the control
+
+### Experiment Properties
+- `name` - Experiment name
+- `status` - not_started, running, paused, archived
+- `type` - a/b, multivariate, personalization
+- `traffic_allocation` - Percentage of traffic (0-10000 = 0-100%)
+- `variations` - Array of variations with weights
+
+## Parameters
+
+### List Experiments
+- `project_id` (required) - Project to list experiments for
+- `page` - Page number
+- `per_page` - Results per page (default: 25)
+- `status` - Filter by status
+
+### Get Results
+- `start_time` - Results start time (ISO 8601)
+- `end_time` - Results end time (ISO 8601)
+
+### Create Experiment
+- `project_id` (required) - Parent project
+- `name` (required) - Experiment name
+- `type` - Experiment type (default: a/b)
+- `variations` (required) - Array of variations with name and weight
+- `metrics` - Array of metric/event configurations
+- `audience_conditions` - Targeting conditions
+- `traffic_allocation` - Traffic percentage (0-10000)
+
+## When to Use
+
+- Running A/B tests on web pages and features
+- Managing experimentation programs at scale
+- Pulling experiment results for analysis
+- Automating experiment creation and monitoring
+- Feature flag management
+- Personalization campaigns
+
+## Rate Limits
+
+- 50 requests/second per personal token
+- Pagination via `page` and `per_page` parameters
+- OpenAPI spec available at https://api.optimizely.com/v2/swagger.json
+
+## Relevant Skills
+
+- ab-testing
+- cro
+- landing-page
+- personalization
+- analytics

package/departments/marketing/tools/integrations/outreach.md

@@ -0,0 +1,172 @@
+# Outreach
+
+Sales engagement platform for managing prospects, sequences, and outbound campaigns at scale.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Prospects, Sequences, Mailings, Accounts, Tasks |
+| MCP | ✓ | [Claude connector](https://claude.com/connectors/outreach) |
+| CLI | ✓ | [outreach.js](../clis/outreach.js) |
+| SDK | - | REST API only (JSON:API format) |
+
+## Authentication
+
+- **Type**: OAuth2 Bearer Token
+- **Header**: `Authorization: Bearer {access_token}`
+- **Content-Type**: `application/vnd.api+json`
+- **Get token**: Settings > API at https://app.outreach.io or via OAuth2 flow
+
+## Common Agent Operations
+
+### List Prospects
+
+```bash
+curl -s https://api.outreach.io/api/v2/prospects \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+### Get a Prospect
+
+```bash
+curl -s https://api.outreach.io/api/v2/prospects/42 \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+### Create a Prospect
+
+```bash
+curl -s -X POST https://api.outreach.io/api/v2/prospects \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json" \
+  -d '{
+    "data": {
+      "type": "prospect",
+      "attributes": {
+        "emails": ["jane@example.com"],
+        "firstName": "Jane",
+        "lastName": "Doe"
+      }
+    }
+  }'
+```
+
+### List Sequences
+
+```bash
+curl -s https://api.outreach.io/api/v2/sequences \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+### Add Prospect to Sequence
+
+```bash
+curl -s -X POST https://api.outreach.io/api/v2/sequenceStates \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json" \
+  -d '{
+    "data": {
+      "type": "sequenceState",
+      "relationships": {
+        "prospect": { "data": { "type": "prospect", "id": 42 } },
+        "sequence": { "data": { "type": "sequence", "id": 7 } }
+      }
+    }
+  }'
+```
+
+### List Mailings for a Sequence
+
+```bash
+curl -s "https://api.outreach.io/api/v2/mailings?filter[sequence][id]=7" \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+### List Accounts
+
+```bash
+curl -s https://api.outreach.io/api/v2/accounts \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+### List Tasks
+
+```bash
+curl -s "https://api.outreach.io/api/v2/tasks?filter[status]=incomplete" \
+  -H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
+  -H "Content-Type: application/vnd.api+json"
+```
+
+## Key Metrics
+
+### Prospect Data
+- `firstName`, `lastName` - Name
+- `emails` - Email addresses
+- `title` - Job title
+- `company` - Company name
+- `tags` - Prospect tags
+- `engagedAt` - Last engagement timestamp
+
+### Sequence Data
+- `name` - Sequence name
+- `enabled` - Whether sequence is active
+- `sequenceType` - Type (e.g., interval, date-based)
+- `stepCount` - Number of steps
+- `openCount`, `clickCount`, `replyCount` - Engagement metrics
+
+### Mailing Data
+- `mailingType` - Type of mailing
+- `state` - Delivery state
+- `openCount`, `clickCount` - Engagement
+- `deliveredAt`, `openedAt`, `clickedAt` - Timestamps
+
+## Parameters
+
+### Prospects
+- `page[number]` - Page number (default: 1)
+- `page[size]` - Results per page (default: 25, max: 1000)
+- `filter[emails]` - Filter by email
+- `filter[firstName]` - Filter by first name
+- `filter[lastName]` - Filter by last name
+- `sort` - Sort field (e.g., `createdAt`, `-updatedAt`)
+
+### Sequences
+- `filter[name]` - Filter by sequence name
+- `filter[enabled]` - Filter by active status
+
+### Mailings
+- `filter[sequence][id]` - Filter by sequence ID
+- `filter[prospect][id]` - Filter by prospect ID
+
+### Tasks
+- `filter[status]` - Filter by status (e.g., `incomplete`, `complete`)
+- `filter[taskType]` - Filter by type (e.g., `call`, `email`, `action_item`)
+
+## When to Use
+
+- Managing outbound sales sequences and cadences
+- Adding prospects to automated email sequences
+- Tracking prospect engagement across touchpoints
+- Managing sales tasks and follow-ups
+- Coordinating multi-channel outreach campaigns
+- Monitoring sequence performance and reply rates
+
+## Rate Limits
+
+- 10,000 requests per hour per user
+- Burst limit: 100 requests per 10 seconds
+- Rate limit headers returned: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
+- 429 responses when limits exceeded
+
+## Relevant Skills
+
+- cold-email
+- revops
+- sales-enablement
+- emails

package/departments/marketing/tools/integrations/paddle.md

@@ -0,0 +1,212 @@
+# Paddle
+
+SaaS billing and payments platform with built-in tax compliance, acting as merchant of record for global sales.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for products, prices, subscriptions, transactions |
+| MCP | - | Not available |
+| CLI | ✓ | [paddle.js](../clis/paddle.js) |
+| SDK | ✓ | Node.js, Python, PHP, Go |
+
+## Authentication
+
+- **Type**: Bearer Token
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: Paddle dashboard > Developer Tools > Authentication
+- **Production URL**: `https://api.paddle.com`
+- **Sandbox URL**: `https://sandbox-api.paddle.com`
+- **Note**: Version specified via header, not path. Set `PADDLE_SANDBOX=true` env var for sandbox.
+
+## Common Agent Operations
+
+### List products
+
+```bash
+GET https://api.paddle.com/products
+```
+
+### Create a product
+
+```bash
+POST https://api.paddle.com/products
+
+{
+  "name": "Pro Plan",
+  "tax_category": "standard",
+  "description": "Professional tier subscription"
+}
+```
+
+### Create a price for a product
+
+```bash
+POST https://api.paddle.com/prices
+
+{
+  "product_id": "pro_01abc...",
+  "description": "Monthly Pro",
+  "unit_price": {
+    "amount": "2999",
+    "currency_code": "USD"
+  },
+  "billing_cycle": {
+    "interval": "month",
+    "frequency": 1
+  }
+}
+```
+
+### List customers
+
+```bash
+GET https://api.paddle.com/customers
+```
+
+### Create a customer
+
+```bash
+POST https://api.paddle.com/customers
+
+{
+  "email": "customer@example.com",
+  "name": "Jane Smith"
+}
+```
+
+### List subscriptions
+
+```bash
+GET https://api.paddle.com/subscriptions?status=active
+```
+
+### Get subscription details
+
+```bash
+GET https://api.paddle.com/subscriptions/{subscription_id}
+```
+
+### Cancel a subscription
+
+```bash
+POST https://api.paddle.com/subscriptions/{subscription_id}/cancel
+
+{
+  "effective_from": "next_billing_period"
+}
+```
+
+### Pause a subscription
+
+```bash
+POST https://api.paddle.com/subscriptions/{subscription_id}/pause
+```
+
+### List transactions
+
+```bash
+GET https://api.paddle.com/transactions
+```
+
+### Create a discount
+
+```bash
+POST https://api.paddle.com/discounts
+
+{
+  "amount": "20",
+  "type": "percentage",
+  "description": "20% off first month",
+  "code": "WELCOME20"
+}
+```
+
+### Create a refund adjustment
+
+```bash
+POST https://api.paddle.com/adjustments
+
+{
+  "transaction_id": "txn_01abc...",
+  "action": "refund",
+  "reason": "Customer requested refund",
+  "items": [{"item_id": "txnitm_01abc...", "type": "full"}]
+}
+```
+
+### List events
+
+```bash
+GET https://api.paddle.com/events
+```
+
+### List event types
+
+```bash
+GET https://api.paddle.com/event-types
+```
+
+## Key Metrics
+
+### Transaction Metrics
+- `totals.total` - Total amount charged
+- `totals.tax` - Tax amount
+- `totals.subtotal` - Amount before tax
+- `totals.discount` - Discount applied
+- `currency_code` - Transaction currency
+
+### Subscription Metrics
+- `status` - active, canceled, paused, past_due, trialing
+- `current_billing_period` - Current period start/end
+- `next_billed_at` - Next billing date
+- `scheduled_change` - Pending changes (cancellation, plan change)
+
+### Product/Price Metrics
+- `unit_price.amount` - Price in lowest denomination
+- `billing_cycle` - Interval and frequency
+- `trial_period` - Trial duration if set
+
+## Parameters
+
+### List Filtering
+- `status` - Filter by status (e.g., active, archived)
+- `after` - Cursor for pagination
+- `per_page` - Results per page (default: 50)
+- `order_by` - Sort field and direction
+
+### Subscription Cancel Options
+- `effective_from` - `immediately` or `next_billing_period`
+
+### Price Billing Cycle
+- `interval` - `day`, `week`, `month`, `year`
+- `frequency` - Number of intervals between billings
+
+### Tax Categories
+- `standard` - Standard tax rate
+- `digital-goods` - Digital goods tax rate
+- `saas` - SaaS-specific tax rate
+
+## When to Use
+
+- Managing SaaS subscription billing with tax compliance
+- Creating products and pricing tiers
+- Processing refunds and adjustments
+- Handling subscription lifecycle (create, pause, cancel, resume)
+- Global tax handling as merchant of record
+- Discount and coupon management for promotions
+
+## Rate Limits
+
+- 100 requests per minute
+- Applies across all endpoints
+- HTTP 429 returned when exceeded
+
+## Relevant Skills
+
+- pricing-page
+- saas-metrics
+- churn-reduction
+- launch-sequence
+- monetization-strategy