claude-flow-novice 2.10.5 → 2.10.6

package/claude-assets/skills/cfn-marketing-competitive-intel/SKILL.md

@@ -0,0 +1,350 @@
+# CFN Marketing Competitive Intelligence
+
+**Version:** 1.0.0
+**Status:** Production
+**Phase:** 4 - Intelligence & Optimization
+
+## Overview
+
+Competitive intelligence monitoring skill for tracking competitors, brand mentions, trending topics, backlink profiles, and keyword rankings. Integrates with n8n workflows for data collection from multiple sources (social media, search engines, SEO tools).
+
+## Operations
+
+### 1. Search Brand Mentions
+
+**Script:** `operations/search-brand-mentions.sh`
+
+**Description:** Search for brand mentions across multiple sources (Twitter, Reddit, news sites, blogs)
+
+**Parameters:**
+- `--brand` (required): Brand name to search
+- `--sources` (optional): Comma-separated sources (twitter,reddit,news,blogs). Default: all
+- `--date-from` (optional): Start date (YYYY-MM-DD). Default: 7 days ago
+- `--date-to` (optional): End date (YYYY-MM-DD). Default: today
+- `--sentiment` (optional): Filter by sentiment (positive,negative,neutral). Default: all
+
+**Example:**
+```bash
+./operations/search-brand-mentions.sh \
+  --brand "Acme Corp" \
+  --sources "twitter,reddit" \
+  --date-from "2025-10-22" \
+  --sentiment "negative"
+```
+
+**Response:**
+```json
+{
+  "brand": "Acme Corp",
+  "mentions": [
+    {
+      "source": "twitter",
+      "author": "@user123",
+      "content": "Acme Corp's new product is disappointing...",
+      "url": "https://twitter.com/user123/status/...",
+      "sentiment": "negative",
+      "engagement": {"likes": 45, "shares": 12},
+      "timestamp": "2025-10-22T14:30:00Z"
+    }
+  ],
+  "total_mentions": 127,
+  "sentiment_breakdown": {
+    "positive": 45,
+    "negative": 32,
+    "neutral": 50
+  }
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters
+- `2`: API error
+- `3`: Validation error
+
+---
+
+### 2. Monitor Competitor
+
+**Script:** `operations/monitor-competitor.sh`
+
+**Description:** Track competitor activity including content publishing, ad campaigns, and keyword targeting
+
+**Parameters:**
+- `--competitor` (required): Competitor domain or name
+- `--activity-types` (optional): Comma-separated types (content,ads,keywords). Default: all
+- `--lookback-days` (optional): Days to look back. Default: 30
+
+**Example:**
+```bash
+./operations/monitor-competitor.sh \
+  --competitor "competitor.com" \
+  --activity-types "ads,keywords" \
+  --lookback-days 14
+```
+
+**Response:**
+```json
+{
+  "competitor": "competitor.com",
+  "activity": {
+    "ads": [
+      {
+        "platform": "google_ads",
+        "headline": "Best Product - 50% Off",
+        "description": "Limited time offer...",
+        "landing_page": "https://competitor.com/promo",
+        "first_seen": "2025-10-20T10:00:00Z",
+        "last_seen": "2025-10-28T18:00:00Z",
+        "estimated_budget": "high"
+      }
+    ],
+    "keywords": [
+      {
+        "keyword": "best product 2025",
+        "position": 3,
+        "trend": "rising",
+        "search_volume": 12000
+      }
+    ]
+  },
+  "lookback_period": "14 days"
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (invalid domain, lookback > 90 days)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+### 3. Get Trending Topics
+
+**Script:** `operations/get-trending-topics.sh`
+
+**Description:** Discover trending topics in your industry using social media, news, and search trends
+
+**Parameters:**
+- `--industry` (required): Industry category (tech,finance,healthcare,retail,etc)
+- `--region` (optional): Geographic region (us,uk,ca,global). Default: global
+- `--limit` (optional): Max topics to return. Default: 10, Max: 50
+
+**Example:**
+```bash
+./operations/get-trending-topics.sh \
+  --industry "tech" \
+  --region "us" \
+  --limit 20
+```
+
+**Response:**
+```json
+{
+  "industry": "tech",
+  "region": "us",
+  "topics": [
+    {
+      "topic": "AI chatbots for business",
+      "trend_score": 95,
+      "search_volume": 45000,
+      "growth_rate": "+127%",
+      "sources": ["twitter", "google_trends", "news"],
+      "related_keywords": ["chatbot integration", "AI customer service"],
+      "opportunity_score": 8.7
+    }
+  ],
+  "total_topics": 20,
+  "generated_at": "2025-10-29T12:00:00Z"
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (invalid industry, limit > 50)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+### 4. Get Backlink Profile
+
+**Script:** `operations/get-backlink-profile.sh`
+
+**Description:** Analyze competitor backlink profiles to identify link building opportunities
+
+**Parameters:**
+- `--domain` (required): Target domain to analyze
+- `--limit` (optional): Max backlinks to return. Default: 50, Max: 200
+- `--min-authority` (optional): Minimum domain authority (0-100). Default: 20
+
+**Example:**
+```bash
+./operations/get-backlink-profile.sh \
+  --domain "competitor.com" \
+  --limit 100 \
+  --min-authority 40
+```
+
+**Response:**
+```json
+{
+  "domain": "competitor.com",
+  "backlink_summary": {
+    "total_backlinks": 1547,
+    "referring_domains": 312,
+    "avg_domain_authority": 45.3,
+    "new_backlinks_30d": 47
+  },
+  "top_backlinks": [
+    {
+      "source_url": "https://industry-blog.com/article",
+      "source_domain": "industry-blog.com",
+      "domain_authority": 67,
+      "anchor_text": "best solution",
+      "link_type": "dofollow",
+      "first_seen": "2025-09-15T00:00:00Z"
+    }
+  ],
+  "link_building_opportunities": [
+    {
+      "domain": "tech-review.com",
+      "authority": 72,
+      "reason": "Links to 3 competitors but not you",
+      "contact_email": "editor@tech-review.com"
+    }
+  ]
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (invalid domain, limit > 200, authority > 100)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+### 5. Get Keyword Rankings
+
+**Script:** `operations/get-keyword-rankings.sh`
+
+**Description:** Monitor keyword rankings for your domain vs competitors
+
+**Parameters:**
+- `--domain` (required): Your domain
+- `--keywords` (required): Comma-separated keywords
+- `--competitors` (optional): Comma-separated competitor domains
+- `--search-engine` (optional): Search engine (google,bing). Default: google
+- `--location` (optional): Location code (us,uk,ca). Default: us
+
+**Example:**
+```bash
+./operations/get-keyword-rankings.sh \
+  --domain "example.com" \
+  --keywords "cloud storage,file sharing,secure backup" \
+  --competitors "dropbox.com,box.com" \
+  --location "us"
+```
+
+**Response:**
+```json
+{
+  "domain": "example.com",
+  "rankings": [
+    {
+      "keyword": "cloud storage",
+      "your_position": 7,
+      "your_url": "https://example.com/cloud-storage",
+      "search_volume": 89000,
+      "competitors": [
+        {
+          "domain": "dropbox.com",
+          "position": 2,
+          "url": "https://dropbox.com/features"
+        },
+        {
+          "domain": "box.com",
+          "position": 5,
+          "url": "https://box.com/cloud-storage"
+        }
+      ],
+      "ranking_change_30d": -2,
+      "opportunity_score": 6.8
+    }
+  ],
+  "search_engine": "google",
+  "location": "us",
+  "checked_at": "2025-10-29T12:00:00Z"
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (invalid domain, no keywords)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+## Environment Variables
+
+- `N8N_BASE_URL`: Base URL for n8n instance (e.g., https://n8n.dailyautomations.com)
+- `N8N_API_KEY`: API key for authentication
+
+## Error Handling
+
+All operations return structured JSON error responses:
+
+```json
+{
+  "error": "Description of error",
+  "code": "ERROR_CODE",
+  "details": {}
+}
+```
+
+## Integration Pattern
+
+Each operation calls n8n webhook:
+
+```bash
+curl -X POST "$N8N_BASE_URL/webhook/competitive-intel-{operation}" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d "$PAYLOAD"
+```
+
+## Dependencies
+
+- bash ≥4.0
+- jq (JSON processing)
+- curl (HTTP requests)
+- bc (numeric validation)
+
+## Usage in Workflows
+
+```bash
+# Monitor competitor ads and content
+COMPETITOR_ACTIVITY=$(./.claude/skills/cfn-marketing-competitive-intel/operations/monitor-competitor.sh \
+  --competitor "competitor.com" \
+  --activity-types "ads,content")
+
+# Discover trending topics for content strategy
+TRENDING=$(./.claude/skills/cfn-marketing-competitive-intel/operations/get-trending-topics.sh \
+  --industry "tech" \
+  --limit 10)
+
+# Track brand sentiment
+MENTIONS=$(./.claude/skills/cfn-marketing-competitive-intel/operations/search-brand-mentions.sh \
+  --brand "YourBrand" \
+  --sentiment "negative")
+```
+
+## Maintenance
+
+- Review competitor list monthly
+- Update industry categories quarterly
+- Validate backlink data accuracy weekly
+- Monitor API rate limits and adjust polling frequency

package/claude-assets/skills/cfn-marketing-competitive-intel/operations/get-backlink-profile.sh

@@ -0,0 +1,154 @@
+#!/bin/bash
+# CFN Marketing Competitive Intel - Get Backlink Profile Operation
+# Analyze competitor backlink profiles
+
+set -euo pipefail
+
+# Default values
+LIMIT=50
+MIN_AUTHORITY=20
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --domain)
+      DOMAIN="$2"
+      shift 2
+      ;;
+    --limit)
+      LIMIT="$2"
+      shift 2
+      ;;
+    --min-authority)
+      MIN_AUTHORITY="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${DOMAIN:-}" ]]; then
+  echo '{"error": "Missing required parameter: --domain", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate domain format (basic validation)
+if [[ ! "$DOMAIN" =~ ^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z]{2,})+$ ]]; then
+  echo '{"error": "Invalid domain format for --domain", "code": "INVALID_DOMAIN"}' >&2
+  exit 1
+fi
+
+# Validate limit
+if ! [[ "$LIMIT" =~ ^[0-9]+$ ]]; then
+  echo '{"error": "Limit must be a positive integer", "code": "INVALID_LIMIT"}' >&2
+  exit 1
+fi
+
+if (( LIMIT > 200 )); then
+  echo '{"error": "Limit cannot exceed 200", "code": "LIMIT_TOO_LARGE", "details": {"max": 200, "provided": '"$LIMIT"'}}' >&2
+  exit 1
+fi
+
+if (( LIMIT < 1 )); then
+  echo '{"error": "Limit must be at least 1", "code": "LIMIT_TOO_SMALL"}' >&2
+  exit 1
+fi
+
+# Validate min authority
+if ! [[ "$MIN_AUTHORITY" =~ ^[0-9]+$ ]]; then
+  echo '{"error": "Minimum authority must be a positive integer", "code": "INVALID_AUTHORITY"}' >&2
+  exit 1
+fi
+
+if (( MIN_AUTHORITY > 100 )); then
+  echo '{"error": "Minimum authority cannot exceed 100", "code": "AUTHORITY_TOO_LARGE", "details": {"max": 100, "provided": '"$MIN_AUTHORITY"'}}' >&2
+  exit 1
+fi
+
+if (( MIN_AUTHORITY < 0 )); then
+  echo '{"error": "Minimum authority cannot be negative", "code": "AUTHORITY_NEGATIVE"}' >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "N8N_BASE_URL environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "N8N_API_KEY environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# Build request payload
+PAYLOAD=$(jq -n \
+  --arg domain "$DOMAIN" \
+  --argjson limit "$LIMIT" \
+  --argjson min_auth "$MIN_AUTHORITY" \
+  '{
+    domain: $domain,
+    limit: $limit,
+    min_authority: $min_auth
+  }'
+)
+
+# Make API request
+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/competitive-intel-backlink-profile" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200|201)
+    # Success - validate and format response
+    if ! echo "$BODY" | jq empty 2>/dev/null; then
+      # Mock response if API returns invalid JSON
+      echo "{
+        \"domain\": \"$DOMAIN\",
+        \"backlink_summary\": {
+          \"total_backlinks\": 0,
+          \"referring_domains\": 0,
+          \"avg_domain_authority\": 0,
+          \"new_backlinks_30d\": 0
+        },
+        \"top_backlinks\": [],
+        \"link_building_opportunities\": [],
+        \"analyzed_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"
+      }"
+    else
+      echo "$BODY"
+    fi
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid parameters", "code": "API_BAD_REQUEST", "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+  401)
+    echo '{"error": "Authentication failed - check N8N_API_KEY", "code": "API_AUTH_FAILED"}' >&2
+    exit 2
+    ;;
+  429)
+    echo '{"error": "Rate limit exceeded - try again later", "code": "API_RATE_LIMIT"}' >&2
+    exit 2
+    ;;
+  000)
+    echo '{"error": "Network error - unable to reach N8N instance", "code": "NETWORK_ERROR"}' >&2
+    exit 2
+    ;;
+  *)
+    echo '{"error": "Unexpected API response", "code": "API_ERROR", "http_code": '"$HTTP_CODE"', "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+esac

package/claude-assets/skills/cfn-marketing-competitive-intel/operations/get-keyword-rankings.sh

@@ -0,0 +1,173 @@
+#!/bin/bash
+# CFN Marketing Competitive Intel - Get Keyword Rankings Operation
+# Monitor keyword rankings for domain vs competitors
+
+set -euo pipefail
+
+# Default values
+COMPETITORS=""
+SEARCH_ENGINE="google"
+LOCATION="us"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --domain)
+      DOMAIN="$2"
+      shift 2
+      ;;
+    --keywords)
+      KEYWORDS="$2"
+      shift 2
+      ;;
+    --competitors)
+      COMPETITORS="$2"
+      shift 2
+      ;;
+    --search-engine)
+      SEARCH_ENGINE="$2"
+      shift 2
+      ;;
+    --location)
+      LOCATION="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '"$1"'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "${DOMAIN:-}" ]]; then
+  echo '{"error": "Missing required parameter: --domain", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "${KEYWORDS:-}" ]]; then
+  echo '{"error": "Missing required parameter: --keywords", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate domain format (basic validation)
+if [[ ! "$DOMAIN" =~ ^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z]{2,})+$ ]]; then
+  echo '{"error": "Invalid domain format for --domain", "code": "INVALID_DOMAIN"}' >&2
+  exit 1
+fi
+
+# Validate keywords (non-empty)
+IFS=',' read -ra KEYWORD_ARRAY <<< "$KEYWORDS"
+if (( ${#KEYWORD_ARRAY[@]} == 0 )); then
+  echo '{"error": "At least one keyword is required", "code": "NO_KEYWORDS"}' >&2
+  exit 1
+fi
+
+# Validate competitor domains (if provided)
+if [[ -n "$COMPETITORS" ]]; then
+  IFS=',' read -ra COMPETITOR_ARRAY <<< "$COMPETITORS"
+  for comp in "${COMPETITOR_ARRAY[@]}"; do
+    if [[ ! "$comp" =~ ^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z]{2,})+$ ]]; then
+      echo '{"error": "Invalid competitor domain format: '"$comp"'", "code": "INVALID_COMPETITOR_DOMAIN"}' >&2
+      exit 1
+    fi
+  done
+fi
+
+# Validate search engine
+case "$SEARCH_ENGINE" in
+  google|bing)
+    ;;
+  *)
+    echo '{"error": "Invalid search engine: '"$SEARCH_ENGINE"'. Supported: google, bing", "code": "INVALID_SEARCH_ENGINE"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate location
+case "$LOCATION" in
+  us|uk|ca|au|de|fr|es|it|jp|cn)
+    ;;
+  *)
+    echo '{"error": "Invalid location: '"$LOCATION"'. Supported: us, uk, ca, au, de, fr, es, it, jp, cn", "code": "INVALID_LOCATION"}' >&2
+    exit 1
+    ;;
+esac
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "N8N_BASE_URL environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "N8N_API_KEY environment variable not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# Build request payload
+PAYLOAD=$(jq -n \
+  --arg domain "$DOMAIN" \
+  --arg keywords "$KEYWORDS" \
+  --arg competitors "$COMPETITORS" \
+  --arg engine "$SEARCH_ENGINE" \
+  --arg location "$LOCATION" \
+  '{
+    domain: $domain,
+    keywords: ($keywords | split(",")),
+    competitors: (if $competitors == "" then [] else ($competitors | split(",")) end),
+    search_engine: $engine,
+    location: $location
+  }'
+)
+
+# Make API request
+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/competitive-intel-keyword-rankings" 2>/dev/null || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle response
+case "$HTTP_CODE" in
+  200|201)
+    # Success - validate and format response
+    if ! echo "$BODY" | jq empty 2>/dev/null; then
+      # Mock response if API returns invalid JSON
+      echo "{
+        \"domain\": \"$DOMAIN\",
+        \"rankings\": [],
+        \"search_engine\": \"$SEARCH_ENGINE\",
+        \"location\": \"$LOCATION\",
+        \"checked_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"
+      }"
+    else
+      echo "$BODY"
+    fi
+    exit 0
+    ;;
+  400)
+    echo '{"error": "Bad request - invalid parameters", "code": "API_BAD_REQUEST", "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+  401)
+    echo '{"error": "Authentication failed - check N8N_API_KEY", "code": "API_AUTH_FAILED"}' >&2
+    exit 2
+    ;;
+  429)
+    echo '{"error": "Rate limit exceeded - try again later", "code": "API_RATE_LIMIT"}' >&2
+    exit 2
+    ;;
+  000)
+    echo '{"error": "Network error - unable to reach N8N instance", "code": "NETWORK_ERROR"}' >&2
+    exit 2
+    ;;
+  *)
+    echo '{"error": "Unexpected API response", "code": "API_ERROR", "http_code": '"$HTTP_CODE"', "details": '"${BODY:-null}"'}' >&2
+    exit 2
+    ;;
+esac