🧭 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.

---