alirezarezvani/claude-code-skill-factory / generated-skills/social-media-analyzer
social-media-analyzer
VerifiedAnalyzes social media campaign performance across platforms with engagement metrics, ROI calculations, and audience insights for data-driven marketing decisions
| File | Kind | Size |
|---|---|---|
| HOW_TO_USE.md | markdown | 1.8 KB |
| SKILL.md | skill md | 3.0 KB |
| analyze_performance.py | script | 7.2 KB |
| calculate_metrics.py | script | 5.4 KB |
| expected_output.json | config | 1.5 KB |
| sample_input.json | config | 867 B |
calculate_metrics.py
View on GitHub"""
Social media metrics calculation module.
Provides functions to calculate engagement, reach, and ROI metrics.
"""
from typing import Dict, List, Any, Optional
from datetime import datetime
class SocialMediaMetricsCalculator:
"""Calculate social media performance metrics."""
def __init__(self, campaign_data: Dict[str, Any]):
"""
Initialize with campaign data.
Args:
campaign_data: Dictionary containing platform, posts, and cost data
"""
self.platform = campaign_data.get('platform', 'unknown')
self.posts = campaign_data.get('posts', [])
self.total_spend = campaign_data.get('total_spend', 0)
self.metrics = {}
def safe_divide(self, numerator: float, denominator: float, default: float = 0.0) -> float:
"""Safely divide two numbers, returning default if denominator is zero."""
if denominator == 0:
return default
return numerator / denominator
def calculate_engagement_rate(self, post: Dict[str, Any]) -> float:
"""
Calculate engagement rate for a post.
Args:
post: Dictionary with likes, comments, shares, and reach
Returns:
Engagement rate as percentage
"""
likes = post.get('likes', 0)
comments = post.get('comments', 0)
shares = post.get('shares', 0)
saves = post.get('saves', 0)
reach = post.get('reach', 0)
total_engagements = likes + comments + shares + saves
engagement_rate = self.safe_divide(total_engagements, reach) * 100
return round(engagement_rate, 2)
def calculate_ctr(self, clicks: int, impressions: int) -> float:
"""
Calculate click-through rate.
Args:
clicks: Number of clicks
impressions: Number of impressions
Returns:
CTR as percentage
"""
ctr = self.safe_divide(clicks, impressions) * 100
return round(ctr, 2)
def calculate_campaign_metrics(self) -> Dict[str, Any]:
"""Calculate overall campaign metrics."""
total_likes = sum(post.get('likes', 0) for post in self.posts)
total_comments = sum(post.get('comments', 0) for post in self.posts)
total_shares = sum(post.get('shares', 0) for post in self.posts)
total_reach = sum(post.get('reach', 0) for post in self.posts)
total_impressions = sum(post.get('impressions', 0) for post in self.posts)
total_clicks = sum(post.get('clicks', 0) for post in self.posts)
total_engagements = total_likes + total_comments + total_shares
return {
'platform': self.platform,
'total_posts': len(self.posts),
'total_engagements': total_engagements,
'total_reach': total_reach,
'total_impressions': total_impressions,
'total_clicks': total_clicks,
'avg_engagement_rate': self.safe_divide(total_engagements, total_reach) * 100,
'ctr': self.calculate_ctr(total_clicks, total_impressions)
}
def calculate_roi_metrics(self) -> Dict[str, float]:
"""Calculate ROI and cost efficiency metrics."""
campaign_metrics = self.calculate_campaign_metrics()
total_engagements = campaign_metrics['total_engagements']
total_clicks = campaign_metrics['total_clicks']
cost_per_engagement = self.safe_divide(self.total_spend, total_engagements)
cost_per_click = self.safe_divide(self.total_spend, total_clicks)
# Assuming average value per engagement (can be customized)
avg_value_per_engagement = 2.50 # Example: $2.50 value per engagement
total_value = total_engagements * avg_value_per_engagement
roi_percentage = self.safe_divide(total_value - self.total_spend, self.total_spend) * 100
return {
'total_spend': round(self.total_spend, 2),
'cost_per_engagement': round(cost_per_engagement, 2),
'cost_per_click': round(cost_per_click, 2),
'estimated_value': round(total_value, 2),
'roi_percentage': round(roi_percentage, 2)
}
def identify_top_posts(self, metric: str = 'engagement_rate', limit: int = 5) -> List[Dict[str, Any]]:
"""
Identify top performing posts.
Args:
metric: Metric to sort by (engagement_rate, likes, shares, etc.)
limit: Number of top posts to return
Returns:
List of top performing posts with metrics
"""
posts_with_metrics = []
for post in self.posts:
post_copy = post.copy()
post_copy['engagement_rate'] = self.calculate_engagement_rate(post)
posts_with_metrics.append(post_copy)
# Sort by specified metric
if metric == 'engagement_rate':
sorted_posts = sorted(posts_with_metrics,
key=lambda x: x['engagement_rate'],
reverse=True)
else:
sorted_posts = sorted(posts_with_metrics,
key=lambda x: x.get(metric, 0),
reverse=True)
return sorted_posts[:limit]
def analyze_all(self) -> Dict[str, Any]:
"""Run complete analysis."""
return {
'campaign_metrics': self.calculate_campaign_metrics(),
'roi_metrics': self.calculate_roi_metrics(),
'top_posts': self.identify_top_posts()
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |