FiCo – Find&Compare

FiCo is a lightweight Single Page Application that helps you find products online and compare sellers, conditions, pricing, and carbon footprint using live store APIs.

---

Features

• Product Finder with quick search and AI assistant modes
• Live data from eBay Browse API and Amazon Product Advertising API
• Carbon footprint ratings and eco-friendly sorting
• Sorting and filtering (price, store, condition, emissions)
• Favorites saved in browser localStorage
• Price history snapshots per search query
• Optional LLM recommendations via OpenAI or Anthropic
• API Keys UI — add store and AI credentials from the browser (localStorage)

---

Quick Start

Prerequisites

• Node.js (v18 or higher)
• Python 3.x (for emissions calculation)
• eBay and/or Amazon API credentials

Setup

1. Option A — UI (recommended): Open http://localhost:3000/Frontend/, click API Keys, and enter your credentials. Keys are stored in your browser only.

2. Option B — Server .env: Copy .env.example to .env and set keys there (shared for all users of that server).

Configure at least one store API:

• EBAY_CLIENT_ID / EBAY_CLIENT_SECRET
• AMAZON_ACCESS_KEY / AMAZON_SECRET_KEY / AMAZON_PARTNER_TAG

3. Start the server:

   ./start.sh

Open:

• Frontend: http://localhost:3000/Frontend/
• API: http://localhost:3000/api/search?query=iPhone
• Health: http://localhost:3000/health

---

Project Structure

FiCo/
├── Frontend/           # Vanilla JS SPA
├── Backend/            # Express API (routes, services, adapters)
├── Scraper/            # Python emissions engine
├── docs/               # Shared product schema
├── Dockerfile
├── docker-compose.yml
└── start.sh

---

Environment Variables

See .env.example for server-side keys, or use API Keys in the app UI (stored in browser localStorage).

---

License

MIT License – see LICENSE.