{ "schemaVersion": "1.0", "item": { "slug": "social-media-analyzer", "name": "Social Media Analyzer", "source": "tencent", "type": "skill", "category": "数据分析", "sourceUrl": "https://clawhub.ai/alirezarezvani/social-media-analyzer", "canonicalUrl": "https://clawhub.ai/alirezarezvani/social-media-analyzer", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/social-media-analyzer", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=social-media-analyzer", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "HOW_TO_USE.md", "SKILL.md", "assets/expected_output.json", "assets/sample_input.json", "references/platform-benchmarks.md", "scripts/analyze_performance.py" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/social-media-analyzer" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/social-media-analyzer", "agentPageUrl": "https://openagent3.xyz/skills/social-media-analyzer/agent", "manifestUrl": "https://openagent3.xyz/skills/social-media-analyzer/agent.json", "briefUrl": "https://openagent3.xyz/skills/social-media-analyzer/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Social Media Analyzer", "body": "Campaign performance analysis with engagement metrics, ROI calculations, and platform benchmarks." }, { "title": "Table of Contents", "body": "Analysis Workflow\nEngagement Metrics\nROI Calculation\nPlatform Benchmarks\nTools\nExamples" }, { "title": "Analysis Workflow", "body": "Analyze social media campaign performance:\n\nValidate input data completeness (reach > 0, dates valid)\nCalculate engagement metrics per post\nAggregate campaign-level metrics\nCalculate ROI if ad spend provided\nCompare against platform benchmarks\nIdentify top and bottom performers\nGenerate recommendations\nValidation: Engagement rate < 100%, ROI matches spend data" }, { "title": "Input Requirements", "body": "FieldRequiredDescriptionplatformYesinstagram, facebook, twitter, linkedin, tiktokposts[]YesArray of post dataposts[].likesYesLike/reaction countposts[].commentsYesComment countposts[].reachYesUnique users reachedposts[].impressionsNoTotal viewsposts[].sharesNoShare/retweet countposts[].savesNoSave/bookmark countposts[].clicksNoLink clickstotal_spendNoAd spend (for ROI)" }, { "title": "Data Validation Checks", "body": "Before analysis, verify:\n\nReach > 0 for all posts (avoid division by zero)\n Engagement counts are non-negative\n Date range is valid (start < end)\n Platform is recognized\n Spend > 0 if ROI requested" }, { "title": "Engagement Rate Calculation", "body": "Engagement Rate = (Likes + Comments + Shares + Saves) / Reach × 100" }, { "title": "Metric Definitions", "body": "MetricFormulaInterpretationEngagement RateEngagements / Reach × 100Audience interaction levelCTRClicks / Impressions × 100Content click appealReach RateReach / Followers × 100Content distributionVirality RateShares / Impressions × 100Share-worthinessSave RateSaves / Reach × 100Content value" }, { "title": "Performance Categories", "body": "RatingEngagement RateActionExcellent> 6%Scale and replicateGood3-6%Optimize and expandAverage1-3%Test improvementsPoor< 1%Analyze and pivot" }, { "title": "ROI Calculation", "body": "Calculate return on ad spend:\n\nSum total engagements across posts\nCalculate cost per engagement (CPE)\nCalculate cost per click (CPC) if clicks available\nEstimate engagement value using benchmark rates\nCalculate ROI percentage\nValidation: ROI = (Value - Spend) / Spend × 100" }, { "title": "ROI Formulas", "body": "MetricFormulaCost Per Engagement (CPE)Total Spend / Total EngagementsCost Per Click (CPC)Total Spend / Total ClicksCost Per Thousand (CPM)(Spend / Impressions) × 1000Return on Ad Spend (ROAS)Revenue / Ad Spend" }, { "title": "Engagement Value Estimates", "body": "ActionValueRationaleLike$0.50Brand awarenessComment$2.00Active engagementShare$5.00AmplificationSave$3.00Intent signalClick$1.50Traffic value" }, { "title": "ROI Interpretation", "body": "ROI %RatingRecommendation> 500%ExcellentScale budget significantly200-500%GoodIncrease budget moderately100-200%AcceptableOptimize before scaling0-100%Break-evenReview targeting and creative< 0%NegativePause and restructure" }, { "title": "Engagement Rate by Platform", "body": "PlatformAverageGoodExcellentInstagram1.22%3-6%>6%Facebook0.07%0.5-1%>1%Twitter/X0.05%0.1-0.5%>0.5%LinkedIn2.0%3-5%>5%TikTok5.96%8-15%>15%" }, { "title": "CTR by Platform", "body": "PlatformAverageGoodExcellentInstagram0.22%0.5-1%>1%Facebook0.90%1.5-2.5%>2.5%LinkedIn0.44%1-2%>2%TikTok0.30%0.5-1%>1%" }, { "title": "CPC by Platform", "body": "PlatformAverageGoodFacebook$0.97<$0.50Instagram$1.20<$0.70LinkedIn$5.26<$3.00TikTok$1.00<$0.50\n\nSee references/platform-benchmarks.md for complete benchmark data." }, { "title": "Calculate Metrics", "body": "python scripts/calculate_metrics.py assets/sample_input.json\n\nCalculates engagement rate, CTR, reach rate for each post and campaign totals." }, { "title": "Analyze Performance", "body": "python scripts/analyze_performance.py assets/sample_input.json\n\nGenerates full performance analysis with ROI, benchmarks, and recommendations.\n\nOutput includes:\n\nCampaign-level metrics\nPost-by-post breakdown\nBenchmark comparisons\nTop performers ranked\nActionable recommendations" }, { "title": "Sample Input", "body": "See assets/sample_input.json:\n\n{\n \"platform\": \"instagram\",\n \"total_spend\": 500,\n \"posts\": [\n {\n \"post_id\": \"post_001\",\n \"content_type\": \"image\",\n \"likes\": 342,\n \"comments\": 28,\n \"shares\": 15,\n \"saves\": 45,\n \"reach\": 5200,\n \"impressions\": 8500,\n \"clicks\": 120\n }\n ]\n}" }, { "title": "Sample Output", "body": "See assets/expected_output.json:\n\n{\n \"campaign_metrics\": {\n \"total_engagements\": 1521,\n \"avg_engagement_rate\": 8.36,\n \"ctr\": 1.55\n },\n \"roi_metrics\": {\n \"total_spend\": 500.0,\n \"cost_per_engagement\": 0.33,\n \"roi_percentage\": 660.5\n },\n \"insights\": {\n \"overall_health\": \"excellent\",\n \"benchmark_comparison\": {\n \"engagement_status\": \"excellent\",\n \"engagement_benchmark\": \"1.22%\",\n \"engagement_actual\": \"8.36%\"\n }\n }\n}" }, { "title": "Interpretation", "body": "The sample campaign shows:\n\nEngagement rate 8.36% vs 1.22% benchmark = Excellent (6.8x above average)\nCTR 1.55% vs 0.22% benchmark = Excellent (7x above average)\nROI 660% = Outstanding return on $500 spend\nRecommendation: Scale budget, replicate successful elements" }, { "title": "Platform Benchmarks", "body": "references/platform-benchmarks.md contains:\n\nEngagement rate benchmarks by platform and industry\nCTR benchmarks for organic and paid content\nCost benchmarks (CPC, CPM, CPE)\nContent type performance by platform\nOptimal posting times and frequency\nROI calculation formulas" }, { "title": "Proactive Triggers", "body": "Engagement rate below platform average → Content isn't resonating. Analyze top performers for patterns.\nFollower growth stalled → Content distribution or frequency issue. Audit posting patterns.\nHigh impressions, low engagement → Reach without resonance. Content quality issue.\nCompetitor outperforming significantly → Content gap. Analyze their successful posts." }, { "title": "Output Artifacts", "body": "When you ask for...You get...\"Social media audit\"Performance analysis across platforms with benchmarks\"What's performing?\"Top content analysis with patterns and recommendations\"Competitor social analysis\"Competitive social media comparison with gaps" }, { "title": "Communication", "body": "All output passes quality verification:\n\nSelf-verify: source attribution, assumption audit, confidence scoring\nOutput format: Bottom Line → What (with confidence) → Why → How to Act\nResults only. Every finding tagged: 🟢 verified, 🟡 medium, 🔴 assumed." }, { "title": "Related Skills", "body": "social-content: For creating social posts. Use this skill for analyzing performance.\ncampaign-analytics: For cross-channel analytics including social.\ncontent-strategy: For planning social content themes.\nmarketing-context: Provides audience context for better analysis." } ], "body": "Social Media Analyzer\n\nCampaign performance analysis with engagement metrics, ROI calculations, and platform benchmarks.\n\nTable of Contents\nAnalysis Workflow\nEngagement Metrics\nROI Calculation\nPlatform Benchmarks\nTools\nExamples\nAnalysis Workflow\n\nAnalyze social media campaign performance:\n\nValidate input data completeness (reach > 0, dates valid)\nCalculate engagement metrics per post\nAggregate campaign-level metrics\nCalculate ROI if ad spend provided\nCompare against platform benchmarks\nIdentify top and bottom performers\nGenerate recommendations\nValidation: Engagement rate < 100%, ROI matches spend data\nInput Requirements\nField\tRequired\tDescription\nplatform\tYes\tinstagram, facebook, twitter, linkedin, tiktok\nposts[]\tYes\tArray of post data\nposts[].likes\tYes\tLike/reaction count\nposts[].comments\tYes\tComment count\nposts[].reach\tYes\tUnique users reached\nposts[].impressions\tNo\tTotal views\nposts[].shares\tNo\tShare/retweet count\nposts[].saves\tNo\tSave/bookmark count\nposts[].clicks\tNo\tLink clicks\ntotal_spend\tNo\tAd spend (for ROI)\nData Validation Checks\n\nBefore analysis, verify:\n\n Reach > 0 for all posts (avoid division by zero)\n Engagement counts are non-negative\n Date range is valid (start < end)\n Platform is recognized\n Spend > 0 if ROI requested\nEngagement Metrics\nEngagement Rate Calculation\nEngagement Rate = (Likes + Comments + Shares + Saves) / Reach × 100\n\nMetric Definitions\nMetric\tFormula\tInterpretation\nEngagement Rate\tEngagements / Reach × 100\tAudience interaction level\nCTR\tClicks / Impressions × 100\tContent click appeal\nReach Rate\tReach / Followers × 100\tContent distribution\nVirality Rate\tShares / Impressions × 100\tShare-worthiness\nSave Rate\tSaves / Reach × 100\tContent value\nPerformance Categories\nRating\tEngagement Rate\tAction\nExcellent\t> 6%\tScale and replicate\nGood\t3-6%\tOptimize and expand\nAverage\t1-3%\tTest improvements\nPoor\t< 1%\tAnalyze and pivot\nROI Calculation\n\nCalculate return on ad spend:\n\nSum total engagements across posts\nCalculate cost per engagement (CPE)\nCalculate cost per click (CPC) if clicks available\nEstimate engagement value using benchmark rates\nCalculate ROI percentage\nValidation: ROI = (Value - Spend) / Spend × 100\nROI Formulas\nMetric\tFormula\nCost Per Engagement (CPE)\tTotal Spend / Total Engagements\nCost Per Click (CPC)\tTotal Spend / Total Clicks\nCost Per Thousand (CPM)\t(Spend / Impressions) × 1000\nReturn on Ad Spend (ROAS)\tRevenue / Ad Spend\nEngagement Value Estimates\nAction\tValue\tRationale\nLike\t$0.50\tBrand awareness\nComment\t$2.00\tActive engagement\nShare\t$5.00\tAmplification\nSave\t$3.00\tIntent signal\nClick\t$1.50\tTraffic value\nROI Interpretation\nROI %\tRating\tRecommendation\n> 500%\tExcellent\tScale budget significantly\n200-500%\tGood\tIncrease budget moderately\n100-200%\tAcceptable\tOptimize before scaling\n0-100%\tBreak-even\tReview targeting and creative\n< 0%\tNegative\tPause and restructure\nPlatform Benchmarks\nEngagement Rate by Platform\nPlatform\tAverage\tGood\tExcellent\nInstagram\t1.22%\t3-6%\t>6%\nFacebook\t0.07%\t0.5-1%\t>1%\nTwitter/X\t0.05%\t0.1-0.5%\t>0.5%\nLinkedIn\t2.0%\t3-5%\t>5%\nTikTok\t5.96%\t8-15%\t>15%\nCTR by Platform\nPlatform\tAverage\tGood\tExcellent\nInstagram\t0.22%\t0.5-1%\t>1%\nFacebook\t0.90%\t1.5-2.5%\t>2.5%\nLinkedIn\t0.44%\t1-2%\t>2%\nTikTok\t0.30%\t0.5-1%\t>1%\nCPC by Platform\nPlatform\tAverage\tGood\nFacebook\t$0.97\t<$0.50\nInstagram\t$1.20\t<$0.70\nLinkedIn\t$5.26\t<$3.00\nTikTok\t$1.00\t<$0.50\n\nSee references/platform-benchmarks.md for complete benchmark data.\n\nTools\nCalculate Metrics\npython scripts/calculate_metrics.py assets/sample_input.json\n\n\nCalculates engagement rate, CTR, reach rate for each post and campaign totals.\n\nAnalyze Performance\npython scripts/analyze_performance.py assets/sample_input.json\n\n\nGenerates full performance analysis with ROI, benchmarks, and recommendations.\n\nOutput includes:\n\nCampaign-level metrics\nPost-by-post breakdown\nBenchmark comparisons\nTop performers ranked\nActionable recommendations\nExamples\nSample Input\n\nSee assets/sample_input.json:\n\n{\n \"platform\": \"instagram\",\n \"total_spend\": 500,\n \"posts\": [\n {\n \"post_id\": \"post_001\",\n \"content_type\": \"image\",\n \"likes\": 342,\n \"comments\": 28,\n \"shares\": 15,\n \"saves\": 45,\n \"reach\": 5200,\n \"impressions\": 8500,\n \"clicks\": 120\n }\n ]\n}\n\nSample Output\n\nSee assets/expected_output.json:\n\n{\n \"campaign_metrics\": {\n \"total_engagements\": 1521,\n \"avg_engagement_rate\": 8.36,\n \"ctr\": 1.55\n },\n \"roi_metrics\": {\n \"total_spend\": 500.0,\n \"cost_per_engagement\": 0.33,\n \"roi_percentage\": 660.5\n },\n \"insights\": {\n \"overall_health\": \"excellent\",\n \"benchmark_comparison\": {\n \"engagement_status\": \"excellent\",\n \"engagement_benchmark\": \"1.22%\",\n \"engagement_actual\": \"8.36%\"\n }\n }\n}\n\nInterpretation\n\nThe sample campaign shows:\n\nEngagement rate 8.36% vs 1.22% benchmark = Excellent (6.8x above average)\nCTR 1.55% vs 0.22% benchmark = Excellent (7x above average)\nROI 660% = Outstanding return on $500 spend\nRecommendation: Scale budget, replicate successful elements\nReference Documentation\nPlatform Benchmarks\n\nreferences/platform-benchmarks.md contains:\n\nEngagement rate benchmarks by platform and industry\nCTR benchmarks for organic and paid content\nCost benchmarks (CPC, CPM, CPE)\nContent type performance by platform\nOptimal posting times and frequency\nROI calculation formulas\nProactive Triggers\nEngagement rate below platform average → Content isn't resonating. Analyze top performers for patterns.\nFollower growth stalled → Content distribution or frequency issue. Audit posting patterns.\nHigh impressions, low engagement → Reach without resonance. Content quality issue.\nCompetitor outperforming significantly → Content gap. Analyze their successful posts.\nOutput Artifacts\nWhen you ask for...\tYou get...\n\"Social media audit\"\tPerformance analysis across platforms with benchmarks\n\"What's performing?\"\tTop content analysis with patterns and recommendations\n\"Competitor social analysis\"\tCompetitive social media comparison with gaps\nCommunication\n\nAll output passes quality verification:\n\nSelf-verify: source attribution, assumption audit, confidence scoring\nOutput format: Bottom Line → What (with confidence) → Why → How to Act\nResults only. Every finding tagged: 🟢 verified, 🟡 medium, 🔴 assumed.\nRelated Skills\nsocial-content: For creating social posts. Use this skill for analyzing performance.\ncampaign-analytics: For cross-channel analytics including social.\ncontent-strategy: For planning social content themes.\nmarketing-context: Provides audience context for better analysis." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/alirezarezvani/social-media-analyzer", "publisherUrl": "https://clawhub.ai/alirezarezvani/social-media-analyzer", "owner": "alirezarezvani", "version": "2.1.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/social-media-analyzer", "downloadUrl": "https://openagent3.xyz/downloads/social-media-analyzer", "agentUrl": "https://openagent3.xyz/skills/social-media-analyzer/agent", "manifestUrl": "https://openagent3.xyz/skills/social-media-analyzer/agent.json", "briefUrl": "https://openagent3.xyz/skills/social-media-analyzer/agent.md" } }