shopify

Execute Shopify Admin and Storefront GraphQL operations via curl.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you access Shopify Admin and Storefront data from the command line without an SDK, so you can read, create, and update products, orders, customers, inventory, and metafields reliably.

Core Features & Use Cases

  • Shopify Admin GraphQL via curl + jq: Use Shopify GraphQL endpoints with correct headers and JSON payloads, including mutations and error checking.
  • Admin vs Storefront GraphQL separation: Perform private read/write admin work while using storefront tokens for public, customer-facing reads.
  • Practical workflows: Product search/pagination, fetching full product details with variants/metafields, order lookup, customer CRUD, inventory adjustments, and metafields read/write.

Quick Start

Use the shopify skill to fetch the first 20 active products by running the prompt: "List 20 active Shopify products with id, title, handle, total inventory, and first 5 variants (id, sku, price, inventoryQuantity)."

Frequently Asked Questions about shopify

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

FAQPage Schema
How do I query Shopify Admin API data using curl without an SDK?

Use Shopify GraphQL endpoints with curl POST requests, correct headers, and JSON payloads to retrieve and manage commerce data. This approach handles product search, order lookup, and inventory adjustments directly from the command line without needing an SDK.

What's the best way to handle Shopify GraphQL pagination and bulk workflows from the command line?

Handle Shopify GraphQL pagination by implementing cursor pagination within curl requests. This Skill supports cursor workflows to fetch large datasets sequentially and includes robust handling for GraphQL errors and userErrors during bulk operations.

Do I need separate tokens for Shopify Admin and Storefront GraphQL operations?

Yes, you need separate environment variables for Shopify Admin and Storefront GraphQL access. Admin tokens enable private read and write operations, while storefront tokens are used for public, customer-facing reads to ensure proper access separation.

Can I adjust inventory and write metafields via Shopify GraphQL using curl?

Yes, you can adjust inventory and write metafields via Shopify GraphQL using curl. This Skill supports inventory set operations and metafields/metaobjects reads and writes by sending structured JSON payloads through curl requests.

How do I check for userErrors when running Shopify GraphQL mutations with curl?

Check for userErrors by parsing the JSON response returned by your curl request after running Shopify GraphQL mutations. This Skill ensures robust handling of GraphQL errors and userErrors to validate data creation and updates.

When should I use curl instead of an SDK for Shopify Admin API operations?

Use curl instead of an SDK for Shopify Admin API operations when you need a lightweight, dependency-free method to read, create, and update commerce data. It is ideal for quick scripts, bulk workflows, and environments where installing SDKs is impractical.