shopify-adminShopify Admin API CLI for orders, products, customers, and store management. Uses REST and GraphQL APIs with environment-based authentication.
Install via ClawdBot CLI:
clawdbot install robsannaa/shopify-adminInteract with Shopify Admin API for order management, product operations, customer data, and store analytics.
Required binaries: curl, jq (must be installed and on PATH).
Environment: The script uses only the process environment. It does not source any file (no ~/.openclaw/.env or other dotenv). Set these variables where the OpenClaw agent/gateway runs (e.g. export in shell, or in a file that your gateway loads at startup):
SHOPIFY_STORE_DOMAIN=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_xxxIf the script is run by the agent, ensure the gateway process has these vars (many setups load ~/.openclaw/.env when starting the gateway — then the agent inherits them; the script itself does not read that file).
Base URL: https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/
Endpoint: https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/graphql.json
List orders:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/orders.json?status=any&limit=10" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \
-H "Content-Type: application/json"Get specific order:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/orders/{order_id}.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"List products:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/products.json?limit=50" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Search products:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/products.json?title={title}" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Delete product:
curl -s -X DELETE "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/products/{product_id}.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"List customers:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/customers.json?limit=50" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Get customer:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/customers/{customer_id}.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Get order with customer details:
curl -s -X POST "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/graphql.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "query { order(id: \"gid://shopify/Order/{order_id}\") { id name customer { firstName lastName email } } }"
}'List marketing events (campaigns, UTMs):
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/marketing_events.json?limit=50" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Get specific marketing event:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/marketing_events/{event_id}.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Create marketing event (track campaign):
curl -s -X POST "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/marketing_events.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"marketing_event": {
"event_type": "ad",
"utm_campaign": "spring_sale",
"utm_source": "facebook",
"utm_medium": "cpc",
"started_at": "2026-01-15T00:00:00Z"
}
}'List available reports:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/reports.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Get report (sales, traffic, etc.):
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/reports/{report_id}.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"Get shop analytics/sessions data via GraphQL:
curl -s -X POST "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/graphql.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "query { shop { name analytics { onlineStoreSessions { count } } } }"
}'Get online store sessions (REST):
# Note: Sessions data is typically available via Shopify Analytics API or Reports
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/shop.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" | jq '.shop'Get order with attribution data:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/orders/{order_id}.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" | jq '.order | {id, name, referring_site, landing_site, source_name}'List orders with UTM parameters:
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/orders.json?fields=id,name,referring_site,landing_site,source_name,created_at&limit=50" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"List customer events (visits, actions):
curl -s "https://$SHOPIFY_STORE_DOMAIN/admin/api/2026-01/customers/{customer_id}/events.json" \
-H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN"null via APIX-Shopify-Shop-Api-Call-Limit headerread_orders, write_ordersread_products, write_productsread_customers, write_customersread_analyticsread_marketing_events, write_marketing_eventsread_customer_eventsread_reportsjq for JSON parsing: | jq '.orders[0]'-w "\nHTTP: %{http_code}" to curl for status codesGenerated Mar 1, 2026
A small online retailer uses the skill to fetch recent orders, check order statuses, and retrieve customer details for fulfillment. They automate order tracking and update internal systems with order data, reducing manual entry and improving response times for customer inquiries.
A dropshipping business leverages the skill to list products, search for items by title, and delete outdated listings. They integrate it with inventory management tools to keep product catalogs synchronized, ensuring accurate stock levels and minimizing overselling.
A digital marketing agency uses the skill to create marketing events for campaigns, track UTM parameters, and analyze order attribution data. They generate reports on campaign performance and customer behavior to optimize ad spend and improve ROI for clients.
A customer service team accesses customer data, lists customer events like visits and actions, and retrieves order histories to provide personalized support. They use this information to resolve issues faster and enhance customer retention through targeted follow-ups.
A store owner utilizes the skill to fetch shop analytics, such as online store sessions and sales reports, via REST and GraphQL APIs. They monitor traffic trends and sales data to make informed decisions on inventory and marketing strategies.
Direct-to-consumer businesses sell products online and use the skill for order processing, customer management, and marketing analytics. They rely on real-time data to manage inventory, track sales, and personalize customer experiences, driving revenue through online transactions.
Software-as-a-Service providers integrate the skill into their platforms to offer enhanced Shopify management tools. They automate API calls for clients, providing features like analytics dashboards and marketing automation, generating revenue through subscription fees.
Marketing or development agencies use the skill to manage multiple client stores, handling tasks like product updates, order fulfillment, and campaign tracking. They charge clients for these managed services, creating revenue based on project or retainer agreements.
💬 Integration Tip
Ensure the SHOPIFY_STORE_DOMAIN and SHOPIFY_ACCESS_TOKEN environment variables are set in the gateway process, as the skill does not read external files like .env. Use jq for parsing JSON responses to extract specific data fields efficiently.
Monitor product prices across Amazon, eBay, Walmart, and Best Buy to identify arbitrage opportunities and profit margins. Use when finding products to flip, monitoring competitor pricing, tracking price history, identifying arbitrage opportunities, or setting automated price alerts.
Shopify integration - currently under maintenance. Contact founders@maton.ai for assistance.
Find and compare products online (Google Shopping) and locally (stores near you). Auto-selects best products based on price, ratings, availability, and preferences. Generates shopping list with buy links and store locations. Use when asked to shop for products, find best deals, compare prices, or locate items locally. Supports budget constraints (low/medium/high or "$X"), preference filtering (brand, features, color), and dual-mode search (online + local stores).
Monitor CamelCamelCamel price drop alerts via RSS and send Telegram notifications when items go on sale. Use when setting up automatic price tracking for Amazon products with CamelCamelCamel price alerts.
Navigate Amazon for buying, selling, and affiliating using price tracking, listing optimization, deal analysis, and affiliate link management.
Manage Shopify store data including orders, products, variants, customers, inventory, fulfillments, refunds, returns, and transactions via the Admin REST API.