This tutorial shows how to scrape Mercari product data from known item URLs into CSV with the Mercari Product Details Scraper by URL template for UScraper. You will import the workflow, replace sample URLs, set the export path, and validate output.
Before you start
Prerequisites for scraping Mercari product data
Use this approach when you already have a reviewed list of Mercari item URLs. Each row should trace back to one product page.
Prepare:
- UScraper installed as a local desktop app.
- The free Mercari Product Details Scraper by URL template.
- A short test list of Mercari product URLs, preferably five to ten pages.
- A clean output folder for the CSV.
- Permission to access and process the pages.
Review Mercari's current Terms of Service, Prohibited Conduct, and robots.txt before automation.
Technical access is not permission. Do not bypass login walls, CAPTCHA, rate limits, regional restrictions, checkout flows, private account areas, or other access controls.
Workflow anatomy
What the Mercari product detail scraper does
The JSON export is the authoritative sample of the workflow definition:
Navigate -> Wait for Page Load -> Wait for Element -> Sleep
-> Inject JavaScript -> Sleep -> Structured Export -> Loop Continue
Navigate stores the item URLs. Wait and sleep blocks give Mercari's client-side product page time to hydrate. Inject JavaScript creates helpers for title, price, category, condition, delivery, image, description, and unavailable-product signals. Structured Export writes one CSV row, then Loop Continue advances to the next URL.
Output shape
Mercari product details exported to CSV
The export uses Japanese column headers because Mercari Japan pages use Japanese labels. Rename them after validation if your downstream sheet needs English labels.
| CSV column | Meaning | Validation check |
|---|---|---|
商品名 | Product name | Match it to the visible title. |
出品者URL | Seller profile URL | Open the link if present. |
価格 | Current visible price | Confirm the price for this session. |
在庫状況 | InStock, OutOfStock, or NotAvailable | Check sold or deleted state. |
カテゴリー | Category path | Avoid recommendation text. |
商品の状態 | Item condition | Match the product information section. |
配送料の負担 | Shipping payer | Confirm the payer label. |
配送の方法 | Shipping method | Expect blanks when hidden. |
発送元の地域 | Origin region | Check whether the listing shows it. |
配送日の目安 | Delivery or shipping days | Match the page label. |
画像 | Primary product image URL | Open one image URL. |
商品URL | Source product URL | Use it for traceability. |
商品の説明 | Product description | Check long text exports cleanly. |
商品なし | Missing or deleted item message | Blank means the product looked available. |
Runbook
How to scrape Mercari product details by URL
Import the template
Open the Mercari Product Details Scraper by URL page, download the JSON, and import it into UScraper.
Replace the sample URLs
In Navigate, replace the sample item URLs with your own reviewed product-detail URLs. Avoid search pages if you want one row per input.
Keep the waits
Keep Wait for Page Load, Wait for Element, and both Sleep blocks during the first run. Mercari can show loading skeletons before item data is ready.
Set the export path
In Structured Export, replace the sample save location and confirm headers, filename, and append mode.
Run one product first
Export one URL, then compare name, price, condition, delivery fields, image, description, and unavailable status against the browser.
Run the remaining list
When the first row checks out, let Loop Continue process the rest. Pause for blank rows, challenge pages, or unexpected redirects.
Because append mode preserves earlier rows, clear the old CSV or change the filename before a final run.
Quality control
Validate the Mercari CSV export
Open the CSV beside the browser after the dry run. Check the first row, then spot-check the middle and end.
Mercari may have returned a loading skeleton, regional notice, verification page, or unavailable product page. Open the URL manually and rerun one product before editing the workflow.
Alternatives
UScraper, Octoparse, Apify, and Mercari scraper APIs
The best Mercari scraper depends on the job. UScraper fits supervised CSV work from a controlled URL list. Hosted tools and scraper APIs fit remote scheduling or programmatic ingestion.
Best when an analyst has known product URLs and wants a reviewable CSV. You can watch the browser, inspect failed pages, edit selectors, and keep the export local.
Trade-off: you own selector maintenance when Mercari changes markup or access behavior.
For "octoparse mercari scraper alternative" searches, focus on workflow custody and CSV review.
FAQ
Mercari product scraping FAQ
Is it legal to scrape Mercari product data?
Public item pages can still be governed by Mercari terms, robots guidance, intellectual property rights, privacy law, and local regulations. Review the current rules and do not bypass access controls.
Do I need a Mercari account or API key?
No Mercari account credential or API key is embedded in this workflow. It opens the product URLs you provide in your browser session. If Mercari requires login, regional access, or verification, proceed only when allowed.
What fields does the Mercari product detail scraper export?
The CSV includes 商品名, 出品者URL, 価格, 在庫状況, カテゴリー, 商品の状態, shipping fields, 画像, 商品URL, 商品の説明, and 商品なし.
Why are some Mercari rows blank or marked as missing?
Blank or missing rows usually mean the item was deleted, product data did not finish loading, access was restricted, or layout changed. Validate one URL before editing selectors.
Can I scrape Mercari listings instead of item URLs?
Yes, but use the right workflow. The Mercari Product Listings Scraper is better for keyword discovery and search result monitoring. This tutorial covers known item URLs.
Next step
Download the Mercari product scraper by URL
Open the Mercari Product Details Scraper by URL, import the JSON into UScraper, and validate one CSV row before scaling. For discovery, browse the UScraper template library, or return to the UScraper blog.