Competitor Intelligence
Automated competitor monitoring and intelligence gathering system.
Important: Before running any competitor intel commands, ask the user which competitors they want to track. Do not assume or hardcode competitor names.
Quick Start
One-Time: Research a New Competitor
# Create a new competitor profile (agent-driven research)
python3 competitor-intel/scripts/setup_competitor.py --name "CompanyName" --website https://example.com --slug companynameThen run an agent research session to populate the profile.
Daily: Reddit + Twitter Monitoring
# Run daily signals collection (automated via cron)
python3 competitor-intel/scripts/run_daily.py
# Or for a specific competitor
python3 competitor-intel/scripts/run_daily.py --competitor <competitor-slug>Weekly: Deep Dive + LinkedIn
# Run weekly deep dive (Monday mornings)
python3 competitor-intel/scripts/run_weekly.pyGenerate Report
# Generate daily or weekly report
python3 competitor-intel/scripts/generate_report.py --type daily --date 2026-02-21
python3 competitor-intel/scripts/generate_report.py --type weekly --date 2026-02-21Data Structure
competitor-intel/competitors/[slug]/profile.md- Deep research profile per competitorcompetitor-intel/competitors/[slug]/snapshots/- Point-in-time weekly snapshotscompetitor-intel/reports/- Daily and weekly digest reportscompetitor-intel/raw-data/- Raw JSON from Reddit/Twitter scrapescompetitor-intel/config.json- Global configuration
Tracked Competitors
Competitors are configured per-project. Ask the user which competitors to track, then add them here:
| Competitor | Slug | Status |
|---|---|---|
| *(ask user)* | — | — |
Automation
- Daily (8 AM PT): Reddit + Twitter scrape → daily report → email
- Weekly (Monday 9 AM PT): Deep dive + LinkedIn + weekly report → email
Dependencies
- Apify API (Reddit + Twitter scraping) - token in config.json
- Web search (LinkedIn founder tracking, one-time research)
- AgentMail (report delivery)