Doorzo Deal Monitor

A tool that finds good deals on Japanese shopping sites and alerts you when something worth buying shows up.

It searches doorzo.com — a proxy-shopping service that combines 9 Japanese marketplaces: Mercari, Rakuma, PayPay Flea, PayPay Mall, Rakuten, Yahoo Auctions, Amazon Japan, Lashinbang, and SNKRDUNK.

No AI needed to use it. No browser automation or scraping either — it talks to doorzo's own API directly.

---

What it does

• Search for a keyword (e.g. マリオパーティ or nintendo switch) across all 9 marketplaces at once.
• Filter by price — set a ceiling in Australian dollars in the web UI.
• Spot discounts — shows the list price vs. the sale price and the % off.
• Monitor keywords — tell it "alert me when a Mario Party game appears for under A$30". It checks in the background and notifies you (macOS notification + a log file).
• Trending searches — see what people are hunting for right now.
• Live AUD prices — the web UI converts Doorzo's JPY prices and price ceilings using Doorzo's current AUD rate.
• Open via Doorzo — product and alert links stay inside Doorzo instead of sending you to the underlying marketplace.
• Choose how to buy — narrow results to Buy It Now listings or auctions.
• Avoid junk listings — hide likely junk, broken, untested, or parts-only items by default; show or isolate them when wanted. Flagged results carry a clear JUNK / PARTS label and reason.

Two ways to use it

	Web UI	AI (MCP)
Who uses it	You, in a browser	An AI assistant like Claude Code
How it looks	A website at http://127.0.0.1:8756	Tools the AI can call
Best for	Browsing, adding monitors, checking alerts	Asking the AI to find/watch deals for you

Both share the same data and the same monitors.

---

Getting started (3 steps)

1. Install. You need Python 3.11+ and uv (a Python tool installer).

git clone https://github.com/TESTYEE-09/DoorzoMCP.git
cd DoorzoMCP
uv sync

2. Start the web UI.

uv run doorzo-web

3. Open your browser at http://127.0.0.1:8756 — done.

Search something, or add a monitor: give it a name, a keyword, and a max price. Click Check all monitors to check for new matches right now. New matches fire a macOS notification and appear in the Alerts list.

The web UI displays and accepts prices in AUD. Internally, monitor ceilings are converted to JPY so the web UI and MCP server can continue sharing the same backward-compatible state. Product links open through Doorzo, where you can review or purchase the listing using Doorzo's proxy-shopping flow.

Your monitors and alerts are stored in ~/.doorzo-mcp/ and survive restarts. Set DOORZO_STATE_DIR before starting either service only if you want to keep that state somewhere else.

---

Letting an AI use it (optional)

If you use Claude Code (or another MCP-compatible assistant), you can give it access to the same search and monitors:

claude mcp add doorzo-deals -- uv run --directory /path/to/DoorzoMCP doorzo-mcp

The AI then has these tools: doorzo_search, doorzo_hot_searches, doorzo_exchange_rate, doorzo_monitor_add, doorzo_monitor_remove, doorzo_monitor_list, and doorzo_check_monitors. Example: "add a monitor for a Mario Party game under ¥3,000 and check it now" — it will do that and tell you what it found.

The MCP tool parameters and returned price fields remain in JPY. This keeps the public tool contract stable for existing agents; AUD conversion is a web UI feature.

---

Project layout

doorzo_mcp/
  client.py   # talks to doorzo.com's API
  deals.py    # decides what counts as a deal
  store.py    # saves your monitors and alerts (~/.doorzo-mcp)
  notify.py   # macOS notifications
  server.py   # the AI (MCP) tools
  web.py      # the website and its API
  static/     # the web page itself (single file, no build step)

---

Things to know

• Prices are before proxy fees. You still pay doorzo's service fee and international shipping. The tool finds cheap listings.
• AUD amounts are estimates. Doorzo's live rate is used, and the final amount may differ when Doorzo processes the purchase.
• Condition text comes from the sites in Chinese; this tool translates it to English (unknown labels pass through as-is).
• The API could change. doorzo.com is an unaffiliated third party; this project uses its internal API with no authentication, so it may break if they change things or add bot protection.
• MIT licensed. Use at your own risk. Not affiliated with or endorsed by doorzo.com.