Competitor Intelligence

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 companyname

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.py

Generate 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-21

Data Structure

• competitor-intel/competitors/[slug]/profile.md

  - Deep research profile per competitor

• competitor-intel/competitors/[slug]/snapshots/

  - Point-in-time weekly snapshots

• competitor-intel/reports/

  - Daily and weekly digest reports

• competitor-intel/raw-data/

  - Raw JSON from Reddit/Twitter scrapes

• competitor-intel/config.json

  - Global configuration

Tracked Competitors

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)