claude-flow-novice 2.15.0 → 2.15.1

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-analytics-data/SKILL.md

@@ -0,0 +1,124 @@
+# CFN Marketing Analytics Data Skill
+
+## Purpose
+Retrieve marketing analytics data through n8n workflow integration. Access website traffic, social engagement, email performance, ad performance, and conversion funnel metrics.
+
+## Operations
+
+### 1. get-website-traffic.sh
+Retrieve website traffic analytics.
+
+**Parameters:**
+- `--start-date` (required): Start date (YYYY-MM-DD)
+- `--end-date` (required): End date (YYYY-MM-DD)
+- `--metrics` (optional): Comma-separated metrics (pageviews,sessions,users,bounceRate)
+- `--dimensions` (optional): Comma-separated dimensions (page,source,device)
+
+**Example:**
+```bash
+./operations/get-website-traffic.sh \
+  --start-date "2025-10-01" \
+  --end-date "2025-10-31" \
+  --metrics "pageviews,sessions,users" \
+  --dimensions "page,source"
+```
+
+### 2. get-social-engagement.sh
+Retrieve social media engagement metrics.
+
+**Parameters:**
+- `--start-date` (required): Start date (YYYY-MM-DD)
+- `--end-date` (required): End date (YYYY-MM-DD)
+- `--platforms` (optional): Comma-separated platforms (facebook,twitter,linkedin,instagram)
+- `--metrics` (optional): Comma-separated metrics (likes,shares,comments,reach)
+
+**Example:**
+```bash
+./operations/get-social-engagement.sh \
+  --start-date "2025-10-01" \
+  --end-date "2025-10-31" \
+  --platforms "facebook,linkedin" \
+  --metrics "likes,shares,comments"
+```
+
+### 3. get-email-performance.sh
+Retrieve email campaign performance metrics.
+
+**Parameters:**
+- `--start-date` (required): Start date (YYYY-MM-DD)
+- `--end-date` (required): End date (YYYY-MM-DD)
+- `--campaign-ids` (optional): Comma-separated campaign IDs
+- `--metrics` (optional): Comma-separated metrics (opens,clicks,bounces,unsubscribes)
+
+**Example:**
+```bash
+./operations/get-email-performance.sh \
+  --start-date "2025-10-01" \
+  --end-date "2025-10-31" \
+  --campaign-ids "campaign-123,campaign-456" \
+  --metrics "opens,clicks"
+```
+
+### 4. get-ad-performance.sh
+Retrieve advertising campaign performance metrics.
+
+**Parameters:**
+- `--start-date` (required): Start date (YYYY-MM-DD)
+- `--end-date` (required): End date (YYYY-MM-DD)
+- `--platforms` (optional): Comma-separated platforms (google,facebook,linkedin)
+- `--metrics` (optional): Comma-separated metrics (impressions,clicks,conversions,spend)
+
+**Example:**
+```bash
+./operations/get-ad-performance.sh \
+  --start-date "2025-10-01" \
+  --end-date "2025-10-31" \
+  --platforms "google,facebook" \
+  --metrics "impressions,clicks,conversions,spend"
+```
+
+### 5. get-conversion-funnel.sh
+Retrieve conversion funnel analytics.
+
+**Parameters:**
+- `--start-date` (required): Start date (YYYY-MM-DD)
+- `--end-date` (required): End date (YYYY-MM-DD)
+- `--funnel-id` (optional): Specific funnel identifier
+- `--segment` (optional): Customer segment filter
+
+**Example:**
+```bash
+./operations/get-conversion-funnel.sh \
+  --start-date "2025-10-01" \
+  --end-date "2025-10-31" \
+  --funnel-id "signup-flow" \
+  --segment "new-visitors"
+```
+
+## N8N Integration
+
+All operations invoke n8n workflows via HTTP POST to endpoints configured in `.env`:
+- `N8N_BASE_URL`: Base URL for n8n instance
+- `N8N_API_KEY`: Authentication key
+
+## Error Handling
+
+Scripts return:
+- Exit code 0: Success
+- Exit code 1: Parameter validation error
+- Exit code 2: Network/API error
+- Exit code 3: Authentication error
+
+## Response Format
+
+All operations return JSON with structure:
+```json
+{
+  "success": true,
+  "data": {
+    "metrics": [ ... ],
+    "period": { "start": "...", "end": "..." }
+  },
+  "message": "Operation completed successfully"
+}
+```

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-analytics-data/operations/get-ad-performance.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get advertising campaign performance analytics via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+START_DATE=""
+END_DATE=""
+PLATFORMS=""
+METRICS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --start-date)
+      START_DATE="$2"
+      shift 2
+      ;;
+    --end-date)
+      END_DATE="$2"
+      shift 2
+      ;;
+    --platforms)
+      PLATFORMS="$2"
+      shift 2
+      ;;
+    --metrics)
+      METRICS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$START_DATE" ]]; then
+  echo "Error: --start-date is required" >&2
+  exit 1
+fi
+
+if [[ -z "$END_DATE" ]]; then
+  echo "Error: --end-date is required" >&2
+  exit 1
+fi
+
+if [[ ! "$START_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --start-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+if [[ ! "$END_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --end-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+PLATFORMS_ARRAY=$(if [[ -n "$PLATFORMS" ]]; then echo "$PLATFORMS" | jq -R 'split(",")'; else echo "[]"; fi)
+METRICS_ARRAY=$(if [[ -n "$METRICS" ]]; then echo "$METRICS" | jq -R 'split(",")'; else echo "[]"; fi)
+
+PAYLOAD=$(jq -n \
+  --arg startDate "$START_DATE" \
+  --arg endDate "$END_DATE" \
+  --argjson platforms "$PLATFORMS_ARRAY" \
+  --argjson metrics "$METRICS_ARRAY" \
+  '{
+    startDate: $startDate,
+    endDate: $endDate,
+    platforms: $platforms,
+    metrics: $metrics
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/analytics/ad-performance" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-analytics-data/operations/get-conversion-funnel.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get conversion funnel analytics via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+START_DATE=""
+END_DATE=""
+FUNNEL_ID=""
+SEGMENT=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --start-date)
+      START_DATE="$2"
+      shift 2
+      ;;
+    --end-date)
+      END_DATE="$2"
+      shift 2
+      ;;
+    --funnel-id)
+      FUNNEL_ID="$2"
+      shift 2
+      ;;
+    --segment)
+      SEGMENT="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$START_DATE" ]]; then
+  echo "Error: --start-date is required" >&2
+  exit 1
+fi
+
+if [[ -z "$END_DATE" ]]; then
+  echo "Error: --end-date is required" >&2
+  exit 1
+fi
+
+if [[ ! "$START_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --start-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+if [[ ! "$END_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --end-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg startDate "$START_DATE" \
+  --arg endDate "$END_DATE" \
+  --arg funnelId "$FUNNEL_ID" \
+  --arg segment "$SEGMENT" \
+  '{
+    startDate: $startDate,
+    endDate: $endDate,
+    funnelId: $funnelId,
+    segment: $segment
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/analytics/conversion-funnel" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-analytics-data/operations/get-email-performance.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get email campaign performance analytics via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+START_DATE=""
+END_DATE=""
+CAMPAIGN_IDS=""
+METRICS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --start-date)
+      START_DATE="$2"
+      shift 2
+      ;;
+    --end-date)
+      END_DATE="$2"
+      shift 2
+      ;;
+    --campaign-ids)
+      CAMPAIGN_IDS="$2"
+      shift 2
+      ;;
+    --metrics)
+      METRICS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$START_DATE" ]]; then
+  echo "Error: --start-date is required" >&2
+  exit 1
+fi
+
+if [[ -z "$END_DATE" ]]; then
+  echo "Error: --end-date is required" >&2
+  exit 1
+fi
+
+if [[ ! "$START_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --start-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+if [[ ! "$END_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --end-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+CAMPAIGN_IDS_ARRAY=$(if [[ -n "$CAMPAIGN_IDS" ]]; then echo "$CAMPAIGN_IDS" | jq -R 'split(",")'; else echo "[]"; fi)
+METRICS_ARRAY=$(if [[ -n "$METRICS" ]]; then echo "$METRICS" | jq -R 'split(",")'; else echo "[]"; fi)
+
+PAYLOAD=$(jq -n \
+  --arg startDate "$START_DATE" \
+  --arg endDate "$END_DATE" \
+  --argjson campaignIds "$CAMPAIGN_IDS_ARRAY" \
+  --argjson metrics "$METRICS_ARRAY" \
+  '{
+    startDate: $startDate,
+    endDate: $endDate,
+    campaignIds: $campaignIds,
+    metrics: $metrics
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/analytics/email-performance" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-analytics-data/operations/get-social-engagement.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get social media engagement analytics via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+START_DATE=""
+END_DATE=""
+PLATFORMS=""
+METRICS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --start-date)
+      START_DATE="$2"
+      shift 2
+      ;;
+    --end-date)
+      END_DATE="$2"
+      shift 2
+      ;;
+    --platforms)
+      PLATFORMS="$2"
+      shift 2
+      ;;
+    --metrics)
+      METRICS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$START_DATE" ]]; then
+  echo "Error: --start-date is required" >&2
+  exit 1
+fi
+
+if [[ -z "$END_DATE" ]]; then
+  echo "Error: --end-date is required" >&2
+  exit 1
+fi
+
+if [[ ! "$START_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --start-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+if [[ ! "$END_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --end-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+PLATFORMS_ARRAY=$(if [[ -n "$PLATFORMS" ]]; then echo "$PLATFORMS" | jq -R 'split(",")'; else echo "[]"; fi)
+METRICS_ARRAY=$(if [[ -n "$METRICS" ]]; then echo "$METRICS" | jq -R 'split(",")'; else echo "[]"; fi)
+
+PAYLOAD=$(jq -n \
+  --arg startDate "$START_DATE" \
+  --arg endDate "$END_DATE" \
+  --argjson platforms "$PLATFORMS_ARRAY" \
+  --argjson metrics "$METRICS_ARRAY" \
+  '{
+    startDate: $startDate,
+    endDate: $endDate,
+    platforms: $platforms,
+    metrics: $metrics
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/analytics/social-engagement" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/cfn-extras/skills/marketing/cfn-marketing-analytics-data/operations/get-website-traffic.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+set -euo pipefail
+
+# Get website traffic analytics via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+START_DATE=""
+END_DATE=""
+METRICS=""
+DIMENSIONS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --start-date)
+      START_DATE="$2"
+      shift 2
+      ;;
+    --end-date)
+      END_DATE="$2"
+      shift 2
+      ;;
+    --metrics)
+      METRICS="$2"
+      shift 2
+      ;;
+    --dimensions)
+      DIMENSIONS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$START_DATE" ]]; then
+  echo "Error: --start-date is required" >&2
+  exit 1
+fi
+
+if [[ -z "$END_DATE" ]]; then
+  echo "Error: --end-date is required" >&2
+  exit 1
+fi
+
+# Validate date format (basic check)
+if [[ ! "$START_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --start-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+if [[ ! "$END_DATE" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; then
+  echo "Error: --end-date must be in YYYY-MM-DD format" >&2
+  exit 1
+fi
+
+# Convert comma-separated values to JSON arrays
+METRICS_ARRAY=$(if [[ -n "$METRICS" ]]; then echo "$METRICS" | jq -R 'split(",")'; else echo "[]"; fi)
+DIMENSIONS_ARRAY=$(if [[ -n "$DIMENSIONS" ]]; then echo "$DIMENSIONS" | jq -R 'split(",")'; else echo "[]"; fi)
+
+PAYLOAD=$(jq -n \
+  --arg startDate "$START_DATE" \
+  --arg endDate "$END_DATE" \
+  --argjson metrics "$METRICS_ARRAY" \
+  --argjson dimensions "$DIMENSIONS_ARRAY" \
+  '{
+    startDate: $startDate,
+    endDate: $endDate,
+    metrics: $metrics,
+    dimensions: $dimensions
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/analytics/website-traffic" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi