Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/tonykipkemboi/competitor-battlecard-generator-crew


https://github.com/tonykipkemboi/competitor-battlecard-generator-crew

Last synced: 4 months ago
JSON representation

Awesome Lists containing this project

README 

          
# 🚀 AI-Powered Competitive Battlecard Generator



> **Next-generation competitive intelligence system powered by CrewAI's multi-agent framework**



An advanced CrewAI crew that automates comprehensive competitor research and generates world-class battle cards optimized for modern sales teams. Built with cutting-edge prompt engineering and the proven FIA (Fact, Impact, Act) framework.



## ✨ Key Features



### 🎯 **Production-Ready Multi-Agent System**

- **4 specialized AI agents** working in perfect coordination

- **Advanced prompt engineering** following CrewAI best practices  

- **EXA Search integration** for real-time market intelligence

- **Mobile-optimized output** for sales teams on the go



### 📱 **Modern Battlecard Design**

- **15-second quick reference** sections for instant insights

- **FIA Framework** (Fact → Impact → Act) for maximum retention

- **Psychological positioning** with confidence-building elements

- **Visual hierarchy** with emojis and clear formatting

- **Talk tracks and objection handling** scripts ready for customer calls



### 🔬 **Comprehensive Research Methodology**

- **Primary research** from official sources and documentation

- **Market intelligence** from industry reports and analyst coverage

- **Customer intelligence** from reviews and testimonials  

- **Financial intelligence** from funding and revenue data

- **Personnel intelligence** from leadership and hiring trends



## 🤖 Meet Your AI Research Team



### 1. **Competitive Intelligence Researcher** 🕵️

Expert at uncovering detailed competitor information through multiple data sources and research methodologies.



### 2. **Strategic Market Analyst** 📊  

Analyzes competitive landscape, identifies market positioning opportunities, and spots emerging threats.



### 3. **Sales Enablement Battlecard Creator** 🎯

Transforms research into actionable, conversation-ready battle cards using proven sales frameworks.



### 4. **Content Organization Specialist** 📋

Organizes insights into executive summaries, mobile quick-reference guides, and team distribution formats.



## 🚀 Quick Start



### 1. Clone & Install

```bash

git clone https://github.com/tonykipkemboi/competitor-battlecard-generator-crew.git

cd competitor-battlecard-generator-crew

crewai install

```



### 2. Set Up Environment Variables

Create a `.env` file with your API keys:



```bash

# Required for advanced web search

EXA_API_KEY=your_exa_api_key_here



# Choose your preferred LLM provider

OPENAI_API_KEY=your_openai_api_key_here



# Alternative LLM providers (uncomment one if preferred)

# ANTHROPIC_API_KEY=your_anthropic_key_here  

# GEMINI_API_KEY=your_gemini_key_here

# GROQ_API_KEY=your_groq_key_here

```



**Get Your API Keys:**

- **EXA API**: Sign up at [exa.ai](https://exa.ai) for advanced AI-powered search

- **OpenAI API**: Get from [OpenAI Platform](https://platform.openai.com/)



### 3. Configure Your Analysis

Edit the input parameters in `src/competitor_battlecards/main.py`:



```python

inputs = {

    'company_name': 'Your Company Name',

    'industry': 'Your Industry Segment', 

    'num_competitors': '5',

    'current_year': str(datetime.now().year)

}

```



### 4. Generate Battle Cards

```bash

crewai run

```



## 📋 What You Get



### **Single Comprehensive Battlecard Document**

Your team receives one master battlecard file (`output/comprehensive_battlecards.md`) containing:



#### 🎯 **For Each Competitor:**

- **📱 15-Second Mobile Quick Reference** - Key points for calls/meetings

- **🏢 Company Intelligence** - Funding, size, strategy, leadership

- **📊 Product & Market Analysis** - Features, pricing, positioning

- **💪 Our Competitive Advantages** - Why we win + proof points

- **⚠️ Their Strengths** - Where they compete effectively  

- **🛡️ Objection Handling Scripts** - Common concerns + proven responses

- **💰 Pricing Intelligence** - Competitive rates + negotiation strategies

- **📰 Recent News & Intel** - Latest developments and strategic changes

- **🗣️ Conversation-Ready Talk Tracks** - Specific messaging for different scenarios



#### 📈 **Executive Summary**

- **Market overview** and competitive landscape

- **Key threats and opportunities**

- **Strategic recommendations**

- **Quick competitive matrix**



## 🎨 Advanced Features



### **FIA Framework Integration**

Every competitive insight follows the proven **Fact → Impact → Act** structure:

- **FACT**: The competitive intelligence or situation

- **IMPACT**: Why this matters and when it applies

- **ACT**: Specific actions and responses for your team



### **Mobile-First Design**

- **Jump navigation** with anchor links for instant access during calls

- **Emoji visual hierarchy** for quick scanning on mobile devices  

- **15-second sections** optimized for small screens

- **Copy-paste talk tracks** ready for CRM systems



### **Psychological Positioning**

- **Confidence-building language** to reinforce your value proposition

- **Customer success framing** to shift conversations positively

- **Evidence-based responses** with specific data points and proof



## 🛠️ Customization Options



### **Research Depth Control**

Modify research parameters in `config/tasks.yaml`:

```yaml

verification_requirements: "Minimum 3 sources per data point"

research_methodology: "Primary → Market → Customer → Financial → Personnel"

```



### **Output Formatting**  

Customize battlecard structure and visual elements:

```yaml

output_format: "Mobile-optimized with FIA framework"

visual_hierarchy: "Emojis, headers, bullet points, tables"

```



### **Agent Specialization**

Fine-tune agent roles and expertise in `config/agents.yaml` for your specific industry needs.



## 🎯 Use Cases



- **🎯 Sales Enablement** - Arm sales teams with competitive intelligence

- **📈 Product Marketing** - Inform positioning and messaging strategies

- **🎪 Trade Shows & Events** - Prepare for competitive encounters  

- **💼 Strategic Planning** - Understand competitive landscape evolution

- **🔍 Win/Loss Analysis** - Identify competitive advantages and gaps

- **👥 Team Training** - Educate new hires on competitive dynamics



## 📊 Sample Output Structure



```markdown

# 🎯 Competitive Battle Cards: [Your Company] vs. Market Leaders



## 📱 Executive Quick Reference

**Market Position**: Leading challenger in enterprise AI automation

**Key Advantages**: 40% faster implementation, flexible pricing, superior support

**Main Threats**: [Competitor A] brand recognition, [Competitor B] enterprise reach



---



## 🏢 [Competitor Name] Battle Card



### 📱 15-Second Mobile Quick Ref

- **Founded**: 2020 | **Size**: 500+ employees | **Funding**: $50M Series B

- **Our Edge**: 40% faster setup, flexible pricing from $1K vs their $5K minimum

- **Their Strength**: Brand recognition, large sales team

- **Key Message**: "Same enterprise power, startup-friendly flexibility"



### 🎯 FIA Framework Insights



#### **FACT**: They require 6-month implementation cycles

**IMPACT**: Customers lose competitive advantage waiting for deployment  

**ACT**: "While [Competitor] needs 6 months to deploy, our customers are live in 6 weeks. That's 4.5 months of competitive advantage you gain by choosing us."



### 🛡️ Objection Handling Scripts

**Customer**: "They're the market leader with more experience"

**Response**: "You're right about their market presence. However, our customers consistently achieve 40% faster ROI because we built our platform with modern architecture from day one, while they're constrained by legacy systems. Would you like to see the comparative implementation timeline?"

```



## 🔧 Advanced Training & Testing



### **Train Your Crew**

```bash

crewai train 5 "training_data.pkl"

```



### **Performance Testing**  

```bash

crewai test 3 "gpt-4"

```



### **Custom Tool Integration**

Add specialized research tools in `crew.py`:

```python

tools=[

    EXASearchTool(api_key=os.getenv('EXA_API_KEY')),

    WebsiteSearchTool(),

    ScrapeWebsiteTool(),

    # Your custom tools here

]

```



## 🤝 Contributing



This project follows CrewAI best practices and is designed for easy customization:



1. **Fork the repository**

2. **Customize agents/tasks** for your industry

3. **Add specialized tools** for your research needs  

4. **Submit pull requests** for general improvements



## 📚 Resources



- **[CrewAI Documentation](https://docs.crewai.com/)** - Official framework docs

- **[EXA Search API](https://docs.exa.ai/)** - Advanced search capabilities

- **[OpenAI Platform](https://platform.openai.com/)** - LLM API documentation



## 🆘 Support



- **Configuration Issues**: Check `config/` files and API key setup

- **Research Quality**: Adjust verification requirements in tasks.yaml

- **Output Format**: Modify templates in battlecard creation task

- **Performance**: Consider training the crew on your specific use cases



---



**Built with ❤️ using CrewAI's multi-agent framework**



*Transform your competitive intelligence from manual research to automated insights in minutes, not days.*