Alshhbaa Copperware — نحاسيات الشهباء

Alshhbaa Copperware AI Agent Kit 🏺✨

Alshhbaa Copperware（متجر نحاسيات الشهباء） 公式のAIエージェント統合キットです。手作りの真鍮製シャンデリア、イスラム様式・伝統様式の照明、壁付け照明、高級テーブルランプ、ボヘミアンクリスタル、イタリア製ガラス製品を専門に扱う、サウジアラビアを代表する職人小売店です。

このリポジトリには、自律型AIエージェント、コーディングアシスタント、LLM（Claude、ChatGPT、Cursor、Google Antigravity、OpenClaw、Cline）がAlshhbaa Copperwareのストアを安全かつ効率的に見つけ、検索し、検証し、利用するために必要なすべてが含まれています。

---

📦 内容

alshhbaa-agent-kit/
├── README.md                          # Main documentation and integration overview
├── AGENTS.md                          # Detailed instructions & guidelines for AI agents
├── plugin.json                        # Agent Plugins 1.0.0 manifest
├── mcp.json                           # MCP remote streamable HTTP server configuration
├── LICENSE                            # MIT License
├── .gitignore                         # Standard git ignore rules
└── skills/
    └── alshhbaa-store/
        └── SKILL.md                   # Agent skill definition conforming to skills.sh

---

⚡ クイックスタート

1. Model Context Protocol（MCP）で利用する

Alshhbaa Copperwareは、次のリモートストリーミング可能なHTTP MCPサーバーを提供しています。

https://shop.alshhbaa.com/.well-known/mcp

Claude Desktop／Cline／Cursor（claude_desktop_config.json または mcp.json）の場合：

{
  "mcpServers": {
    "alshhbaa-store": {
      "type": "streamable-http",
      "url": "https://shop.alshhbaa.com/.well-known/mcp"
    }
  }
}

サーバーが提供する機能：

• search_products：シャンデリア、ランプ、ガラス製品の公開カタログをすばやく検索するための候補。
• read_docs：ストアの開発者向けガイド、OpenAPI仕様、ポリシー文書にアクセスできます。
• UIリソース：開発者ポータルやカタログ検索画面用のインタラクティブなHTMLコンポーネント。

2. Agent PluginsとSkills（skills.sh）で利用する

alshhbaa-store スキルを直接インストールまたは読み込みます。

• スキルのパス： skills/alshhbaa-store/SKILL.md
• プラグインマニフェスト： plugin.json

このスキルでは、商品の閲覧、サウジアラビア国内の配送業者の料金確認、チェックアウトへの引き継ぎ前のショッピングカートの検証方法をエージェントに説明します。

3. REST APIとOpenAPI 3.1を直接利用する

OpenAPI仕様の完全版には、次のURLからアクセスできます。

https://shop.alshhbaa.com/openapi.json

主なREST APIエンドポイント：

エンドポイント	メソッド	説明	認証
/api/v1/products	GET	フィルターに対応した、カーソルベースのページネーションによるカタログ一覧	なし（公開）
/api/v1/search/suggestions	GET	クエリ ?q= による高速な検索候補	なし（公開）
/api/v1/cities	GET	配送対象となるサウジアラビアの都市を検索	なし（公開）
/api/v1/shipping-carriers	GET	都市と商品に基づくリアルタイムの配送見積もり	なし（公開）
/api/v1/cart/sync	POST	サーバー側でのカート検証と在庫確認	なし（Idempotency-Key）
/api/v1/orders/{id}/status	GET	注文の処理状況と配送追跡	顧客トークン
/api/v1/orders/{id}/invoice/jobs	POST	PDF請求書の非同期生成	顧客トークン

---

🛡️ ガバナンスと人間参加型（HITL）のガードレール

Alshhbaa Copperware では、/.well-known/agent-permissions.json で定義されている厳格なエージェント権限を適用しています。

1. 人間参加型のチェックアウト： AI エージェントは検索、閲覧、送料の見積もり、カートの同期を行えます。ただし、チェックアウトと支払いには明示的な人間の確認が必要です。エージェントが自律的に支払いを完了することは決して許可されません。
2. 支払いのセキュリティ： エージェントは、クレジットカード情報や CVV を決して取得、保存、送信してはなりません。すべての取引は https://shop.alshhbaa.com/checkout で安全に完了します。
3. ハルシネーションの禁止： 商品価格、在庫状況、配送料は API から取得する必要があります。
4. データプライバシー： 注文トークンと顧客情報は非公開に保つ必要があります。管理用エンドポイント（/admin）へのアクセスは厳格に禁止されています。

ルールとエージェントへの指示の全文は、AGENTS.md をご覧ください。

---

🌐 公開ディスカバリーエンドポイント

• ストアフロント： shop.alshhbaa.com
• OpenAPI 3.1： shop.alshhbaa.com/openapi.json
• MCP サーバーカード： shop.alshhbaa.com/.well-known/mcp/server-card.json
• エージェントスキルのインデックス： shop.alshhbaa.com/.well-known/agent-skills/index.json
• エージェント権限： shop.alshhbaa.com/.well-known/agent-permissions.json
• LLM 向け概要： shop.alshhbaa.com/llms.txt & shop.alshhbaa.com/agenticweb.md
• 開発者ポータル： shop.alshhbaa.com/developers

---

📄 ライセンス

このリポジトリは MIT License の下でライセンスされています。 Copyright (c) 2026 Alshhbaa Copperware (متجر نحاسيات الشهباء).