Repository avatar
Other Tools
v0.2.7
active

japan-ec-apify-mcp

io.github.atushi1841/japan-ec-apify-mcp

Japan EC Apify MCP. Apify:apify.com/fruitful_quintessence | Gumroad:atushi5.gumroad.com/l/kutuxe

Documentation

japan-ec-apify-mcp

An x402-enabled Model Context Protocol (MCP) server wrapping Apify Actors for Japanese e-commerce marketplaces (Mercari Japan, Yahoo! Auctions, Rakuten, SUUMO, Kakaku.com).

Enables AI agents (Claude Desktop, Cursor, AutoGPT) to execute paid API searches on-demand using the x402 protocol ($0.001 USDC / call).

Features

  • x402 Micropayments Protocol Support: HTTP 402 / EIP-712 payment authorization for AI agents
  • Apify Actor Integration: Directly connects with fruitful_quintessence/mercari-japan-search-scraper
  • Multi-Transport: Runs over stdio, HTTP / SSE
  • Official MCP Registry Compatible: Registered on modelcontextprotocol.io registry

Installation & Usage

1. FastMCP stdio / Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "japan-ec-apify-mcp": {
      "command": "python3",
      "args": ["/path/to/scripts/mcp_x402_server.py"]
    }
  }
}

2. x402 Payment Flow Example

When calling search_mercari_japan(keyword="CBR250RR"):

  1. Server returns isError: true with x402 PaymentRequired payload ($0.001 USDC required).
  2. Agent signs EIP-712 payment authorization and re-sends request with _meta["x402/payment"].
  3. Server validates payment signature, retrieves Mercari listings, and returns data with _meta["x402/payment-response"].

Verification

python3 -m py_compile scripts/mcp_x402_server.py

Related Links


Data & Store