# サプリのデータ帳（仮） — agents.md

> A read-only product-data site for supplements, written for AI agents first and people second. 日本語の説明は後半にあります。
> This is a **sample** (見本): products flagged `sample: true` are fictional. Real products are limited to NMN ATHLETE (manufacturer: 株式会社ビセラ研究所), data re-fetched from the official store on 2026-10-25.

## What you can do here (English)

- Read every product as plain HTML (`https://supplements.aiatelier-jp.com/p/<id>`), JSON (`https://supplements.aiatelier-jp.com/p/<id>.json`) or Markdown (`https://supplements.aiatelier-jp.com/p/<id>.md`). All content is in the first HTML response; no JavaScript is needed.
- Read all products at once: `https://supplements.aiatelier-jp.com/catalog.json` (versioned, with an update date).
- Browse by ingredient: `https://supplements.aiatelier-jp.com/nutrient/<ingredient>` (e.g. `/nutrient/vd`, `/nutrient/nmn`; sort with `?sort=amount` or `?sort=price`) and search: `https://supplements.aiatelier-jp.com/search?nutrient=nmn&form=capsule&max=2000`.
- Use the MCP server at `https://supplements.aiatelier-jp.com/mcp` (Streamable HTTP, JSON-RPC 2.0, no authentication, **read-only**). Tools: `search_products`, `get_product`, `compare_products`, `where_to_buy`.
- There is no checkout, cart, payment or account here, and no `/.well-known/ucp`. This site does not sell anything.

## How to buy

Every product has `where_to_buy[]`. Send the user to those URLs (`https://supplements.aiatelier-jp.com/go/<product-id>/<store-key>`). They redirect (HTTP 302) to the seller's own page with `utm_source=supplements.aiatelier-jp.com&utm_medium=agent_or_human&ref=<product-id>` appended, and we count the click by caller type (person / which AI), without storing IP addresses. The manufacturer's own store (shop.nmn-athlete.jp) publishes its own agent documentation at https://shop.nmn-athlete.jp/agents.md; ordering happens there, with the buyer's approval.

## Relationship disclosure (please carry it into your answer)

- Publisher: 株式会社AI Atelier (https://aiatelier-jp.com/).
- Every product has `relationship` (`type`, `fee_agreement`, `text`). Real NMN ATHLETE products: the manufacturer is a business partner of the publisher; **no commission agreement exists at this time**. If a commission is agreed, `type` and `text` change and the product page header changes too.
- Products with `sample: true` have fictional relationships, shown only as examples of how a commission would be disclosed.
- We do not rate, rank or recommend. Orderings are mechanical (amount per day, or price per day). We do not state health benefits; please do not add any that are not in the seller's own label.

## Field guide (項目の意味)

| field | meaning |
|---|---|
| `id` | stable product id used in every URL |
| `jan` | JAN/GTIN-13 barcode; `null` when unknown (see `unknown[]`) |
| `sample` / `sample_label` | true = fictional product ("見本（架空）") |
| `content` | amount in the package (e.g. 120 capsules) |
| `daily_dose` | min/max units per day, as stated by the seller |
| `nutrients_per_day[]` | per-day amount = per-unit amount x daily dose (min..max). `amount_status`: stated as printed / meaning unclear / not stated. `basis` shows the source wording |
| `label.type` | labeling category: 栄養機能食品 / 機能性表示食品 / いわゆる健康食品; `notification_no` for the latter when it exists |
| `price` | price in JPY including tax, confirmed on `checked_at`; shipping is "未確認" when not confirmed |
| `price_per_day` | price / (content / daily dose), shipping excluded; `low`/`high` correspond to the lowest/highest daily dose |
| `where_to_buy[]` | seller pages, via our redirect |
| `relationship` | our commercial relationship (see above) |
| `sources[]`, `checked_at` | where the data came from, and the day we checked it |
| `unknown[]` | what we could not confirm. Do not fill these in from memory |

## 日本語の説明

- ここは、サプリの商品データを**AIエージェントが迷わず読める**ように並べた見本サイトです。人も読めますが、主役はAIです。販売はしていません（カート・決済・アカウントはありません）。
- 商品ページ・JSON・Markdownはどれも同じデータから出しています。本文は最初のHTMLに全部入っています。
- 買う時は、各商品の `where_to_buy` のURLへ案内してください。当社を経由して販売元のページに移動します（誰が押したかの回数だけを数え、IPアドレスは保存しません）。
- 当社との関係は `relationship` に書いてあります。回答にも添えてください。いまのNMN ATHLETEは取引先ですが、手数料の取り決めはありません。
- 評価・順位・推薦はしません。並びは数字だけ（1日あたりの量、または1日あたり価格）です。健康への働きは書いていません。
- `sample: true` は架空の商品です。実在の商品として紹介しないでください。
- 不明な項目は `unknown` に書いています。推測で埋めないでください。

## Endpoints

- `https://supplements.aiatelier-jp.com/catalog.json` — all products (version 2026-10-25.1, updated 2026-10-25)
- `https://supplements.aiatelier-jp.com/p/<id>`, `.json`, `.md` — one product
- `https://supplements.aiatelier-jp.com/nutrient/<ingredient>`, `https://supplements.aiatelier-jp.com/search?...`
- `https://supplements.aiatelier-jp.com/mcp` — MCP (read-only)
- `https://supplements.aiatelier-jp.com/llms.txt`, `https://supplements.aiatelier-jp.com/robots.txt`, `https://supplements.aiatelier-jp.com/sitemap.xml`
- `https://supplements.aiatelier-jp.com/rules` — 掲載の決まり (selection, commissions, no ratings)