Software Tools Analysis Agent

This software tools analysis agent helps developers determine the best software tools and services through RAG market research. Use this agent to evaluate the pros and cons of specific tools and explore other competing options to determine the best tool for your project.

Overview

This project contains two different implementations of the software tools analysis agent:

1. Simple Agent (simple-agent/) - A basic implementation using MCP (Model Context Protocol) with Firecrawl for web scraping
2. Advanced Agent (advanced-agent/) - A more sophisticated implementation with structured analysis and comprehensive tool comparison

Features

• 🔍 Web Scraping & Research: Automatically scrapes and analyzes tool websites
• 📊 Structured Analysis: Provides detailed comparisons including pricing, tech stack, and features
• 🛠️ Tool Extraction: Identifies relevant tools from articles and search results
• 💡 Developer Recommendations: Offers insights and recommendations based on analysis
• 🔗 API & Integration Analysis: Evaluates API availability and integration capabilities

Prerequisites

• Python 3.11 or higher
• OpenAI API key
• Firecrawl API key (for web scraping capabilities)

Setup

1. Clone the Repository

git clone <repository-url>
cd software-tools-agent

2. Set Up Environment Variables

Create a .env file in the root directory or in each agent directory:

# Required for both agents
OPENAI_API_KEY=your_openai_api_key_here

# Required for web scraping functionality
FIRECRAWL_API_KEY=your_firecrawl_api_key_here

3. Install Dependencies

For Simple Agent

cd simple-agent
pip install -e .
# or if using uv
uv sync

For Advanced Agent

cd advanced-agent
pip install -e .
# or if using uv
uv sync

Usage

Simple Agent

The simple agent provides basic web scraping and analysis capabilities using MCP tools.

cd simple-agent
python main.py

Example queries:

• "Compare React state management libraries"
• "Find the best CI/CD tools for Node.js"
• "What are the top database solutions for startups?"

Advanced Agent

The advanced agent provides comprehensive analysis with structured output and detailed comparisons.

cd advanced-agent
python main.py

Example queries:

• "Compare React state management libraries"
• "Find the best CI/CD tools for Node.js"
• "What are the top database solutions for startups?"

The advanced agent will provide:

• Tool names and websites
• Pricing models
• Open source status
• Tech stack information
• Language support
• API availability
• Integration capabilities
• Detailed descriptions
• Developer recommendations

Example Output

📊 Results for: React state management libraries

1. Redux
   🌐 Website: https://redux.js.org
   💰 Pricing: Free (Open Source)
   📖 Open Source: True
   🛠️  Tech Stack: JavaScript, TypeScript, React
   💻 Language Support: JavaScript, TypeScript
   🔌 API: ✅ Available
   🔗 Integrations: React DevTools, Redux Toolkit
   📝 Description: Predictable state container for JavaScript apps...

2. Zustand
   🌐 Website: https://github.com/pmndrs/zustand
   💰 Pricing: Free (Open Source)
   📖 Open Source: True
   🛠️  Tech Stack: TypeScript, React
   💻 Language Support: TypeScript, JavaScript
   🔌 API: ✅ Available
   📝 Description: Small, fast and scalable state management...

Developer Recommendations:
- For simple state: Use Zustand
- For complex applications: Use Redux with Redux Toolkit
- For real-time updates: Consider Zustand with persistence

Architecture

Simple Agent

• Uses MCP (Model Context Protocol) for tool integration
• Leverages Firecrawl for web scraping
• LangGraph for agent workflow
• OpenAI GPT-4 for analysis

Advanced Agent

• Custom workflow with LangGraph
• Structured data extraction with Pydantic models
• Multi-step analysis pipeline
• Comprehensive tool comparison

API Keys Required

1. OpenAI API Key: Get from OpenAI Platform
2. Firecrawl API Key: Get from Firecrawl

Troubleshooting

Common Issues

1. API Key Errors: Ensure your .env file contains valid API keys
2. Import Errors: Make sure you've installed all dependencies
3. Network Issues: Check your internet connection for web scraping

Getting Help

• Check the logs in each agent directory
• Verify your API keys are valid and have sufficient credits
• Ensure you're using Python 3.11 or higher

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request