How laksh-star/competitive-intelligence works
Competitive Intelligence Monitor supports a credential-free analyst workflow over saved articles and a live web-to-events pipeline backed by PostgreSQL. Analysts can run either mode through the CLI; agents can use the MCP tools to analyze, search, rank trends, and create briefs or dashboards. In live mode, CocoIndex searches with Tavily, extracts competitive events with an LLM, and indexes articles and events. The README also documents interactive monitoring; its wiring is represented only where supported by the sampled source. The live pipeline internals are only partially sampled, so uncertain stage-level links are omitted.
Main entry points: local_intel.py Local Analyzer · main.py CocoIndex Pipeline · mcp_server.py MCP Tools · competitive_intel.py Command Line
Components 15
User Interfaces
- Command Line
competitive_intel.py - Interactive Monitor
run_interactive.py
Local Analysis
- Local Analyzer
local_intel.py - Watchlist
watchlist.json - Saved Articles
data/sample_articles.json - Briefs And Dashboards
local_intel.py
Live Intelligence
- Live Run Coordinator
live_demo_check.py - CocoIndex Pipeline
main.py
Agent Access
- MCP Tools
mcp_server.py - Data Providers
providers.py
Other components
- Analyst
- MCP Agent
- Tavily Search
- LLM Extraction
- PostgreSQL
Connections 17
- Analyst → Command Line: runs command
- Analyst → Interactive Monitor: sets monitoring
- MCP Agent → MCP Tools: calls tools
- Command Line → Local Analyzer: runs sample analysis
- Command Line → Live Run Coordinator: starts live check
- Interactive Monitor → CocoIndex Pipeline: starts monitoring
- Local Analyzer → Watchlist: reads config
- Local Analyzer → Saved Articles: reads articles
- Local Analyzer → Briefs And Dashboards: writes reports
- Live Run Coordinator → MCP Tools: requests updates and queries
- MCP Tools → Data Providers: dispatches data tools
- MCP Tools → CocoIndex Pipeline: runs CocoIndex update
- Data Providers → Local Analyzer: uses local analysis
- Data Providers → PostgreSQL: queries events
- CocoIndex Pipeline → Tavily Search: searches articles
- CocoIndex Pipeline → LLM Extraction: extracts events
- CocoIndex Pipeline → PostgreSQL: indexes articles and events