For AI agents

この店は、AIから直接買えます

人が見る画面とAIが使うインターフェースを、同じ在庫・同じ計算ロジックの上に載せています。 スクレイピングは不要です。下のどれを使っても、店の答えは1つです。

01

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

    店の基本情報(送料・支払い・配送・事業の背景)とカテゴリ一覧を取得する。

02

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 向け商品フィード
03

取引条件

送料
¥500(割引後の小計が ¥8,000 以上で無料)
支払い
クレジットカード / 銀行振込 / 請求書払い(法人)
配送
日本国内
クーポン
HELLO10初回10%OFFSOUKO送料無料NATSU500夏のごあいさつ 500円OFF
04

お願い

  • ・注文は、内容と届け先をユーザーに確認してから実行してください。
  • ・金額は必ず quote_cart で確認してください。四則演算を自前で行わないでください。
  • ・食品のアレルギー相談では各商品の allergens を参照し、不明なときは断定せず店に確認するよう案内してください。
  • ・在庫数を超える数量を注文しないでください。
05

この店の作り

商品カタログは data/products.json の1ファイルだけです。 各商品には店主が自然文で書いた接客メモ(aiHints)が入っていて、AIはそれを読んで接客します。 棚を並べ替えるのではなく、メモを書き換えると店の売り方が変わります。

店番と話してみる
06

同じことを自店でも

この店で動いている仕組みを、手順として公開しています。 隠すようなものではありませんし、対応する店が増えたほうが エージェントから買える場所が増えて、結局みんなの得になります。