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:
- A list of searches in a config file: keywords, maybe a price range and a category.
- A loop that fetches Mercari’s search results for each one every few minutes.
- A memory of item IDs already seen, kept in a file or small database, so only new ones trigger a message.
- 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
| Need | Why |
|---|---|
| An always-on machine | A home server, a Raspberry Pi or a rented cloud server. A laptop that sleeps misses listings. |
| A suitable network location | Some 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 skills | To install dependencies, read error logs and edit the code. |
| A notification channel | A Discord webhook, a Telegram bot token or similar, set up by you. |
| Time for upkeep | When 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:
- Check slowly. Hitting search pages every few seconds puts load on the site and is the quickest way to get blocked.
- Watch a few searches, not hundreds. Each saved search adds requests.
- Never automate buying. Scripts that try to purchase or log in for you are a much bigger risk than a read-only watcher. The guide to Mercari “sniper” tools covers why.
- Keep personal data out of it. A watcher doesn’t need your Mercari login or proxy account, so don’t give it one.
Limits even a working script has
- One marketplace at a time. Most projects cover Mercari only. Yahoo Auctions, Yahoo! Flea Market and Rakuma each need their own code.
- Japanese matching. Titles are in Japanese, so you still need the right words. Japanese search words lists common ones.
- Plain links. A link to jp.mercari.com doesn’t help if you buy through a proxy; you still have to open the item on your proxy’s site by hand, unless you add that conversion yourself.
- No price history. Unless you build it, you see new listings but not what similar items sold for.
Script, bot or app?
| Option | Good for | Trade-off |
|---|---|---|
| Self-hosted script | Developers who enjoy tinkering and want full control | You run, fix and pay for the server |
| Shared Discord or Telegram bot | Following a popular category with a community | Someone else picks the searches; see bots vs an app |
| Alert app | Your own searches without upkeep | Depends 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.