arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,142 @@
+# Ahrefs
+
+SEO toolset for backlink analysis, keyword research, and competitive research.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for Site Explorer, Keywords Explorer |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: API Token
+- **Header**: `Authorization: Bearer {api_token}`
+- **Get token**: Account Settings > API in Ahrefs dashboard
+
+## Common Agent Operations
+
+### Domain rating
+
+```bash
+GET https://api.ahrefs.com/v3/site-explorer/domain-rating?target=example.com
+
+Authorization: Bearer {api_token}
+```
+
+### Backlinks overview
+
+```bash
+GET https://api.ahrefs.com/v3/site-explorer/backlinks-stats?target=example.com&mode=domain
+
+Authorization: Bearer {api_token}
+```
+
+### Referring domains
+
+```bash
+GET https://api.ahrefs.com/v3/site-explorer/refdomains?target=example.com&mode=domain&limit=100
+
+Authorization: Bearer {api_token}
+```
+
+### Backlinks list
+
+```bash
+GET https://api.ahrefs.com/v3/site-explorer/backlinks?target=example.com&mode=domain&limit=100
+
+Authorization: Bearer {api_token}
+```
+
+### Organic keywords
+
+```bash
+GET https://api.ahrefs.com/v3/site-explorer/organic-keywords?target=example.com&mode=domain&country=us&limit=100
+
+Authorization: Bearer {api_token}
+```
+
+### Top pages
+
+```bash
+GET https://api.ahrefs.com/v3/site-explorer/top-pages?target=example.com&mode=domain&country=us&limit=50
+
+Authorization: Bearer {api_token}
+```
+
+### Keyword overview
+
+```bash
+GET https://api.ahrefs.com/v3/keywords-explorer/overview?keywords=keyword1,keyword2&country=us
+
+Authorization: Bearer {api_token}
+```
+
+### Keyword suggestions
+
+```bash
+GET https://api.ahrefs.com/v3/keywords-explorer/matching-terms?keyword=seed+keyword&country=us&limit=100
+
+Authorization: Bearer {api_token}
+```
+
+### SERP overview
+
+```bash
+GET https://api.ahrefs.com/v3/keywords-explorer/serp-overview?keyword=target+keyword&country=us
+
+Authorization: Bearer {api_token}
+```
+
+## Key Metrics
+
+### Domain Metrics
+- `domain_rating` - Domain Rating (DR)
+- `ahrefs_rank` - Ahrefs Rank
+- `referring_domains` - Referring domains count
+- `backlinks` - Total backlinks
+- `organic_traffic` - Estimated organic traffic
+
+### Keyword Metrics
+- `volume` - Monthly search volume
+- `keyword_difficulty` - KD score (0-100)
+- `cpc` - Cost per click
+- `clicks` - Estimated monthly clicks
+- `global_volume` - Global search volume
+
+### Backlink Fields
+- `url_from` - Source URL
+- `url_to` - Target URL
+- `anchor` - Anchor text
+- `domain_rating_source` - Source DR
+- `first_seen` - First discovery date
+
+## Modes
+
+- `domain` - Entire domain
+- `subdomains` - Domain + subdomains
+- `prefix` - URL prefix
+- `exact` - Exact URL
+
+## When to Use
+
+- Backlink analysis
+- Link building research
+- Keyword research
+- Competitive analysis
+- Content gap analysis
+- Site audits
+
+## Rate Limits
+
+- Varies by plan
+- 500-5000 rows per request
+
+## Relevant Skills
+
+- seo-audit
+- content-strategy
+- competitors

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

@@ -0,0 +1,128 @@
+# AirOps
+
+AI content platform for crafting content that wins AI search. Build and execute AI workflows (flows) for SEO content generation, data enrichment, and automation.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Flows, Workflows, Runs |
+| MCP | - | Not available |
+| CLI | ✓ | [airops.js](../clis/airops.js) |
+| SDK | - | REST API only |
+
+## Authentication
+
+- **Type**: API Key + Workspace ID
+- **Header**: `Authorization: Bearer {api_key}`
+- **Env vars**: `AIROPS_API_KEY`, `AIROPS_WORKSPACE_ID`
+- **Get key**: Settings > API Keys at https://app.airops.com
+
+## Common Agent Operations
+
+### List Flows
+
+```bash
+GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows
+```
+
+### Get Flow Details
+
+```bash
+GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows/{flow_id}
+```
+
+### Execute a Flow
+
+```bash
+POST https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows/{flow_id}/execute
+
+{
+  "inputs": {
+    "keyword": "best project management tools",
+    "target_audience": "startup founders"
+  }
+}
+```
+
+### List Runs for a Flow
+
+```bash
+GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows/{flow_id}/runs
+```
+
+### Get Run Status
+
+```bash
+GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/runs/{run_id}
+```
+
+### List Workflows
+
+```bash
+GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/workflows
+```
+
+### Execute a Workflow
+
+```bash
+POST https://api.airops.com/public_api/v1/workspaces/{workspace_id}/workflows/{workflow_id}/execute
+
+{
+  "inputs": {
+    "topic": "email marketing best practices",
+    "content_type": "blog_post"
+  }
+}
+```
+
+## Key Metrics
+
+### Flow Data
+- `id` - Flow identifier
+- `name` - Flow name
+- `description` - Flow description
+- `status` - Active/inactive status
+- `created_at` - Creation timestamp
+- `updated_at` - Last modified timestamp
+
+### Run Data
+- `id` - Run identifier
+- `flow_id` - Parent flow ID
+- `status` - pending, running, completed, failed
+- `inputs` - Input parameters used
+- `outputs` - Generated results
+- `started_at` - Run start time
+- `completed_at` - Run completion time
+
+## Parameters
+
+### Flow Execution
+- `inputs` - JSON object of key-value pairs matching the flow's expected inputs
+- Input keys vary per flow (e.g., `keyword`, `topic`, `url`, `target_audience`)
+
+### Workflow Execution
+- `inputs` - JSON object of key-value pairs matching the workflow's expected inputs
+
+## When to Use
+
+- Bulk content generation for SEO at scale
+- SEO-optimized article creation with AI workflows
+- Data enrichment pipelines for marketing lists
+- Keyword research automation
+- Content optimization and rewriting
+- Programmatic SEO page generation
+- AI-powered content briefs and outlines
+
+## Rate Limits
+
+- Rate limits vary by plan
+- Concurrent execution limits depend on workspace tier
+- Check AirOps dashboard for current usage and limits
+
+## Relevant Skills
+
+- ai-seo
+- content-strategy
+- programmatic-seo
+- copywriting

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

@@ -0,0 +1,135 @@
+# Amplitude
+
+Product analytics platform for user behavior, retention, and experimentation.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | HTTP API for events, User Profile API, Export API |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | ✓ | JavaScript, iOS, Android, Python, etc. |
+
+## Authentication
+
+- **HTTP API**: API Key (public for events)
+- **Export/Dashboard API**: API Key + Secret Key
+
+## Common Agent Operations
+
+### Track event
+
+```bash
+POST https://api2.amplitude.com/2/httpapi
+
+{
+  "api_key": "{api_key}",
+  "events": [{
+    "user_id": "user_123",
+    "event_type": "signup_completed",
+    "event_properties": {
+      "plan": "pro"
+    },
+    "user_properties": {
+      "email": "user@example.com"
+    }
+  }]
+}
+```
+
+### Batch events
+
+```bash
+POST https://api2.amplitude.com/batch
+
+{
+  "api_key": "{api_key}",
+  "events": [
+    {"user_id": "user_1", "event_type": "pageview"},
+    {"user_id": "user_2", "event_type": "signup"}
+  ]
+}
+```
+
+### Get user activity
+
+```bash
+GET https://amplitude.com/api/2/useractivity?user={user_id}
+
+Authorization: Basic {base64(api_key:secret_key)}
+```
+
+### Export events
+
+```bash
+GET https://amplitude.com/api/2/export?start=20240101T00&end=20240131T23
+
+Authorization: Basic {base64(api_key:secret_key)}
+```
+
+### Get retention data
+
+```bash
+GET https://amplitude.com/api/2/retention?e={"event_type":"signup_completed"}&start=20240101&end=20240131
+
+Authorization: Basic {base64(api_key:secret_key)}
+```
+
+### Query with SQL (Snowflake)
+
+For Amplitude customers with SQL access:
+```sql
+SELECT event_type, COUNT(*) as count
+FROM events
+WHERE event_time > '2024-01-01'
+GROUP BY event_type
+```
+
+## JavaScript SDK
+
+```javascript
+// Initialize
+amplitude.init('API_KEY');
+
+// Identify user
+amplitude.setUserId('user_123');
+
+// Set user properties
+const identify = new amplitude.Identify();
+identify.set('plan', 'pro');
+amplitude.identify(identify);
+
+// Track event
+amplitude.track('Feature Used', {
+  feature_name: 'export'
+});
+```
+
+## Key Concepts
+
+- **Events** - User actions with properties
+- **User Properties** - Persistent user attributes
+- **Cohorts** - Behavioral segments
+- **Funnels** - Multi-step conversion analysis
+- **Retention** - User return patterns
+- **Journeys** - User path analysis
+
+## When to Use
+
+- Tracking product analytics
+- Analyzing user funnels
+- Cohort analysis and retention
+- Experimentation and A/B testing
+- User journey mapping
+
+## Rate Limits
+
+- HTTP API: 1000 events/second
+- Export API: 360 requests/hour
+
+## Relevant Skills
+
+- analytics
+- ab-testing
+- onboarding

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

@@ -0,0 +1,148 @@
+# Apollo.io
+
+B2B prospecting and data enrichment platform with 210M+ contacts and 35M+ companies for sales intelligence.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | People Search, Company Search, Enrichment, Sequences |
+| MCP | - | Not available |
+| CLI | ✓ | [apollo.js](../clis/apollo.js) |
+| SDK | - | REST API only |
+
+## Authentication
+
+- **Type**: API Key
+- **Header**: `x-api-key: {api_key}` or `Authorization: Bearer {token}`
+- **Get key**: Settings > Integrations > API at https://app.apollo.io
+
+## Common Agent Operations
+
+### People Search
+
+```bash
+POST https://api.apollo.io/api/v1/mixed_people/api_search
+
+{
+  "person_titles": ["Sales Manager"],
+  "person_locations": ["United States"],
+  "organization_num_employees_ranges": ["1,100"],
+  "page": 1
+}
+```
+
+### Person Enrichment
+
+```bash
+POST https://api.apollo.io/api/v1/people/match
+
+{
+  "first_name": "Tim",
+  "last_name": "Zheng",
+  "domain": "apollo.io"
+}
+```
+
+### Bulk People Enrichment
+
+```bash
+POST https://api.apollo.io/api/v1/people/bulk_match
+
+{
+  "details": [
+    { "email": "tim@apollo.io" },
+    { "first_name": "Jane", "last_name": "Doe", "domain": "example.com" }
+  ]
+}
+```
+
+### Organization Search
+
+```bash
+POST https://api.apollo.io/api/v1/mixed_companies/search
+
+{
+  "organization_locations": ["United States"],
+  "organization_num_employees_ranges": ["1,100"],
+  "page": 1
+}
+```
+
+### Organization Enrichment
+
+```bash
+POST https://api.apollo.io/api/v1/organizations/enrich
+
+{
+  "domain": "apollo.io"
+}
+```
+
+## Key Metrics
+
+### Person Data
+- `first_name`, `last_name` - Name
+- `title` - Job title
+- `email` - Verified email
+- `linkedin_url` - LinkedIn profile
+- `organization` - Company details
+- `seniority` - Seniority level
+- `departments` - Department list
+
+### Organization Data
+- `name` - Company name
+- `website_url` - Website
+- `estimated_num_employees` - Employee count
+- `industry` - Industry
+- `annual_revenue` - Revenue
+- `technologies` - Tech stack
+- `funding_total` - Total funding
+
+## Parameters
+
+### People Search
+- `person_titles` - Array of job titles
+- `person_locations` - Array of locations
+- `person_seniorities` - Array: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry
+- `organization_num_employees_ranges` - Array of ranges (e.g., "1,100")
+- `organization_ids` - Filter by Apollo org IDs
+- `page` - Page number (default: 1)
+- `per_page` - Results per page (default: 25, max: 100)
+
+### Person Enrichment
+- `email` - Email address
+- `first_name` + `last_name` + `domain` - Alternative lookup
+- `linkedin_url` - LinkedIn URL
+- `reveal_personal_emails` - Include personal emails
+- `reveal_phone_number` - Include phone numbers
+
+### Organization Search
+- `organization_locations` - Array of locations
+- `organization_num_employees_ranges` - Employee count ranges
+- `organization_ids` - Specific org IDs
+- `page` - Page number
+
+## When to Use
+
+- Building targeted prospect lists by role, seniority, and company size
+- Enriching leads with verified contact info
+- Finding decision-makers at target accounts
+- Company research and firmographic analysis
+- ABM campaign targeting
+- Sales intelligence and outbound prospecting
+
+## Rate Limits
+
+- Rate limits vary by plan
+- Standard: 100 requests/minute for most endpoints
+- Bulk enrichment: up to 10 people per request
+- Search: max 50,000 records (100 per page, 500 pages)
+
+## Relevant Skills
+
+- abm-strategy
+- lead-enrichment
+- lead-scoring
+- cold-email
+- competitors

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

@@ -0,0 +1,152 @@
+# Attentive
+
+Full-service SMS marketing platform for mid-market and enterprise direct-to-consumer brands. Combines tooling with dedicated success teams.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API |
+| MCP | - | Not available |
+| CLI | - | None |
+| SDK | - | Use API directly |
+
+## Authentication
+
+- **Type**: OAuth 2.0 or API Key (depending on integration type)
+- **Header**: `Authorization: Bearer {access_token}`
+- **Get credentials**: Account-level provisioning through Attentive integrations team
+- **Note**: API access requires partnership or eligible plan
+
+## Common Agent Operations
+
+### Subscribe a user
+
+```bash
+POST https://api.attentivemobile.com/v1/subscriptions
+
+{
+  "user": {
+    "phone": "+15551234567",
+    "email": "user@example.com"
+  },
+  "signUpSourceId": "...",
+  "subscriptionType": "MARKETING"
+}
+```
+
+Sign-up source ID determines opt-in attribution and compliance disclosure shown.
+
+### Unsubscribe
+
+```bash
+POST https://api.attentivemobile.com/v1/subscriptions/unsubscribe
+
+{
+  "user": { "phone": "+15551234567" },
+  "subscriptionType": "MARKETING"
+}
+```
+
+### Custom event tracking
+
+```bash
+POST https://api.attentivemobile.com/v1/events/custom
+
+{
+  "user": { "phone": "+15551234567" },
+  "type": "abandoned_cart",
+  "properties": {
+    "cart_value": 89.99,
+    "items": ["Product A"]
+  }
+}
+```
+
+### E-commerce events (purchase, add-to-cart, product view)
+
+```bash
+POST https://api.attentivemobile.com/v1/events/ecommerce/purchase
+
+{
+  "user": { "phone": "+15551234567" },
+  "items": [{
+    "productId": "SKU-123",
+    "name": "Product A",
+    "price": { "value": 4999, "currency": "USD" },
+    "quantity": 1
+  }],
+  "occurredAt": "2026-05-15T10:00:00Z"
+}
+```
+
+Similar endpoints for `/add_to_cart`, `/product_view`, `/checkout`.
+
+### Send transactional message
+
+```bash
+POST https://api.attentivemobile.com/v1/messages/transactional
+
+{
+  "user": { "phone": "+15551234567" },
+  "messageBody": "Your order #1234 shipped. Track: https://...",
+  "type": "ORDER_SHIPPING"
+}
+```
+
+### List campaigns
+
+```bash
+GET https://api.attentivemobile.com/v1/campaigns
+```
+
+### Webhooks
+
+Subscribe to: `subscriber.created`, `subscriber.unsubscribed`, `message.sent`, `message.delivered`, `message.failed`, `conversion.attributed`.
+
+## API Pattern
+
+REST + JSON. Bearer auth. Webhook signature verification via HMAC-SHA256.
+
+## Key Features
+
+- Concierge sales (live agents responding via SMS)
+- Identity resolution (matching anonymous site visitors to phone numbers for retargeting)
+- Strong analytics + attribution (multi-touch, conversion path)
+- AI Journey AI / Pro AI (AI-generated send timing and copy)
+- Custom Audience Manager (advanced segmentation)
+- A/B testing built into campaign builder
+- Two-way SMS at scale
+- A2P 10DLC fully managed
+- Short code provisioning included on most plans
+- Dedicated CSM, copy support, strategy consults
+
+## Pricing
+
+- Custom contracts; typically $1K–$10K+/mo platform fee + per-send fees
+- Annual contracts standard
+- Pricing rarely makes sense for <50K active SMS subscribers
+- Negotiable based on volume and tier
+
+## When to Use
+
+- Mid-market+ DTC brand (50K+ active SMS subscribers, $5M+/yr revenue)
+- Want dedicated CSM and copy support, not just tooling
+- Need concierge two-way SMS at scale
+- Multi-channel ecom team that wants single-pane SMS-first platform
+- Want short code included rather than separately leased
+- Identity resolution / cross-device matching matters
+
+## When NOT to Use
+
+- Smaller brands — too expensive, overkill
+- Already on Klaviyo and SMS is secondary — Klaviyo SMS is simpler
+- Shopify-only and want depth — Postscript is more Shopify-native
+- Custom platform / B2B SaaS — Twilio
+
+## Relevant Skills
+
+- sms
+- emails (run alongside)
+- churn-prevention
+- customer-research (identity resolution data)