メルカリ

Retrieve details for a previously saved draft listing by its ID.

Retrieve all saved draft listings with their details.

Fetch detailed information about one or more Mercari products by their IDs. BATCH FETCHING: Provide multiple product IDs to fetch details for several products in a single request. Each product in the results array includes its own error field for partial failures. OPTIONAL DATA: By default, returns core product information (title, price, description, photos, condition, categories). Use optional parameters to include: * include_seller: Seller profile, ratings, sales history, quick shipper status * include_shipping: Shipping method, cost, origin area, delivery timeframe * include_comments: Public user comments and questions under the product listing RESPONSE: Returns a results array where each element corresponds to a requested product_id. EXAMPLES: * Single product: {"product_ids": ["m12345678901"]} * Batch with seller info: {"product_ids": ["m11111111111", "m22222222222"], "include_seller": true} * Full details: {"product_ids": ["m99999999999"], "include_seller": true, "include_shipping": true, "include_comments": true}

Get data from MCP resources. Call with no arguments first to list the available resources.

Search Mercari JP marketplace for products using natural language queries with advanced parsing. Supports price filtering via operators, keyword exclusions, and color filters. Returns product array with id, title, price, condition, status, images, and metadata summary. KEYWORD USAGE: All keywords must match. Fewer words = broader results, more words = narrower results. * Broader: 'iPhone 13 Pro Max' -> 'iPhone 13' * Narrower: 'camera' -> 'vintage film camera' PRICE OPERATORS (in keyword): * '>=5000' = minimum price 5000 yen * '<=10000' = maximum price 10000 yen * '>=5000 <=10000' = price range EXCLUSIONS (in keyword): * '-broken -damaged' = exclude these terms from results COLORS: Standardized Mercari basic colors: black, white, red, blue, green, yellow, pink, purple, brown, gray, beige, navy, khaki, orange, gold, silver. Map similar colors to standards (burgundy->['red'], olive->['green', 'yellow'], ocean->['blue'], etc). Colors work as inclusion filter - results will include any of the colors from the array if filter is provided. PRODUCT URLS: If needed, construct URLs to product pages on Mercari website using product_id from results: * Normal items (product_id starts with 'm'): https://jp.mercari.com/item/{product_id} * Shops items (product_id doesn't start with 'm'): https://jp.mercari.com/shops/product/{product_id} EXAMPLES: * keyword='iPhone 13 >=30000 <=50000 -cracked -broken' * keyword='vintage camera', colors=['black','brown'], only_unused=true * keyword='Nintendo Switch', category_id=859, limit=20

Get a pre-signed upload URL for a listing image. Requirements: - Only JPEG format (.jpg, .jpeg extensions) allowed - Maximum 20 photos per listing - Maximum file size: 10MB (10485760 bytes) After calling this tool, you must: 1. Make an HTTP PUT request to upload_url with the image file binary data 2. Include ALL headers from the "headers" array (each has exact "key" and "value") The response includes a "headers" array with exact HTTP header names and values: - Each header has a "key" (exact HTTP header name, case-sensitive) and "value" - You must include ALL headers exactly as provided - Example headers: Content-Type, Content-Length, x-amz-acl, Cache-Control For AI agents with file access: Use your platform's HTTP client to make a PUT request. Iterate through the headers array and set each header[i].key = header[i].value in your HTTP request. Example pseudo-code: curl -v -X PUT -H "x-amz-acl: public-read" -H "Content-Length: $fileSizeInBytes" -H "Cache-Control: max-age=315360000" --upload-file $File_PATH $upload_url Note: This tool only provides the upload URL and headers. You must separately obtain the image file and upload it.

Create or update a listing draft. MODES: * CREATE: Omit draft_id to create new draft (title required, defaults applied) * UPDATE: Provide draft_id to update existing draft (partial updates supported) CONDITION IDS: * 1: New, unused * 2: Like new * 3: Good, no major damage * 4: Fair, some wear * 5: Poor, visible damage * 6: Bad overall condition SHIPPING PAYER IDS: * 1: Buyer pays * 2: Seller pays (default) SHIPPING DURATION IDS: * 1: 1-2 days * 2: 2-3 days (default) * 3: 3-4 days DEFAULTS (CREATE MODE ONLY): * shipping_method: Always set to 14 (Rakuraku Mercari), not configurable * shipping_payer: 2 (Seller pays) * shipping_duration: 2 (2-3 days) PARTIAL UPDATES (UPDATE MODE): * Only provided fields are updated * Omitted fields remain unchanged PHOTO HANDLING: * photo_paths: Array of photo paths from upload_next_listing_image responses * CREATE: Sets initial photos * UPDATE: Replaces ALL existing photos - provide all photos you want to keep * Maximum 20 photos per listing FINDING IDS: If listing attributes are unknown (category_id, condition_id, brand_id, etc.), consider using search_products to find similar items and reuse IDs from the results. EXAMPLES: * Create minimal: {"title": "iPhone 15 Pro 256GB"} * Create with fields: {"title": "Vintage Camera", "price": 50000, "category_id": 859, "condition_id": 1} * Update single field: {"draft_id": 12345, "title": "Updated Product Name"} * Update multiple: {"draft_id": 12345, "price": 30000, "description": "Updated description"}