Blog

Self-hosted Mercari Japan watchers: scripts, limits and alternatives

Search GitHub for “mercari watchdog” or “mercari jp scraper notification” and you will find open-source scripts that check Mercari Japan for new listings and send a message to Discord, Telegram, LINE or email. They can work well for a technical user, but they need a machine that runs all day, repairs whenever the site changes, and care not to overload the site. Here is what running one really involves.

How a self-hosted watcher works

Most projects follow the same pattern, whatever language they are written in:

  1. A list of searches in a config file: keywords, maybe a price range and a category.
  2. A loop that fetches Mercari’s search results for each one every few minutes.
  3. A memory of item IDs already seen, kept in a file or small database, so only new ones trigger a message.
  4. A notifier that posts the title, price, photo and link to a chat channel or sends a push.

Some read the same data the Mercari website loads in your browser; others drive a full headless browser. Either way, the script imitates a visitor looking at search results, over and over.

What you need to run one

NeedWhy
An always-on machineA home server, a Raspberry Pi or a rented cloud server. A laptop that sleeps misses listings.
A suitable network locationSome sites respond differently to visitors outside Japan or from data-centre addresses, so a script that works at home may fail on a cloud server.
Basic programming skillsTo install dependencies, read error logs and edit the code.
A notification channelA Discord webhook, a Telegram bot token or similar, set up by you.
Time for upkeepWhen Mercari changes its pages or data format, the script silently stops finding items until someone fixes it.

That last row is the one people underestimate. Open-source watchers are often maintained by one person in their spare time. Check when a project was last updated and whether its issue tracker is full of “stopped working” reports before you invest an evening in it.

Scraping etiquette and the rules

A watcher is automated access to someone else’s service. Before running one, read the marketplace’s terms of use, since many sites restrict automated collection of their pages. Beyond the rules, a few habits keep you from causing trouble:

Limits even a working script has

Script, bot or app?

OptionGood forTrade-off
Self-hosted scriptDevelopers who enjoy tinkering and want full controlYou run, fix and pay for the server
Shared Discord or Telegram botFollowing a popular category with a communitySomeone else picks the searches; see bots vs an app
Alert appYour own searches without upkeepDepends on the app’s plan limits

FleaHunter is the app option: it watches Mercari, Yahoo! Flea Market, Yahoo Auctions and Rakuma for your saved searches, with no server to run, and opens each alert on the proxy you set. The free plan covers a few searches if you want to compare it with your script.

Get the app