💡 AI Content Opportunity Scout

The AI Content Opportunity Scout is the fourth-stage actor in the Content Blueprint AI pipeline. It is triggered after the Sentiment Compass actor completes.

Its purpose is to take the sentiment-enriched trends and analyze them for specific content opportunities. It uses keyword research tools (via the Google Ads API) to find search volume, competition, and related keywords, and then combines this with the trend and sentiment data to score each opportunity.

This final, enriched data is then passed to Content Blueprint AI to generate the final output.

🤖 Role in the "Content Blueprint AI" Pipeline

This actor is the fourth step in the pipeline:

1. News Intelligence Actors (Scrape raw news)
2. Topic Trend Aggregator (Clusters news into trends)
3. Sentiment Compass (Analyzes sentiment for each trend)
4. AI Content Opportunity Scout (This Actor)
   • Receives trends + sentiment data.
   • Performs keyword research and opportunity scoring.
   • Passes the final data to the last actor.
5. Content Blueprint AI (Generates briefs and sends to Supabase)

⚙️ Input Parameters

• source_dataset_id (Required): The ID of the dataset produced by the upstream Sentiment Compass actor.
  • Note: In production, this value is passed automatically by the "Action" chain. The default value is for manual testing and to pass Apify's daily maintenance run.
• target_niche_keywords (Array): Optional keywords to focus the analysis on a specific niche.
• min_trend_score (Number): Ignores topics with a trend score below this value.
• min_opportunity_score (Number): Filters the final output to only include opportunities above this score.
• language_code (String): Google Ads API language code (e.g., en).
• location_ids (Array): Google Ads API location IDs (e.g., [2840] for USA).

📤 Output

The actor's output is a dataset of the trends, now fully enriched with sentiment, keyword data, and an "opportunity score." This dataset is then used as the input for the final Content Blueprint AI actor.

🗓️ Scheduling

DO NOT run this actor on a time-based schedule.

This actor is designed to be chained from the Sentiment Compass actor. It should only run when the Sentiment Compass finishes successfully and passes its dataset ID as input.