arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,150 @@
+# Salesforce
+
+Enterprise CRM platform for sales, service, and marketing.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API, SOAP API, Bulk API |
+| MCP | - | Not available |
+| CLI | ✓ | Salesforce CLI (`sf`) |
+| SDK | ✓ | JSforce, simple-salesforce, etc. |
+
+## Authentication
+
+- **Type**: OAuth 2.0 (Web Server Flow or JWT Bearer)
+- **Header**: `Authorization: Bearer {access_token}`
+- **Instance URL**: Use instance_url from auth response
+
+## Common Agent Operations
+
+### Query records (SOQL)
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/query?q=SELECT+Id,Name,Email+FROM+Contact+LIMIT+10
+
+Authorization: Bearer {access_token}
+```
+
+### Get record by ID
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/{record_id}
+
+Authorization: Bearer {access_token}
+```
+
+### Create record
+
+```bash
+POST https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact
+
+{
+  "FirstName": "John",
+  "LastName": "Doe",
+  "Email": "john@example.com",
+  "AccountId": "{account_id}"
+}
+```
+
+### Update record
+
+```bash
+PATCH https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/{record_id}
+
+{
+  "Title": "Senior Developer"
+}
+```
+
+### Search records (SOSL)
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/search?q=FIND+{searchTerm}+IN+ALL+FIELDS+RETURNING+Contact(Id,Name,Email)
+
+Authorization: Bearer {access_token}
+```
+
+### Get opportunities
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/query?q=SELECT+Id,Name,Amount,StageName,CloseDate+FROM+Opportunity+WHERE+IsClosed=false
+
+Authorization: Bearer {access_token}
+```
+
+### Describe object
+
+```bash
+GET https://{instance}.salesforce.com/services/data/v59.0/sobjects/Contact/describe
+
+Authorization: Bearer {access_token}
+```
+
+## CLI Commands
+
+```bash
+# Authenticate
+sf org login web
+
+# Query records
+sf data query --query "SELECT Id, Name FROM Account LIMIT 10"
+
+# Create record
+sf data create record --sobject Account --values "Name='New Account'"
+
+# Deploy metadata
+sf project deploy start
+
+# Run Apex
+sf apex run --file script.apex
+```
+
+## SOQL Examples
+
+```sql
+-- Get contacts with accounts
+SELECT Id, Name, Email, Account.Name
+FROM Contact
+WHERE Account.Industry = 'Technology'
+
+-- Get opportunities by stage
+SELECT StageName, COUNT(Id)
+FROM Opportunity
+GROUP BY StageName
+
+-- Get recent leads
+SELECT Id, Name, Company, Status
+FROM Lead
+WHERE CreatedDate = LAST_N_DAYS:30
+ORDER BY CreatedDate DESC
+```
+
+## Key Objects
+
+- **Lead** - Potential customer
+- **Contact** - Person at account
+- **Account** - Company/organization
+- **Opportunity** - Sales deal
+- **Case** - Support ticket
+- **Campaign** - Marketing campaign
+
+## When to Use
+
+- Enterprise CRM operations
+- Complex sales processes
+- Multi-object relationships
+- Custom object management
+- Marketing campaign tracking
+
+## Rate Limits
+
+- 15,000 API calls per 24 hours (Enterprise)
+- Higher limits available
+
+## Relevant Skills
+
+- emails
+- analytics
+- ads

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

@@ -0,0 +1,148 @@
+# Sanity
+
+Headless CMS with real-time collaboration, GROQ query language, and schema-as-code.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | GROQ queries, Mutations API, Assets API |
+| MCP | - | No official MCP server |
+| CLI | ✓ | `sanity` CLI for studio, datasets, deployment |
+| SDK | ✓ | `@sanity/client`, `next-sanity`, `@sanity/image-url` |
+
+## Authentication
+
+- **Type**: API Token (Bearer)
+- **Header**: `Authorization: Bearer skXXXXXX`
+- **Tokens**: Create in Sanity Manage → API → Tokens
+- **Permissions**: Read-only or Read+Write per token
+
+## Common Agent Operations
+
+### Query documents (GROQ)
+
+URL-encode the `query` parameter value in practice.
+
+```bash
+GET https://{projectId}.api.sanity.io/v2024-01-01/data/query/{dataset}?query=*[_type == "post"]{title, slug, publishedAt}
+```
+
+### Query with parameters
+
+```bash
+GET https://{projectId}.api.sanity.io/v2024-01-01/data/query/{dataset}?query=*[_type == "post" && slug.current == $slug][0]&$slug="my-post"
+```
+
+### Get document by ID
+
+```bash
+GET https://{projectId}.api.sanity.io/v2024-01-01/data/doc/{dataset}/{documentId}
+```
+
+### Create document (Mutations API)
+
+```bash
+POST https://{projectId}.api.sanity.io/v2024-01-01/data/mutate/{dataset}
+
+{
+  "mutations": [
+    {
+      "create": {
+        "_type": "post",
+        "title": "New Post",
+        "slug": {"_type": "slug", "current": "new-post"},
+        "body": [{"_type": "block", "children": [{"_type": "span", "text": "Hello"}]}]
+      }
+    }
+  ]
+}
+```
+
+Use `createOrReplace` instead if you want to upsert (requires `_id` field).
+
+### Delete document
+
+```bash
+POST https://{projectId}.api.sanity.io/v2024-01-01/data/mutate/{dataset}
+
+{
+  "mutations": [
+    {"delete": {"id": "document-id"}}
+  ]
+}
+```
+
+### Patch document
+
+```bash
+POST https://{projectId}.api.sanity.io/v2024-01-01/data/mutate/{dataset}
+
+{
+  "mutations": [
+    {
+      "patch": {
+        "id": "document-id",
+        "set": {"title": "Updated Title"}
+      }
+    }
+  ]
+}
+```
+
+## CLI Commands
+
+```bash
+# Create a new Sanity project
+sanity init
+
+# Start the studio locally
+sanity dev
+
+# Deploy studio to Sanity hosting
+sanity deploy
+
+# Export dataset
+sanity dataset export production ./backup.tar.gz
+
+# Import dataset
+sanity dataset import ./data.ndjson production
+
+# List datasets
+sanity dataset list
+
+# Run a GROQ query
+sanity documents query '*[_type == "post"][0..9]{title, slug}'
+```
+
+## Key Objects
+
+- **Document** — Top-level content item with `_id`, `_type`, `_rev`
+- **Asset** — Images and files stored in Sanity CDN
+- **Reference** — Link between documents (`{_type: "reference", _ref: "doc-id"}`)
+- **Portable Text** — Rich text as structured array of blocks
+- **Dataset** — Isolated content database (e.g., `production`, `staging`)
+- **Slug** — URL-friendly identifier (`{_type: "slug", current: "my-slug"}`)
+
+## When to Use
+
+- Structured content for marketing sites and blogs
+- Multi-channel content delivery (web, mobile, email)
+- Real-time collaborative editing workflows
+- Content-heavy sites with complex models
+- Next.js or React-based frontends
+
+## Rate Limits
+
+Rate limits vary by plan. Documented defaults:
+
+- CDN API (queries): High throughput, globally distributed (no hard per-second cap published)
+- API (without CDN): Rate-limited per project (varies by plan)
+- Mutations: Rate-limited per project (varies by plan)
+- See [Sanity technical limits](https://www.sanity.io/docs/technical-limits) for current values
+
+## Relevant Skills
+
+- content-strategy (CMS selection, content modeling)
+- programmatic-seo (CMS as data source for generated pages)
+- site-architecture (URL structure from CMS slugs)

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

@@ -0,0 +1,181 @@
+# SavvyCal
+
+Scheduling platform API for managing scheduling links, events, availability slots, and webhooks.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v1 - scheduling links, events, webhooks |
+| MCP | - | Not available |
+| CLI | ✓ | [savvycal.js](../clis/savvycal.js) |
+| SDK | - | No official SDK |
+
+## Authentication
+
+- **Type**: Bearer Token (Personal Access Token or OAuth 2.0)
+- **Header**: `Authorization: Bearer {token}`
+- **Get key**: Developer Settings in SavvyCal dashboard (create a Personal Access Token)
+
+## Common Agent Operations
+
+### Get current user
+
+```bash
+GET https://api.savvycal.com/v1/me
+```
+
+### List scheduling links
+
+```bash
+GET https://api.savvycal.com/v1/scheduling-links
+```
+
+### Get a scheduling link
+
+```bash
+GET https://api.savvycal.com/v1/scheduling-links/{id}
+```
+
+### Create a scheduling link
+
+```bash
+POST https://api.savvycal.com/v1/scheduling-links
+
+{
+  "name": "30 Minute Meeting",
+  "slug": "30min",
+  "duration_minutes": 30
+}
+```
+
+### Update a scheduling link
+
+```bash
+PATCH https://api.savvycal.com/v1/scheduling-links/{id}
+
+{
+  "name": "Updated Meeting Name"
+}
+```
+
+### Delete a scheduling link
+
+```bash
+DELETE https://api.savvycal.com/v1/scheduling-links/{id}
+```
+
+### Duplicate a scheduling link
+
+```bash
+POST https://api.savvycal.com/v1/scheduling-links/{id}/duplicate
+```
+
+### Toggle link state (active/disabled)
+
+```bash
+POST https://api.savvycal.com/v1/scheduling-links/{id}/toggle
+```
+
+### Get available time slots
+
+```bash
+GET https://api.savvycal.com/v1/scheduling-links/{id}/slots
+```
+
+### List events
+
+```bash
+GET https://api.savvycal.com/v1/events
+```
+
+### Get an event
+
+```bash
+GET https://api.savvycal.com/v1/events/{id}
+```
+
+### Create an event
+
+```bash
+POST https://api.savvycal.com/v1/events
+
+{
+  "scheduling_link_id": "{link_id}",
+  "start_at": "2024-01-20T10:00:00Z",
+  "name": "John Doe",
+  "email": "john@example.com"
+}
+```
+
+### Cancel an event
+
+```bash
+POST https://api.savvycal.com/v1/events/{id}/cancel
+```
+
+### List webhooks
+
+```bash
+GET https://api.savvycal.com/v1/webhooks
+```
+
+### Create a webhook
+
+```bash
+POST https://api.savvycal.com/v1/webhooks
+
+{
+  "url": "https://example.com/webhook",
+  "events": ["event.created", "event.canceled"]
+}
+```
+
+## Key Metrics
+
+### Scheduling Link Data
+- `id` - Unique link identifier
+- `name` - Display name
+- `slug` - URL slug
+- `duration_minutes` - Meeting duration
+- `state` - Active or disabled
+- `url` - Full scheduling URL
+
+### Event Data
+- `id` - Unique event identifier
+- `name` - Invitee name
+- `email` - Invitee email
+- `start_at` / `end_at` - Event timing
+- `status` - Event status
+- `scheduling_link` - Associated scheduling link
+
+## Parameters
+
+### List Events
+- `before` / `after` - Pagination cursors
+- `limit` - Results per page (default 20, max 100)
+
+### List Scheduling Links
+- `before` / `after` - Pagination cursors
+- `limit` - Results per page
+
+## When to Use
+
+- Managing scheduling links programmatically
+- Retrieving booked events for CRM or analytics sync
+- Checking available time slots for custom booking UIs
+- Automating scheduling link creation for campaigns
+- Monitoring booking activity via webhooks
+
+## Rate Limits
+
+- Not officially documented
+- Implement retry logic with exponential backoff
+- Monitor for HTTP 429 responses
+
+## Relevant Skills
+
+- lead-generation
+- sales-automation
+- appointment-scheduling
+- customer-onboarding

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

@@ -0,0 +1,159 @@
+# Segment
+
+Customer data platform for collecting, routing, and activating user data.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Tracking API, Profile API, Config API |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | ✓ | analytics.js, iOS, Android, server libraries |
+
+## Authentication
+
+- **Tracking**: Write Key (per source)
+- **API**: Access Token (OAuth 2.0)
+- **Header**: `Authorization: Bearer {access_token}`
+
+## Common Agent Operations
+
+### Track event
+
+```bash
+POST https://api.segment.io/v1/track
+
+Authorization: Basic {base64(write_key:)}
+
+{
+  "userId": "user_123",
+  "event": "signup_completed",
+  "properties": {
+    "plan": "pro",
+    "method": "email"
+  }
+}
+```
+
+### Identify user
+
+```bash
+POST https://api.segment.io/v1/identify
+
+Authorization: Basic {base64(write_key:)}
+
+{
+  "userId": "user_123",
+  "traits": {
+    "email": "user@example.com",
+    "name": "John Doe",
+    "plan": "pro"
+  }
+}
+```
+
+### Track page view
+
+```bash
+POST https://api.segment.io/v1/page
+
+Authorization: Basic {base64(write_key:)}
+
+{
+  "userId": "user_123",
+  "name": "Pricing",
+  "properties": {
+    "title": "Pricing - Example",
+    "url": "https://example.com/pricing"
+  }
+}
+```
+
+### Batch events
+
+```bash
+POST https://api.segment.io/v1/batch
+
+Authorization: Basic {base64(write_key:)}
+
+{
+  "batch": [
+    {"type": "identify", "userId": "user_1", "traits": {"plan": "free"}},
+    {"type": "track", "userId": "user_1", "event": "signup"}
+  ]
+}
+```
+
+### Get user profile (Profile API)
+
+```bash
+GET https://profiles.segment.com/v1/spaces/{space_id}/collections/users/profiles/user_id:{user_id}/traits
+
+Authorization: Basic {base64(access_token:)}
+```
+
+### Get user events
+
+```bash
+GET https://profiles.segment.com/v1/spaces/{space_id}/collections/users/profiles/user_id:{user_id}/events
+
+Authorization: Basic {base64(access_token:)}
+```
+
+## JavaScript SDK
+
+```javascript
+// Initialize
+analytics.load('WRITE_KEY');
+
+// Identify user
+analytics.identify('user_123', {
+  email: 'user@example.com',
+  plan: 'pro'
+});
+
+// Track event
+analytics.track('Feature Used', {
+  feature_name: 'export'
+});
+
+// Page view
+analytics.page('Pricing');
+```
+
+## Key Concepts
+
+- **Sources** - Where data comes from (website, app, server)
+- **Destinations** - Where data goes (analytics, CRM, ads)
+- **Tracking Plan** - Schema for events and properties
+- **Protocols** - Data governance and validation
+- **Personas** - Unified user profiles
+- **Audiences** - Computed user segments
+
+## Common Destinations
+
+- Analytics: GA4, Mixpanel, Amplitude
+- CRM: HubSpot, Salesforce
+- Email: Customer.io, Mailchimp
+- Ads: Google Ads, Meta
+- Data Warehouse: BigQuery, Snowflake
+
+## When to Use
+
+- Centralizing event tracking
+- Routing data to multiple tools
+- Maintaining consistent tracking
+- Building unified user profiles
+- Syncing audiences across platforms
+
+## Rate Limits
+
+- 500 requests/second per source
+- Batch up to 500KB or 32KB per event
+
+## Relevant Skills
+
+- analytics
+- emails
+- ads