japan-market-mcp

Japan Market MCP — Cross-Shop Price Comparison for AI Agents

An MCP server that lets AI agents (Claude, Cursor, VS Code Copilot, ChatGPT) compare used-good prices across leading Japanese shops in a single tool call. Instead of scraping site by site, an agent queries one server and gets inter-store price gaps for the same product — perfect for reseller arbitrage, price monitoring, and market research on the Japanese second-hand market.

How it works

The server wraps market-scraping and official-API actors (Rakuten Ichiba included) behind one MCP endpoint. Each tool returns price, brand, shop, condition and a link per item, with the shop-pair crossed so you see the price spread at a glance.

Available tools

Each tool takes a keyword (e.g. SONY α7, ROLEX, Hermes, Fender) and returns results from the crossed shops. Leaving the keyword empty scans the full category.

Pricing

Pay per event — $0.001 per search + actor start fee. Runs finish in seconds, so a full keyword lookup typically costs well under $0.01.

Connect as an MCP server

Run it from the Apify Store (Run button), then point your MCP client at the endpoint. It stays in standby mode.

MCP client config (Claude Desktop / Cursor / VS Code):

{
  "mcpServers": {
    "japan-market-mcp": {
      "url": "https://fruitful-quintessence--japan-market-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

• URL: --japan-market-mcp.apify.actor/mcp

• Auth: Apify API token in the Authorization: Bearer header (Apify Console → Settings → Integrations)

URL note: use a hyphen in the username (fruitful-quintessence), not an underscore — an underscore hostname will not resolve.

Discovery & registry

• Agent install guide: see llms-install.md — grounded guidance for AI agents (Cline, Claude Code, Cursor) that set up this server for a user.

• MCP discovery manifest: .well-known/mcp.json advertises the endpoint, auth, tool list, and pricing in the standard MCP Directory discovery format.

• Cline MCP Marketplace: submitted for review at cline/mcp-marketplace — once approved it becomes one-click installable from Cline's marketplace.

• Apify Store: deployed as the public actor fruitful_quintessence/japan-market-mcp (pay-per-event).

Related Apify Actors

This MCP server connects to 86+ Apify Actors in the Kensho ecosystem for real-time data. Key related actors include:

Marketplace & Price Comparison

• fruitful_quintessence/japan-market-mcp — Core MCP server

• fruitful_quintessence/japan-anime-figure-price-data — Anime figure prices

• fruitful_quintessence/japan-figure-plamo-resale-price-stats — Figure/plamo resale stats

• fruitful_quintessence/japan-minimum-wage-mcp — Minimum wage data

• fruitful_quintessence/japan-food-delivery-mcp — Food delivery prices

Retail & E-commerce

• fruitful_quintessence/rakuten-japan-mcp — Rakuten Ichiba data

• fruitful_quintessence/japan-kakaku-price-search — Kakaku.com price comparison

• fruitful_quintessence/amazon-japan-bestsellers — Amazon JP bestsellers

• fruitful_quintessence/yahoo-shopping-japan — Yahoo! Shopping

• fruitful_quintessence/mercari-japan-price — Mercari pricing

Used Goods & Auctions

• fruitful_quintessence/yahoo-auctions-japan-scraper — Yahoo! Auctions

• fruitful_quintessence/mercari-japan-search-scraper — Mercari search

• fruitful_quintessence/surugaya-japan-hobby-prices — Suruga-ya hobby

• fruitful_quintessence/mandarake-auction-scraper — Mandarake auction

• fruitful_quintessence/off-mall-japan-scraper — OffMall (Hard Off)

Local Business & Services

• fruitful_quintessence/google-maps-japan-reviews — Google Maps reviews

• fruitful_quintessence/tabelog-japan-restaurants — Tabelog restaurants

• fruitful_quintessence/hotpepper-beauty-salons — Beauty salons

• fruitful_quintessence/japan-post-office-locations — Post offices

Government & Public Data

• fruitful_quintessence/japan-maff-markets — MAFF wholesale markets

• fruitful_quintessence/japan-maff-price-trend — MAFF price trends

• fruitful_quintessence/japan-maff-top-movers — MAFF top movers

• fruitful_quintessence/japan-maff-market-report — MAFF market reports

Specialized Collections

• fruitful_quintessence/japan-anime-figure-demand-features — Anime figure demand

• fruitful_quintessence/japan-vintage-clothing-prices — Vintage clothing

• fruitful_quintessence/japan-used-book-prices — Used books

• fruitful_quintessence/japan-record-store-prices — Record stores

• fruitful_quintessence/japan-toy-collector-prices — Toy collector

MCP Connection Examples

6. External run example (fallback)

# If GitHub API returns 403, use curl + git clone
curl -s https://raw.githubusercontent.com/atushi1841/japan-market-mcp/main/README.md > README.patch
# edit README.patch as needed
git clone https://github.com/atushi1841/japan-market-mcp.git
cd japan-market-mcp
cp ../README.patch README.md
git add README.md
git commit -m "update README via external run"
git push

1. Standard I/O (stdio) — Claude Desktop, Cursor, etc.

In your claude_desktop_config.json:

{
  "mcpServers": {
    "japan-market-mcp": {
      "command": "python",
      "args": ["-m", "src.main"]
    }
  }
}

2. HTTP Server Mode

# Install dependencies
pip install -r requirements.txt

# Run as HTTP server on port 3000
APIFY_TOKEN=your_token python -m src.main --http --port 3000

# Test the endpoint
curl http://localhost:3000/mcp/tools | jq .

3. Direct Python Import

from src.main import mcp
# FastMCP instance can be embedded directly

4. n8n / Apify Workflow (via HTTP)

Use Apify's Webhook node to POST JSON-RPC to POST /mcp endpoint.

5. Docker Deployment

docker build -t japan-market-mcp .
docker run -p 3000:3000 -e APIFY_TOKEN=your_token japan-market-mcp

"Compare used prices for Sony a7 III between Kitamura and Fujiya"
→ search_camera_market(keyword="SONY α7 III")

"What's the inter-store price gap for a Rolex Submariner?"
→ search_watch_market(keyword="ROLEX Submariner")

"What's the market price for a Hermes Birkin 25?"
→ search_luxury_market(keyword="Hermes Birkin 25")

"What's a used Fender Stratocaster going for?"
→ search_instrument_market(keyword="Fender Stratocaster")

"Show this 旬's wholesale market report for Tokyo (Toyosu) fresh vegetables"
→ get_maff_market_report(market="toyosu")