🧭 Sentiment Compass Analyze the emotional pulse of market trends. The Sentiment Compass is the analytical engine of the Visita Content Intelligence Suite. It takes the raw trend clusters produced by the Topic Trend Aggregator and uses AI to determine each trend’s emotional valence, opportunity score, and potential risk level. --- ## ⚠️ Important: Do Not Run First This Actor is Step 2 in the intelligence pipeline. It requires a dataset generated by the Topic Trend Aggregator. * ❌ Do NOT run this manually without a valid Source Dataset ID. * ✅ Run the Topic Trend Aggregator first, then paste its Dataset ID into this Actor. --- ## 🌟 Key Features ### ❤️ Emotional Valence Assigns a sentiment score from -1.0 (Negative/Crisis) to +1.0 (Positive/Opportunity) for each trend. ### 🎯 Opportunity Scoring Identifies trends with the highest opportunity potential based on: * Sentiment strength * Volume of supporting articles * Narrative momentum ### 🔍 Entity Drill-Down Analyzes sentiment toward specific people, organizations, and places mentioned inside each trend. ### 🛡️ Risk Assessment Automatically flags: * PR risks * Controversies * Sensitive narratives that require caution --- ## 🔌 Integration Workflow The Sentiment Compass is Step 2 in the Visita AI content pipeline: --- ### Step 1: Topic Trend Aggregator Output: Dataset of clustered news trends Action: Copy the Dataset ID from its run. --- ### Step 2: Sentiment Compass (This Actor) Input: Paste the Dataset ID into Source Dataset ID Action: The Compass reads each trend and computes: * Emotional valence * Sentiment label * Opportunity score * Entity-level sentiment Output: Enriched trends saved to the Default Dataset. --- ### Step 3: Content Blueprint AI Input: The enriched dataset from Sentiment Compass Action: Generates high-converting content based on the highest-scoring opportunities. --- ## ⚙️ Input Parameters | Parameter | Description | | ---------------------------------- | ----------------------------------------------------------------- | | source_dataset_id (Required) | Dataset ID produced by Topic Trend Aggregator | | max_topics_to_process | Limit how many trends are analyzed (default: 50) | | max_entities_to_analyze | Number of entities to run sentiment on per trend (default: 5) | | start_fresh | Clears the Actor’s memory and re-analyzes trends from scratch | --- ## 💰 Output & Pricing * This Actor does not scrape or fetch new data. * It enriches existing trend data with emotional intelligence. * Results are saved to the Default Dataset, ready for use in automation or export. ### Pricing Model * Free to run (you supply your own OPENAI_API_KEY). * No Apify charges unless used inside a larger automated pipeline with event-based actors. --- ## 📤 Output Format You’ll receive an enriched dataset containing fields like: * sentiment_score * sentiment_label * opportunity_score * entity_sentiment * risk_flags This dataset can be directly consumed by automation tools, Sheets, dashboards, or the Content Blueprint AI. --- ## ❓ FAQ ### Why is my output empty? Make sure you provided a valid Source Dataset ID from a complete run of the Topic Trend Aggregator. The dataset must contain fields like: * cluster_id * articles ### Can I use this with my own data? Yes — as long as your dataset matches the expected structure produced by the Topic Trend Aggregator. ---