
Market Research AI Platform
A comprehensive, AI-powered market research platform that combines specialized agents to deliver in-depth analysis of markets, competitors, consumer sentiment, and industry trends.
š Features
Multi-Agent Architecture: Specialized AI agents working together to provide comprehensive market insights
Competitive Analysis: Detailed analysis of competitors, their strengths, weaknesses, and market positioning
Consumer Insights: Analysis of consumer sentiment, preferences, and behavior patterns
Market Sizing: Data-driven market size estimation and growth projections
Trend Identification: Recognition of emerging market trends and developments
SWOT Analysis: Automated SWOT analysis for companies based on real data
Interactive UI: User-friendly Streamlit interface for easy interaction
š Key Capabilities
Web Data Integration: Extracts and analyzes information from multiple web sources
API Integration: Connects with external APIs for enhanced data collection (News API, Google Maps, SerpAPI)
Sentiment Analysis: Uses NLP to analyze consumer sentiment about products and services
Market Estimation: Provides data-driven market size estimates with regional breakdowns
Automated Research: Conducts complex market research tasks with minimal user input
šļø Architecture
The platform uses a hierarchical agent structure:
Supervisor: Coordinates specialized agents and synthesizes their findings
Competitive Analysis Agent: Analyzes competitive landscape using real data
Consumer Insights Agent: Extracts and analyzes consumer sentiment and behavior
Market Sizing Agent: Estimates market size, growth rates, and projections
Market Trends Agent: Identifies current and emerging trends in the market
š Project Structure
š Getting Started
Prerequisites
Python 3.8+
OpenAI API key
(Optional) News API key
(Optional) Google Maps API key
(Optional) SerpAPI key
Installation
Clone the repository:
Create and activate a virtual environment:
Install dependencies:
Create a
.env file in the project root and add your API keys:Running the Application
Launch the Streamlit web interface:
The web interface will be available at http://localhost:8501.
š§ Usage Examples
Basic Market Research
To conduct a basic market research:
Comprehensive Market Analysis
For a more detailed analysis with specific components:
Localized Market Research
For location-specific market research:
š Sample Outputs
Market Size Analysis
Competitive Analysis
š API Documentation
Supervisor
The
Supervisor class coordinates multiple specialized agents to provide comprehensive market research.Specialized Agents
The platform includes the following specialized agents:
competitive_analysis_agent: Analyzes competitive positioning
consumer_insights_agent: Analyzes consumer behavior and sentiment
market_sizing_agent: Estimates market size and growth
market_trends_agent: Identifies emerging trends
Research Tools
The platform provides various research tools:
search_news: Searches for recent news articles
analyze_competitors: Analyzes competitive landscape
consumer_sentiment_analysis: Analyzes sentiment about products/services
market_size_estimation: Estimates market size and growth
swot_analysis: Performs SWOT analysis for companies
š Dependencies
Major dependencies include:
langchain: For creating and managing AI agents
openai: For accessing GPT-4o and other OpenAI models
streamlit: For the web interface
nltk: For sentiment analysis
beautifulsoup4: For web scraping
matplotlib: For data visualization
pandas: For data manipulation
Optional dependencies:
yfinance: For financial data on public companies
googlemaps: For local business data
serpapi: For enhanced web search
ā ļø Troubleshooting
API Key Issues
If you encounter errors related to API keys:
Verify that your
.env file contains the correct API keysEnsure the environment variables are being loaded properly
Check that your API keys are active and have sufficient quota
Rate Limiting
If you encounter rate limiting issues:
Reduce the number of consecutive requests
Implement retry logic with exponential backoff
Consider upgrading your API plans for higher rate limits
Missing Dependencies
If you encounter missing dependencies:
For optional dependencies:
š¤ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
š License
This project is licensed under the MIT License - see the LICENSE file for details.
š Acknowledgements
OpenAI for GPT-4o
LangChain for the agent framework
All the data providers and API services that make this platform possible
1 like Ā· 9 views Ā· Jul 12, 2025
Developed an AI-powered market research platform with specialized agents for in-depth analysis.
Timeline
Jun 16, 2025 - Jul 7, 2025