Skill

standard-agentic-commerce-engine

From sundial-org-awesome-openclaw-skills-4

Enables autonomous agents to interact with headless e-commerce backends via standardized Python API for product discovery, cart management, authentication, and secure sessions. Useful for agentic shopping implementations.

Python

backend

api-development

Install

npx claudepluginhub joshuarweaver/cascade-ai-ml-agents-misc-2 --plugin sundial-org-awesome-openclaw-skills-4

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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.

Supporting Assets

README.mdSERVER_SPEC.mdscripts/commerce.pyscripts/lib/__init__.pyscripts/lib/commerce_client.py

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars586

Forks75

Last CommitFeb 1, 2026

Actions

View Source View Plugin View on GitHub View README

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:

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).
Stateless Headers: Rely on the engine's built-in header management (x-user-account, x-visitor-id) to maintain session integrity without cookies.
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.