Brand Monitor

Brand Monitor — Reddit Brand & Market Intelligence Engine

AI-powered brand monitoring system. Give it a brand name and it auto-generates a complete monitoring strategy — subreddit tiers, keywords, competitors, urgency rules. Then it runs on cron, scanning Reddit, analyzing sentiment, and pushing alerts + daily digests.

Architecture

Phase 1: Brand Onboarding (one-time per brand)
  User says "monitor DJI" → Agent analyzes website → generates monitoring plan → user confirms → saved to config

Phase 2: Continuous Monitoring (cron-driven, every 4h)
  Read config → curl Reddit JSON → deduplicate → AI analysis → alert or archive

Phase 3: Reporting (cron-driven, daily/weekly)
  Aggregate results → generate digest → send via Telegram

Phase 1: Brand Onboarding

When user says "monitor [brand]" or "help me monitor [brand]":

Step 1 — Analyze the Brand

1. Ask user for the brand website URL if not provided (or search for it)
2. Use web_fetch to visit the brand's website
3. Extract:
   • Brand name (English + local name if applicable)
   • Product lines and sub-brands
   • Main product categories
   • Target market / use cases
4. Infer competitors based on industry knowledge + web context
5. Infer common user pain points based on product category

Step 2 — Generate Tiered Monitoring Plan

Build a three-tier subreddit + keyword strategy:

Tier A — Core (brand-specific communities)

• Search for r/{brand} and related subreddits
• Keywords: pain points + opportunity words (no brand name needed since the community IS about the brand)
• Scan interval: every 4 hours
• Example for DJI: r/dji, r/djimini → keywords: flyaway, gimbal issue, firmware bug...

Tier B — Category (industry communities)

• Search for subreddits matching the product category
• Keywords: brand name + product names
• Scan interval: every 8 hours
• Example for DJI: r/drones, r/DronePhotography → keywords: DJI, Mavic, Avata...

Tier C — Interest (broad interest communities)

• Subreddits based on product application scenarios
• Keywords: brand name only (cast wide net)
• Scan interval: every 24 hours
• Example for DJI: r/travel, r/Filmmakers → keywords: DJI, Mavic, Osmo...

Step 3 — Present Plan to User

Send the monitoring plan for confirmation:

Brand Monitor Plan — [Brand Name]

A. Core Communities (scan every 4h):
  - r/xxx — keywords: pain1, pain2, pain3...

B. Category Communities (scan every 8h):
  - r/aaa — keywords: brand1, product1, product2...

C. Interest Communities (scan every 24h):
  - r/ccc — keywords: brand1, product1

Competitors: Competitor1, Competitor2
Critical keywords: recall, injury, lawsuit, class action, fire, explode

Reply "OK" to start monitoring, or tell me what to change.

Step 4 — Save Config

On user confirmation, write the brand profile to memory/brand-monitor-config.json.

Profile structure:

{
  "brand_name": "DJI",
  "display_name": "DJI",
  "website": "https://www.dji.com",
  "enabled": true,
  "created_at": "2026-01-01T12:00:00+08:00",
  "tiers": {
    "A": {
      "subreddits": ["dji", "djimini"],
      "keywords": {
        "pain": ["flyaway", "gimbal issue", "firmware bug"],
        "opportunity": ["love my", "best purchase", "recommend"]
      },
      "scan_interval_hours": 4
    },
    "B": {
      "subreddits": ["drones", "DronePhotography"],
      "keywords": {
        "brand": ["DJI", "Mavic", "Avata", "Air 3"]
      },
      "scan_interval_hours": 8
    },
    "C": {
      "subreddits": ["travel", "Filmmakers"],
      "keywords": {
        "brand": ["DJI", "Mavic", "Osmo"]
      },
      "scan_interval_hours": 24
    }
  },
  "competitors": ["Autel", "Skydio", "Parrot"],
  "urgency_rules": {
    "critical_keywords": ["recall", "injury", "lawsuit", "class action", "fire", "explode", "dangerous", "safety hazard"],
    "high_score_threshold": 50,
    "high_comment_threshold": 20
  }
}

After saving, immediately run a first scan and report a summary to the user.

Phase 2: Continuous Monitoring (Cron-Driven)

Data Collection

On each cron wake:

1. Read memory/brand-monitor-config.json — if no profiles exist, reply HEARTBEAT_OK
2. Read memory/brand-monitor-state.json for last scan timestamps
3. For each enabled brand, check which tiers are due based on scan_interval_hours
4. For due tiers, fetch posts from Reddit JSON API:

# Tier A: search pain/opportunity keywords within brand community
curl -s -H "User-Agent: BrandMonitor/1.0" \
  "https://www.reddit.com/r/{subreddit}/search.json?q={keywords_OR_joined}&restrict_sr=1&sort=new&t=day&limit=25"

# Tier B/C: search brand keywords within category/interest community
curl -s -H "User-Agent: BrandMonitor/1.0" \
  "https://www.reddit.com/r/{subreddit}/search.json?q={brand_keywords_OR_joined}&restrict_sr=1&sort=new&t=day&limit=25"

Rate limiting: 3 seconds between requests, max 15 requests per cron run.

Deduplication

Compare each post's id against seen_posts in state file. Window: 72 hours.

AI Analysis

For each new post, analyze and produce:

{
  "post_id": "t3_xxxxx",
  "subreddit": "dji",
  "tier": "A",
  "title": "Post title",
  "score": 42,
  "num_comments": 23,
  "url": "https://reddit.com/r/dji/comments/xxxxx",
  "created_utc": 1708300000,
  "sentiment": "negative",
  "intent": "bug_report",
  "urgency": "high",
  "summary": "One-line summary",
  "affected_product": "Mini 4 Pro",
  "competitor_mentioned": null,
  "recommended_action": "Suggested action"
}

Sentiment values: negative, positive, neutral, mixed
Intent values: bug_report, cs_issue, feature_request, positive_showcase, newbie_question, competitor_comparison, buyer_signal, market_insight, general_discussion
Urgency values: critical, high, medium, low

Alert Routing

Alert Format (critical/high)

Brand Alert — [Brand Name]

Severity: [CRITICAL/HIGH]
Post: [Title] (score: X, comments: Y)
Intent: [Bug Report / CS Issue / etc.]
Summary: [one-line summary]
Product: [affected product or "General"]
Action: [recommended action]
Link: https://reddit.com/r/xxx/comments/xxx

Reply "dig deeper" to analyze comments, or "draft reply" to generate a brand response.

Phase 3: Reporting

Daily Digest

For each enabled brand with results:

[Brand Name] Daily Digest — YYYY-MM-DD

Negative (N):
  1. [intent] Title — score/comments

Positive (N):
  1. [intent] Title — score/comments

Buyer Signals (N):
  - [summary]

Trends:
  - Top discussed topics
  - Sentiment shift vs last 7 days
  - Competitor mentions

Insights:
  - Agent's analysis and recommendations

Weekly Report

[Brand Name] Weekly Report

Overview:
  - Total posts scanned: X
  - Alerts triggered: Y (Z critical)
  - Sentiment distribution: +N% / -N% / ~N%

Trends, Competitor Watch, Product Line Breakdown, Recommendations...

Interactive Commands

File Locations

Cron Schedule

Edge Cases

Reddit API Rate Limited

Stop scanning, save progress, retry on next cron cycle.

Multiple Brands

Each brand is an independent profile. Cron processes them sequentially. Prioritize Tier A across all brands if approaching request limits.

Overlapping Subreddits

If two brands monitor the same subreddit, scan it once and apply results to both based on keyword matching.