Cfn Marketing Social Publishing

CFN Marketing Social Publishing Skill

Purpose

Manage social media publishing through n8n workflow integration. Create, schedule, and analyze social media posts across multiple platforms.

Operations

1. create-post.sh

Create a new social media post.

Parameters:

• --content (required): Post text content
• --platforms (required): Comma-separated platforms (facebook,twitter,linkedin,instagram)
• --media-ids (optional): Comma-separated media attachment IDs
• --link (optional): URL to include in post
• --hashtags (optional): Comma-separated hashtags

Example:

./operations/create-post.sh \
  --content "Check out our new product launch!" \
  --platforms "facebook,twitter,linkedin" \
  --media-ids "media-123,media-456" \
  --link "https://company.com/product" \
  --hashtags "ProductLaunch,Innovation"

2. schedule-post.sh

Schedule post publication.

Parameters:

• --post-id (required): Post identifier
• --schedule-time (required): ISO 8601 datetime
• --timezone (optional): Timezone (default: UTC)

Example:

./operations/schedule-post.sh \
  --post-id "post-789" \
  --schedule-time "2025-11-01T14:00:00Z" \
  --timezone "America/Los_Angeles"

3. upload-media.sh

Upload media for social posts.

Parameters:

• --file-path (required): Local file path
• --media-type (required): Type (image, video, gif)
• --alt-text (optional): Accessibility description

Example:

./operations/upload-media.sh \
  --file-path "/path/to/image.jpg" \
  --media-type "image" \
  --alt-text "Product showcase image"

4. get-post-stats.sh

Retrieve post engagement statistics.

Parameters:

• --post-id (required): Post identifier

Example:

./operations/get-post-stats.sh --post-id "post-789"

5. delete-post.sh

Delete a scheduled or published post.

Parameters:

• --post-id (required): Post identifier
• --platforms (optional): Specific platforms to delete from (default: all)

Example:

./operations/delete-post.sh \
  --post-id "post-789" \
  --platforms "facebook,twitter"

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:

{
  "success": true,
  "data": { ... },
  "message": "Operation completed successfully"
}