standard-agentic-commerce-engine – OpenClaw Skill

---

name: standard-agentic-commerce-engine version: 1.2.4 description: A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management. tags: [ecommerce, shopping-agent, commerce-engine, standard-protocol, headless-commerce, agentic-web]

Standard Agentic Commerce Engine

The Standard Agentic Commerce Engine is a production-ready bridge connecting autonomous agents with modern e-commerce backends. By providing a unified, high-precision interface, it allows any digital storefront to become "Agent-Native" instantly.

GitHub Repository: https://github.com/NowLoadY/agent-commerce-engine

Reference Case: Lafeitu

For a production-grade implementation example using this engine, see the Lafeitu Gourmet Skill. It demonstrates the engine specialized for a real-world artisanal food brand.

---

🛠 Tool Priority & Fallback Strategy

To provide the most accurate and efficient experience, follow this priority sequence:

1. API First (Primary): Always attempt to use the commerce.py script first. It provides structured, high-precision data. Configure it via environment variables (COMMERCE_URL).
2. Stateless Headers: Rely on the engine's built-in header management (x-user-account, x-visitor-id) to maintain session integrity without cookies.
3. Self-Correction: If the API returns a 404 for a specific slug discovered via browser, prioritize the API's search results as the source of truth for the backend.

---

🧠 Agent Operational Logic

Follow these logical flows to ensure a high-quality user experience:

1. Product Discovery & Validation

Goal: Ensure the item exists and find the correct specifications before taking action.

• Action: Always run search or list before adding to cart.
• Logic: Use the API to discover the correct slug and valid gram/variant values.
• Refinement: If multiple results are found, ask the user to specify based on the returned attributes.

2. Authentication & Profile Flow

Goal: Manage user privacy and session data.

• Logic: The API is stateless. Actions requiring identity will return 401 Unauthorized if credentials aren't saved.
• Commands:
  1. View profile: python3 scripts/commerce.py get-profile
  2. Update details: python3 scripts/commerce.py update-profile --name "Name" --address "..."
• Required Data: Respect the schema of the specific brand's backend.

3. Registration Flow

Goal: Handle new users.

• Trigger: When an action returns "User Not Found".
• Instruction: Guide the user to the store's registration URL (often found in brand metadata).

4. Shopping Cart Management

Goal: Precise modification of the user's shopping session.

• Logic: The engine supports incrementing quantities or setting absolute values.
• Commands:
  • Add: python3 scripts/commerce.py add-cart <slug> --gram <G> --quantity <Q>
  • Update: python3 scripts/commerce.py update-cart <slug> --gram <G> --quantity <Q>
  • Remove: python3 scripts/commerce.py remove-cart <slug> --gram <G>
• Validation: Gram/variant values must be strictly chosen from the product's available options list.

5. Brand Information & Storytelling

Goal: Access brand identity and support data.

• Logic: Use the brand-info interface to retrieve narrative content.
• Tooling:
  • python3 scripts/commerce.py brand-story: Get the narrative/mission.
  • python3 scripts/commerce.py company-info: Get formal details.
  • python3 scripts/commerce.py contact-info: Get customer support channels.

---

🚀 Capabilities Summary

• search / list: Product discovery and inventory scan.
• get: Deep dive into product specifications, variants, and pricing.
• promotions: Current business rules, shipping thresholds, and active offers.
• cart: Complete session summary including VIP discounts and tax/shipping estimates.
• add-cart / update-cart / remove-cart: Atomic cart control.
• get-profile / update-profile: Personalization and fulfillment data.
• brand-story / company-info / contact-info: Brand context and support.
• orders: Real-time tracking and purchase history.

---

💻 CLI Configuration & Examples

# Setup
export COMMERCE_URL="https://api.yourbrand.com/v1"
export COMMERCE_BRAND_ID="brand_slug"

# Actions
python3 scripts/commerce.py list
python3 scripts/commerce.py search "item"
python3 scripts/commerce.py get <slug>
python3 scripts/commerce.py add-cart <slug> --gram <variant>

---

🤖 Troubleshooting & Debugging

• Status Code 401: Credentials missing or expired. Recommend login.
• Status Code 404: Resource not found. Verify slug via search.
• Connection Error: Verify COMMERCE_URL environment variable is correct and the endpoint is reachable.

Standard Agentic Commerce Engine

A production-ready universal engine for Agentic Commerce. This tool enables autonomous agents to interact with any compatible headless e-commerce backend through a standardized protocol. It provides out-of-the-box support for discovery, cart operations, and secure user management.

Clawdhub: https://clawdhub.com/NowLoadY/agent-commerce-engine

Why?

As the "Agentic Web" matures, the need for standardized commerce interfaces is paramount. This project provides a production-ready implementation that is:

• Universal & Configurable: Instantly connect to any store by providing the API endpoint via environment variables.
• Protocol-First: Implements a standard toolset (search, cart, profile, orders) precisely optimized for Large Language Models and autonomous agents.
• Production-Ready: Built on a modular, robust client engine that handles identity, sessions, and error states gracefully.

Significance for the Ecosystem

The Standard Agentic Commerce Engine eliminates the friction of building custom integrations for every brand. It serves as a reliable connector that allows agents to navigate catalogs and execute transactions with 100% data integrity across the entire agentic web.

Quick Start (Usage)

1. Configure Environment:

   export COMMERCE_URL="https://your-api-url.com/v1"
   export COMMERCE_BRAND_NAME="Your Brand"
   

2. Run with Agent/CLI:

   python3 scripts/commerce.py list
   

Structure

• SKILL.md: Metadata and instructions for Agent discovery.
• SERVER_SPEC.md: Standard API response and behavior specification for backends.
• scripts/commerce.py: The universal CLI entry point.

License

MIT License - Supporting the open acceleration of Agentic Commerce standards.

---

标准 Agentic 商业交互引擎

面向 Agentic Commerce 的通用核心引擎。本工具提供了一套标准、高精度的协议，用于将自主 Agent 与任何无头 (Headless) 电商后端完美连接。

Clawdhub链接: https://clawdhub.com/NowLoadY/agent-commerce-engine

为什么有这个引擎？

随着“Agent 网络”的成熟，标准化的商业接口是行业基石。本项目提供的生产级实现具有以下核心价值：

• 通用与即插即用：只需提供 API 端点环境变量，即可瞬间接通任何品牌商店。
• 协议优先：实现了一套专为大语言模型和自主 Agent 优化的标准工具集（发现、购物车、资料、订单）。
• 生产级健壮性：基于模块化的客户端引擎构建，优雅处理身份验证、会话管理和异常状态。

对生态系统的意义

标准 Agentic 商业交互引擎 消除了为每个品牌单独构建集成逻辑的繁琐工作。它作为一个可靠的连接器，支持 Agent 在整个 Agentic 网络中以 100% 的数据一致性完成商品浏览与交易。

快速开始

1. 配置环境:

   export COMMERCE_URL="https://your-api-url.com/v1"
   export COMMERCE_BRAND_NAME="你的品牌"
   

2. 通过 Agent 或 CLI 运行:

   python3 scripts/commerce.py list
   

实例

参考如何利用本标准引擎驱动实际的 Agent 商业体验：

• 在线 Skill: 辣匪兔: Authentic Agentic Spicy Food Delivery
• 参考实现源码: 辣匪兔 Skill 仓库

许可协议

MIT License - 一起探讨 Agent 商业标准的开放进程。