Skip to content

README.md

Latest commit

 

History

History
121 lines (93 loc) · 4.92 KB

README.md

File metadata and controls

121 lines (93 loc) · 4.92 KB
Raw

Image

Amazon Multi-AI Agents

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

TypeScript Next.js React Tailwind CSS shadcn/ui

OpenAI Anthropic Google Gemini

License: MIT Multi-Agent AI

✨ 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