furima-mcp
Provides tools for searching Rakuma, Rakuten's Japanese flea market, and researching prices from recent sold listings, including sold-price statistics, price percentile checks, and individual listing details.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@furima-mcp Is ¥30,000 a good price for a Switch OLED?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
furima-mcp
English | 日本語
An MCP server for Japanese second-hand marketplaces. It lets Claude, Cursor or any MCP client search Mercari, Yahoo! Auctions, Yahoo! Flea Market (PayPay Flea Market) and Rakuma at once, and check what an item actually sells for.
You: Is ¥30,000 a good price for a Switch OLED?
Claude: (calls
check_price) Not really. Across 214 recent sales on Mercari, Yahoo! Auctions and Rakuma the median was ¥25,000 and the middle half sold for ¥22,000–28,000. ¥30,000 is dearer than 82% of them.
No browser, no login, no API key. Plain HTTP; a search across all four sites takes a few seconds.
Prices come from sold listings, not asking prices: Yahoo! Auctions final bids, Mercari and Rakuma sold items.
One site failing doesn't fail the call. Its error is reported next to the other sites' results.
Polite by default: requests to each site are spaced at least 1 s apart,
429/503responses are retried with backoff, and repeated searches are served from a 5-minute cache.
Tools
Tool | What it does |
| Search items for sale now. Filter by site and price, sort by relevance, newest or price across all sites. |
| Min / p25 / median / p75 / max of recent sold prices, overall and per site, with example sales. |
| Where a price falls among recent sales (percentile) and a one-line verdict. |
| Full details of one listing URL: description, condition, images, seller rating, auction end time. |
Every tool takes exclude (drop titles containing these words, e.g. ["ジャンク", "箱のみ"]). The price tools also take match_all_words (on by default) because the sites' own search is fuzzy: on Mercari, PS5 CFI-2000 also returns PS5 games, which would drag the median down to a game's price.
Related MCP server: TrySellr MCP Server
Install
Needs uv.
Claude Code
claude mcp add furima -- uvx --from git+https://github.com/fxia0018/furima-mcp furima-mcpClaude Desktop, Cursor and others — add to the client's MCP config (claude_desktop_config.json, .cursor/mcp.json, ...):
{
"mcpServers": {
"furima": {
"command": "uvx",
"args": ["--from", "git+https://github.com/fxia0018/furima-mcp", "furima-mcp"]
}
}
}Things to ask
「ドラクエ3 SFC 箱説付き」の相場を調べて
Find a Pokémon card "ピカチュウ 25th プロモ" under ¥5,000, cheapest first, no PSA-graded ones
Compare what a used Sony α7 III body sells for on Yahoo! Auctions vs Mercari
Is this a good deal? https://jp.mercari.com/item/m12345678901
Search in Japanese for best results. Product names and model numbers (CFI-2000, ILCE-7M3) match far better than English descriptions.
Notes
Sold history comes from Yahoo! Auctions' closed auctions and Rakuma's sold items (most recent first) and Mercari's sold items (best match first). Yahoo! Flea Market has no public sold history, so it only appears in
search_listings.Auction prices (
is_auction: true) are current bids and may still rise untilends_at.Mercari's
sold_atis the item's last update time, which is normally the sale.Mercari Shops products show up in search but
get_listingdoesn't support them yet.
Configuration
Environment variables, all optional:
Variable | Default | Meaning |
|
| Minimum seconds between two requests to the same site. Raising it is fine; lowering it is not recommended. |
|
| Seconds a site's search result is reused for an identical query. |
Responsible use
This tool reads the same public pages a person sees in a browser, one search at a time, on behalf of the person asking. It is meant for personal shopping and price research.
Please don't use it for bulk scraping, for building a database of other people's listings, or for automated buying or reselling. It carries no account, cookie or personal data, and adding any is out of scope. If a site's operator asks for something to change, open an issue and it will be handled.
Disclaimer
furima-mcp is an independent, unofficial project. It is not affiliated with, endorsed by or sponsored by Mercari, Inc., LY Corporation, Rakuten Group, Inc. or any marketplace it reads. All product names, trademarks and listing content belong to their respective owners.
The sites can change or restrict access at any time, and results may be incomplete, delayed or wrong. Prices and verdicts are informational, not financial or purchasing advice; check the listing itself before you buy. You are responsible for complying with each site's terms of service and the laws that apply to you. The software is provided as is, without warranty of any kind; see LICENSE.
Development
git clone https://github.com/fxia0018/furima-mcp && cd furima-mcp
uv sync
uv run pytest # offline tests against hand-written page fixtures
uv run pytest -m live # one smoke test against the real sitesEach site is one module in src/furima_mcp/sites/ with a search(client, query) and an item(client, url). Adding a site means adding a module there and registering it in sites/__init__.py.
License
MIT
Available Tools
4 toolscheck_priceARead-only
Judge whether a price is cheap or expensive against recent sold prices.
Returns the price's percentile among recent sales (0 = cheaper than every sale, 100 = dearer than every sale), a one-line verdict, and the sold-price statistics.
Inputs: price (required), query (required), sites, sample, +4 more.
get_listingBRead-only
Full details of one listing: price, status, condition, description, images and seller.
Inputs: url (required).
search_listingsARead-only
Search listings that are for sale now on Japanese marketplaces.
Returns the merged listings (site, title, price in JPY, url, image, and for auctions the current bid count and end time), the total matches each site reports, and any site that failed.
Inputs: query (required), sort, sites, exclude, +4 more.
sold_price_statsARead-only
What an item actually sells for: statistics over recently sold listings.
Reads the most recent sold listings from Mercari, Yahoo! Auctions (final prices) and Rakuma, and returns count, min, p25, median, p75, max and mean overall and per site, plus a few recent sales as examples.
Inputs: query (required), sites, sample, exclude, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools are mostly distinct: search_listings finds items, get_listing retrieves details, sold_price_stats provides historical statistics, and check_price evaluates a specific price. The main potential overlap is between sold_price_stats and check_price, since check_price also returns the sold-price statistics, but the descriptions make the intended use cases clear.
All names use consistent snake_case, and three follow a clear verb_noun pattern (search_listings, get_listing, check_price). The exception is sold_price_stats, which is noun-based, but it remains readable and predictable in context.
Four tools is well-scoped for a niche Japanese marketplace price-research server. Each tool maps to a distinct step in the workflow: search, inspect a listing, get sold-price statistics, and judge a price.
The core research workflow is covered: find current listings, retrieve details, analyze recent sold prices, and evaluate a price. Minor gaps exist, such as no seller-focused lookup or category browsing, but agents can reasonably work around these limitations.
Maintenance
Related MCP Connectors
Remote MCP server that gives Claude, ChatGPT, Cursor or any MCP client Google search volume, CPC, competition and similar keywords for 50+ countries. Works with no signup at 20 lookups a day; sign in with OAuth or an API key for higher limits, or $4.99 a month for unlimited.
AMZScout Skill + MCP gives AI agents live access to real Amazon marketplace data across 14 Amazon marketplaces. Analyze any ASIN, validate product ideas, research niches, compare competitors, discover profitable keywords, and build data-driven PPC strategies using trusted Amazon insights instead of AI assumptions. Works with Claude, ChatGPT, Cursor, and any other MCP-compatible AI client. To connect, you'll need an AMZScout API plan and authorize your account. Get access and view pricing here: https://learn.amzscout.net/amazon-product-api-for-ai-agents
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Shopping MCP for AI agents: search, compare, Amazon buy links. Auto-register.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server to search Mercari Japan listings with query, price range, and exclude keywords.15MIT
- AlicenseNot gradedqualityDmaintenanceAI-powered selling intelligence for multiple online marketplaces, enabling item analysis, optimized listings, pricing checks, negotiation coaching, and batch operations via any MCP-compatible AI assistant.MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching Mercari Japan products with keyword, price range, condition, and status filters, and supports bulk searches from files with automatic translation to English.MIT
- AlicenseAqualityCmaintenanceEnables querying and comparing prices, availability, ratings, reviews, and seller details from major Russian and Chinese marketplaces (Wildberries, Ozon, Yandex Market, and others) without requiring API keys, via a unified MCP interface.2425MIT