For AI agents
この店は、AIから直接買えます
人が見る画面とAIが使うインターフェースを、同じ在庫・同じ計算ロジックの上に載せています。 スクレイピングは不要です。下のどれを使っても、店の答えは1つです。
MCPで繋ぐ(推奨)
Claude Desktop や Claude Code などのMCP対応クライアントに、次の設定を追加してください。
{
"mcpServers": {
"hibinoba": {
"type": "http",
"url": "https://<このサイト>/api/mcp"
}
}
}公開しているツール
search_products取扱商品を検索する。イヤモニなどのオーディオから駄菓子まで扱っている。キーワード・カテゴリ・ブランド・価格帯で絞り込み、並び順も指定できる。お客さんの要望を聞いたらまずこれを呼ぶこと。結果には店主の接客メモ(aiHints)が含まれる。
get_product商品slugを指定して1件の詳細(価格・在庫・スペック・アレルゲン・背景ストーリー・レビュー)を取得する。スペックやレビューを聞かれたら必ずこれを呼ぶこと。
quote_cart商品と数量の組み合わせから合計金額・送料・クーポン割引を計算する。金額を答える前に必ずこれで確認し、推測で計算しないこと。
place_order注文を確定する。実際に注文が記録されるため、購入内容と届け先をユーザーに確認してから呼ぶこと。在庫を超える数量や存在しない商品が含まれる場合はエラーになるので、事前に quote_cart で issues が空であることを確かめること。
shop_info店の基本情報(送料・支払い・配送・事業の背景)とカテゴリ一覧を取得する。
REST APIで叩く
- GET
/api/products?q=イヤモニ&max_price=30000&sort=rating商品検索 - GET
/api/products/{slug}商品詳細 - POST
/api/quote金額・送料・クーポンの計算 - POST
/api/orders注文の確定 - GET
/api/reviews?slug={slug}レビュー取得 - POST
/api/mcpMCP (JSON-RPC 2.0) - GET
/llms.txt店の概要と全商品のテキスト版 - GET
/.well-known/ucpUCP プロフィール(対応能力の宣言) - POST
/ucp/v1/checkout-sessionsUCP チェックアウト(要認証) - GET
/feed.xmlMerchant Center 向け商品フィード
取引条件
- 送料
- ¥500(割引後の小計が ¥8,000 以上で無料)
- 支払い
- クレジットカード / 銀行振込 / 請求書払い(法人)
- 配送
- 日本国内
- クーポン
HELLO10初回10%OFFSOUKO送料無料NATSU500夏のごあいさつ 500円OFF
お願い
- ・注文は、内容と届け先をユーザーに確認してから実行してください。
- ・金額は必ず
quote_cartで確認してください。四則演算を自前で行わないでください。 - ・食品のアレルギー相談では各商品の
allergensを参照し、不明なときは断定せず店に確認するよう案内してください。 - ・在庫数を超える数量を注文しないでください。
この店の作り
商品カタログは data/products.json の1ファイルだけです。 各商品には店主が自然文で書いた接客メモ(aiHints)が入っていて、AIはそれを読んで接客します。 棚を並べ替えるのではなく、メモを書き換えると店の売り方が変わります。
同じことを自店でも
この店で動いている仕組みを、手順として公開しています。 隠すようなものではありませんし、対応する店が増えたほうが エージェントから買える場所が増えて、結局みんなの得になります。