shopify

Query Shopify Admin and Storefront GraphQL APIs using curl commands.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill shopify-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shopify
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/productivity/shopify
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill shopify-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a Shopify store programmatically usually requires SDKs or app frameworks; this Skill lets you work with products, orders, customers, inventory, and metafields directly through GraphQL API calls using only curl and an access token. ## Core Features & Use Cases - Product & Catalog Management: Search, paginate, create, and update products and variants via the GraphQL Admin API, including bulk variant mutations. - Orders, Customers & Inventory: Pull recent orders with filters, manage customer records, and adjust or set inventory quantities per location. - Advanced Operations: Run bulk operations for large data dumps, subscribe to webhooks with HMAC verification, and read/write metafields and metaobjects. - Use Case: A merchant asks to list all paid orders from last week, check stock levels for a low-inventory SKU, and update its price — all handled with direct GraphQL queries against the shop's admin endpoint. ## Quick Start Set SHOPIFY_ACCESS_TOKEN and SHOPIFY_STORE_DOMAIN in your environment, then ask the agent to list the 20 most recent paid orders from your Shopify store.

Frequently Asked Questions about shopify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query the Shopify Admin GraphQL API with curl?▼

Send a POST request to https://your-store.myshopify.com/admin/api/2026-01/graphql.json with the header X-Shopify-Access-Token and a JSON body containing your query and variables. Always check the top-level errors array and per-field userErrors, since HTTP 200 does not mean success.

How do I get a Shopify Admin API access token?▼

In Shopify admin, go to Settings, Apps and sales channels, Develop apps, create an app, configure Admin API scopes, and install it. The token starting with shpat_ is shown only once, so copy it immediately. After January 2026, new apps must be created via the Dev Dashboard.

Should I use the Shopify REST API or GraphQL API?▼

Use GraphQL for all new admin work. The REST Admin API has been legacy since 2024-04 and only receives security fixes. GraphQL uses GID string identifiers like gid://shopify/Product/123 instead of the numeric IDs REST returned.

Why does my Shopify API request return 403 with a valid token?▼

A 403 with a valid token means the app is missing the required Admin API scope, such as read_orders or write_products. Re-configure the scopes on the app in Shopify admin, then reinstall the app to regenerate the token.

Why am I only seeing the last 60 days of Shopify orders?▼

Without the read_all_orders scope, order queries silently cap results at the recent window and return no error. Request read_all_orders through the app's protected-data settings to access historical orders.

How do I export all products from Shopify without hitting rate limits?▼

Use a bulk operation: run bulkOperationRunQuery with your products query, poll currentBulkOperation until status is COMPLETED, then download the resulting JSONL file. This bypasses the cost-based rate limits that throttle large paginated queries.