| name | brand-monitor |
| description | Reddit brand & market intelligence engine. AI-powered onboarding — give it a brand name and it auto-generates the monitoring strategy. Supports multi-brand, layered subreddit monitoring, real-time alerts, and daily digests. Triggers on "/brand-monitor", "monitor [brand]", "check brand", "brand health", "market intelligence". |
| inputs | [{"name":"brand_name","type":"string","required":true,"description":"The brand or competitor name to monitor on Reddit"},{"name":"scan_tiers","type":"list","required":false,"description":"Subreddit tiers to scan — A (high-signal), B (niche), C (broad). Defaults to all tiers."}] |
| outputs | [{"name":"alerts","type":"list","description":"List of high-urgency mentions requiring immediate attention"},{"name":"digest","type":"text","description":"Human-readable daily digest of brand mentions and sentiment"},{"name":"buyer_signals","type":"list","description":"List of posts/comments showing purchase intent or competitor dissatisfaction"}] |
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
- Ask user for the brand website URL if not provided (or search for it)
- Use
web_fetch to visit the brand's website
- Extract:
- Brand name (English + local name if applicable)
- Product lines and sub-brands
- Main product categories
- Target market / use cases
- Infer competitors based on industry knowledge + web context
- 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:
- Read
memory/brand-monitor-config.json — if no profiles exist, reply HEARTBEAT_OK
- Read
memory/brand-monitor-state.json for last scan timestamps
- For each enabled brand, check which tiers are due based on
scan_interval_hours
- For due tiers, fetch posts from Reddit JSON API:
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"
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
| Urgency | Action |
|---|
| critical | IMMEDIATELY send alert |
| high | IMMEDIATELY send alert |
| medium | Archive to daily results, include in digest |
| low | Archive to daily results only |
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
| User Says | Agent Does |
|---|
| "monitor [brand]" | Start onboarding flow |
| "check [brand]" | Run immediate full scan |
| "dig deeper [post_url]" | Fetch all comments, deep sentiment analysis |
| "draft reply [post_url]" | Generate brand-appropriate response draft |
| "daily digest" | Generate and send today's digest immediately |
| "weekly report" | Generate and send weekly report immediately |
| "pause [brand]" | Set brand.enabled = false |
| "resume [brand]" | Set brand.enabled = true |
| "monitor list" | List all brand profiles with status |
File Locations
| File | Purpose |
|---|
memory/brand-monitor-config.json | Brand profiles, subreddits, keywords, settings |
memory/brand-monitor-state.json | Scan timestamps, seen posts, daily results, stats |
memory/brand-monitor-assets.json | Saved UGC candidates, positive showcases |
Cron Schedule
| Job | Schedule | Purpose |
|---|
| Reddit Scan | Every 4h | Fetch new posts, analyze, alert |
| Daily Digest | Daily 09:00 (your TZ) | Aggregate and send results |
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.
