Agent Ecommerce Price Monitor v1

Autonomous price monitoring pack for small ecommerce operators who need a repeatable way to detect price drops, competitor pressure, margin risk, and repricing actions before revenue is lost.

This pack is offline-first. It can run from a local JSON export, cron job, ERP dump, Shopify export, marketplace scrape, or any connector you add later. If a local coding-agent CLI is available, it can add a short reasoning summary, but the core scan is deterministic and works without any LLM key.

Who It Is For

• Store operators tracking 10 to 5,000 SKUs across marketplaces.
• Agencies managing repricing and margin alerts for several clients.
• LLM operators who need a safe, auditable pricing assistant.
• Developers who want a clean starter for plugging in Shopify, Amazon, Stripe, Airtable, or crawler data.

Quick Start

cd agent-ecommerce-price-monitor-v1
python3 agent.py --help
python3 agent.py scan --input sample_products.json --output report.json
python3 agent.py status

Expected output: report.json with product-level alerts, recommended actions, and a summary by severity.

What It Does

• Reads a product feed from JSON.
• Computes price-drop percentage, competitor delta, gross margin, and inventory pressure.
• Flags below-MAP pricing, negative margin, stale data, stockout risk, and undercut opportunities.
• Produces deterministic actions such as raise_price, match_competitor, hold_price, review_cost, and restock_watch.
• Optionally asks a BYO-LLM CLI to summarize the report with the prompt stored in PROMPTS.md.

Architecture

 product export / connector
          |
          v
   sample_products.json
          |
          v
   agent.py scan
          |
          +--> deterministic pricing rules
          |
          +--> optional local LLM summary
          |
          v
      report.json
          |
          v
   operator action queue

Honest Limits

• It does not scrape websites by default.
• It does not change prices automatically unless you add a connector.
• It is not financial advice and does not guarantee higher revenue.
• It is built to surface reviewable pricing signals, not to run a black-box repricing engine.

Files

• agent.py - CLI scanner and deterministic pricing engine.
• sample_products.json - offline feed for tests and demos.
• PROMPTS.md - named prompts loaded by agent.py.
• CHECKLIST.md - deployment checklist with commands.
• CUSTOMIZE.md - where to plug your own data and actions.