Brand Monitoring

Brand monitoring tool for tracking mentions across social media platforms. Monitor Reddit, Google News, YouTube, and DuckDuckGo for brand mentions. Includes...

Security Scan

The skill's files and instructions are consistent with a demo/local brand-monitoring tool (no secrets requested and network calls are currently disabled), but part of monitor.py was truncated in the provided bundle so a full line-by-line review is recommended before running in production.

Purpose & Capability

Name/description (brand monitoring across Reddit, Google News, YouTube, DuckDuckGo) match the provided code: scrapers.py implements scrapers for those services and monitor.py contains analysis/demo logic. Minor note: SKILL.md suggests an npx install from an external nexscope-ai package, but the bundle contains the Python scripts needed to run locally — this is coherent but could be confusing.

Instruction Scope

SKILL.md instructs running scripts/monitor.py with brand parameters. The code operates in demo/simulated mode (get_demo_mentions) and the network call sections in scrapers.py are commented out or only prepare requests without performing urlopen. There are no instructions to read unrelated system files or environment variables. Caveat: monitor.py was truncated in the provided content, so I cannot confirm the omitted sections contain no unexpected behavior.

Install Mechanism

The skill has no install spec (instruction-only), so nothing will be written to disk by an installer. However, SKILL.md includes an npx command that would fetch a package from an external registry if a user chose to run it — that external install is not part of the provided bundle and should be treated separately.

Credentials

The skill requests no environment variables, no credentials, and no config paths. The functionality shown (demo scraping and local analysis) does not require credentials in its current form. Comments indicate production use might require API keys for services like Twitter/YouTube; those are not requested here.

Persistence & Privilege

The skill is not always-enabled and uses normal, user-invoked CLI behavior. It does not attempt to modify other skills or system-wide settings in the provided files.

Assessment

This package appears to be a local/demo brand-monitoring tool and is internally consistent with its description: it does not request secrets and the network requests in scrapers.py are currently disabled or only prepared. Before installing or running: 1) review the omitted portion of monitor.py (the file was truncated in the bundle) to confirm there are no hidden network calls or data exfiltration paths; 2) if you plan to enable production scraping, be aware that uncommenting or adding live HTTP requests will cause network traffic to third-party sites and may require API keys and compliance with those services' terms; 3) avoid running any npx installation command referenced in SKILL.md unless you trust the external package source (that command would fetch code not included in this bundle); and 4) consider running the scripts in a sandboxed environment first to observe network behavior and outputs.

Track brand mentions across social media platforms and analyze sentiment.

Installation

npx skills add nexscope-ai/eCommerce-Skills --skill brand-monitoring -g

Features

• Mention Monitoring — Track brand mentions across platforms
• Sentiment Analysis — Positive/negative/neutral classification
• Trend Tracking — Monitor mention volume changes
• Crisis Detection — Alerts for negative spikes or crisis keywords
• Competitor Comparison — Share of voice analysis
• Keyword Extraction — Identify trending topics
• Report Generation — Weekly/monthly reports

Supported Platforms

Platform	Method	Stability
Reddit	Public JSON API	⚠️ Rate limited
Google News	RSS Feed	✅ Stable
DuckDuckGo	Instant Answer API	✅ Stable
YouTube	HTML/RSS	⚠️ Unstable

Analysis Dimensions

Dimension	Method	Output
Volume	Mention count	Trend graph
Sentiment	NLP analysis	Sentiment score
Sources	Platform breakdown	Source distribution
Keywords	Topic extraction	Word cloud
Competitors	Share of voice	Comparison chart

Usage

Basic Monitoring

python3 scripts/monitor.py "YourBrand"

With Competitors

python3 scripts/monitor.py '{
  "brand": "YourBrand",
  "competitors": ["CompA", "CompB"],
  "platforms": ["reddit", "google_news"]
}'

Demo Mode

python3 scripts/monitor.py --demo

Output Example

📡 Brand Monitoring Report

Brand: YourBrand
Period: Last 7 days
Platforms: Reddit, Google News, YouTube

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 MENTION OVERVIEW

Total Mentions: 127
├── Reddit: 82 (65%)
├── Google News: 35 (28%)
└── YouTube: 10 (8%)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

😊 SENTIMENT ANALYSIS

Positive: 45% ████████░░
Neutral:  38% ███████░░░
Negative: 17% ███░░░░░░░

Overall Score: 7.2/10 ✅

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📈 TREND (7 days)

Mon ████████ 25
Tue ██████ 18
Wed ███████ 21
Thu █████████ 28
Fri ████████ 22
Sat ███ 8
Sun ██ 5

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔥 TRENDING KEYWORDS

1. quality (32x)
2. shipping (28x)
3. customer service (22x)
4. price (18x)
5. recommended (15x)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ ALERTS

🔴 Negative spike on Thursday (+40%)
   Related to: shipping delays
   Recommendation: Monitor and respond

Crisis Detection

Alert Level	Trigger	Action
🟢 Normal	< 20% negative	Continue monitoring
🟡 Warning	20-40% negative	Investigate sources
🔴 Crisis	> 40% negative	Immediate response needed

Monitoring Workflow

Set up brand keywords
      ↓
Monitor platforms
      ↓
Analyze sentiment
      ↓
Detect anomalies
      ↓
Generate alerts
      ↓
Weekly report

---

Part of Nexscope AI — AI tools for e-commerce sellers.