README.md

metadata

title: Competitive Analysis Single Agent
emoji: 📊
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.19.2
python_version: 3.11
app_file: app.py
pinned: false

🏆 Competitive Analysis Agent - MCP Implementation

A sophisticated single-agent system for comprehensive competitive analysis using the Model Context Protocol (MCP) with FastMCP. This implementation combines web research, intelligent reasoning, and structured analysis to provide actionable competitive insights.

🎯 Architecture Overview

┌──────────────────────────────────────────────────────────┐
│     Single-File Application (app.py)                     │
├──────────────────────────────────────────────────────────┤
│                                                          │
│  ┌────────────────────────────────────────────────────┐ │
│  │  Gradio Web Interface (User UI)                    │ │
│  │            :7860                                   │ │
│  └────────────────────────────────────────────────────┘ │
│                        │                                │
│  ┌────────────────────────────────────────────────────┐ │
│  │  Analysis Engine & Tools:                          │ │
│  │  • validate_company()       - Verify company      │ │
│  │  • identify_sector()        - Find industry       │ │
│  │  • identify_competitors()   - Discover rivals     │ │
│  │  • browse_page()            - Extract data        │ │
│  │  • generate_report()        - Create analysis     │ │
│  └────────────────────────────────────────────────────┘ │
│                        │                                │
│  ┌────────────────────────────────────────────────────┐ │
│  │  AI Agent (OpenAI GPT-4)                           │ │
│  │  Strategic reasoning & insights generation        │ │
│  └────────────────────────────────────────────────────┘ │
│                                                          │
│              External APIs:                             │
│              • DuckDuckGo (Web Search)                 │
│              • OpenAI (LLM Analysis)                   │
│              • External Web Pages (Scraping)           │
│                                                          │
└──────────────────────────────────────────────────────────┘

Single-File Design: All functionality is consolidated in one app.py file for simplicity and ease of deployment. No separate MCP server needed.

✨ Features

🔍 Company Analysis

• Validation: Confirms company legitimacy using web search
• Sector Identification: Determines industry using multi-stage analysis
• Competitor Discovery: Identifies top 3 competitors with ranking

📊 Strategic Analysis

• Web Research: Automatically gathers company information
• Content Extraction: Extracts relevant strategic data
• Structured Reports: Generates professional analysis with:
  • Executive summary
  • Competitor comparison table
  • Strategic recommendations
  • Actionable insights

🛠️ MCP Architecture

• FastMCP Server: Lightweight, high-performance tool hosting
• Tool Isolation: Each analysis function is a callable MCP tool
• Scalable Design: Easy to add new tools or extend functionality
• Robust Error Handling: Graceful fallbacks and error management

📋 Prerequisites

• Python 3.8+
• OpenAI API key (get at https://platform.openai.com/api-keys)
• Internet connection (for web search and scraping)

⚙️ Installation

1. Clone the repository:

   git clone <repository-url>
   cd single-agent-competitive-analysis-agent
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Verify installation:

   python -c "import gradio; import openai; import requests; import beautifulsoup4; print('✓ All dependencies installed')"
   

🚀 Running the Application

Quick Start (One Command!)

python app.py

That's it! The application will:

1. Start the Gradio web interface at http://0.0.0.0:7860
2. Initialize the analysis engine
3. Open in your browser automatically (or visit http://localhost:7860)

Expected Output

Running on local URL:  http://0.0.0.0:7860
Opening in browser...

💡 Usage Guide

Basic Workflow

1. Enter Company Name: Type the name of the company you want to analyze

   • Example: "Tesla", "Spotify", "Microsoft", "Stripe"

2. Provide OpenAI API Key: Paste your OpenAI API key

   • Get one at: https://platform.openai.com/api-keys

3. Click "Analyze Competitors": The system will:

   • Validate the company exists
   • Identify its sector
   • Find top 3 competitors
   • Analyze competitor strategies
   • Generate comprehensive report

4. Review Analysis Report: The report includes:

   • Company overview and sector
   • Top 3 competitors
   • Detailed competitor comparison
   • Strategic insights
   • Actionable recommendations

📁 Project Structure

single-agent-competitive-analysis-agent/
├── app.py                 # Complete application (Gradio UI + Analysis Engine)
├── requirements.txt       # Python dependencies
├── .env.example          # Environment variables template
├── README.md             # This file
└── ARCHITECTURE.md       # Detailed architecture documentation

Application Components

The app.py file includes:

🔍 Analysis Tools

• validate_company: Company existence verification via web search
• identify_sector: Industry classification with multi-strategy analysis
• identify_competitors: Competitor discovery and ranking
• browse_page: Web content extraction and parsing
• generate_report: Structured competitive analysis report generation

🤖 AI Agent

• OpenAI GPT-4 integration for strategic reasoning
• Orchestrates analysis tools in logical sequence
• Generates insights and actionable recommendations
• Error handling with fallback modes

💻 User Interface

• Gradio-based web interface
• Professional report formatting in Markdown
• Real-time analysis execution
• Input validation and error handling

🔒 Security & Privacy

• ✅ API Keys: Never stored, used only in current session
• ✅ Web Data: Temporary, not cached
• ✅ No Tracking: Local processing only

🚀 Quick Start

# 1. Install dependencies
pip install -r requirements.txt

# 2. Run the application
python app.py

# 3. Open browser to http://localhost:7860
# (usually opens automatically)

That's all! No need for multiple terminals or separate server startup.

4. Enter company name and OpenAI API key

5. Click "Analyze Competitors"

## 🐛 Troubleshooting

**OpenAI API Key invalid**: Check it starts with `sk-` and is active  
**MCP Server not running**: Run `python mcp_server.py` in separate terminal  
**Web search failing**: Check internet connection and try different company name  
**Rate limit errors**: Wait 5 minutes before next analysis

## 📊 Performance

- Analysis Time: 30-60 seconds
- Report Generation: ~10 seconds
- API Calls: 5-8 requests per analysis
- Max Competitors: 3 (quality optimized)

---

**Version**: 1.0.0 (MCP Architecture)  
**Last Updated**: March 2026