Amazon Multi-AI Agents

Amazon Multi AI Agents for Product Research, Reports & Data Scraping

✨ Features

• End-to-end Product Research — from query to complete report in minutes
• Sophisticated Multi-Agent Architecture with clear role separation
• Real-time Workflow Visualization using React Flow
• Amazon Scraping + intelligent fallback to mock data
• Professional Report Generation (summary, comparison, insights, buying guide, recommendations)
• Optional Shopper Agent for automated purchasing
• Multi-LLM Support: OpenAI, Anthropic (Claude), Google Gemini
• High Resilience: retries, error recovery, Fixer Agent
• Beautiful Modern UI with dark mode and smooth animations

🧠 Agent Architecture

Agent	Responsibility
Orchestrator	Coordinates the entire workflow, manages state and communication
Researcher	Product search, scraping, data enrichment & reviews
Analyzer	Compares products and finds best value / highest rated options
Reporter	Generates comprehensive professional reports
Shopper	(Optional) Automates cart / purchase actions
Fixer	Error handling, retries and fallbacks

🛠 Tech Stack

• Framework: Next.js 16 (App Router) + React 19 + TypeScript
• Styling: Tailwind CSS + shadcn/ui + Radix
• AI: OpenAI, Anthropic, Google Gemini
• Visualization: ReactFlow + Recharts + Framer Motion
• State: Zustand
• Scraping: Cheerio (server-side)

🚀 Quick Start

1. Clone the repository

git clone https://github.com/BroccoliFin/Amazon-Multi-AI-Agents.git
cd Amazon-Multi-AI-Agents

2. Install dependencies

npm install

3. Run locally

npm run dev

Open http://localhost:3000

4. Add API Keys

Go to Settings and configure:

• OpenAI API Key
• Anthropic API Key (optional)
• Gemini API Key (optional)
• Amazon credentials (for Shopper Agent)

📖 How to Use

• Enter a research query (e.g. best wireless noise cancelling headphones under 300).
• Click Start Research.
• Watch agents work in real-time on the Workflow tab.
• Read the final report on the Reports tab.

⚠️ Important Warnings

• Scraping Amazon violates their Terms of Service. Use this project for educational and personal purposes only.
• Shopper Agent stores Amazon credentials — use at your own risk.
• For production scraping stability, consider proxies and official APIs.

📁 Project Structure

├── app/                  # Next.js App Router + API routes
├── components/           # UI Components
├── lib/
│   ├── agents/           # All AI agents logic
│   ├── providers/        # LLM providers
│   └── tools/            # Scraping & utility tools
├── store/                # Zustand store
└── types/

🗺️ Roadmap

• Official Amazon Product Advertising API integration
• Playwright support
• Research history & database
• PDF/Markdown export
• Price tracking & alerts
• Docker support

🤝 Contributing

Pull requests are welcome! Especially improvements in scraping stability, prompt engineering, and UI.

🪪 License

MIT License © BroccoliFin