About

Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/shopify-hello-world/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-hello-world. Copyright stays with the author (MIT).

Shopify Hello World

Name: shopify-hello-world
Author: jeremylongshore

Overview

Minimal working example: query your store's products using the Shopify GraphQL Admin API. Uses @shopify/shopify-api with a custom app access token for zero-friction setup.

Prerequisites

Completed shopify-install-auth setup
A Shopify development store
An Admin API access token (shpat_xxx) from Settings > Apps > Develop apps

Instructions

Step 1: Create Project

mkdir shopify-hello-world && cd shopify-hello-world
npm init -y
npm install @shopify/shopify-api dotenv

Step 2: Configure Environment

# .env
SHOPIFY_STORE=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret

Step 3: Write the Hello World Script

Initialize the Shopify API client with LATEST_API_VERSION (imported from @shopify/shopify-api), create a custom app session, then query shop info and products via GraphQL.

See Hello World Script for the complete implementation.

Step 4: Run It

npx tsx hello-shopify.ts
# Or compile first:
npx tsc hello-shopify.ts && node hello-shopify.js

Output

Expected console output:

Store: My Dev Store
Currency: USD

Products:
  - Classic T-Shirt (ACTIVE, 150 in stock)
      Variant: Small — $29.99 (SKU: TSH-SM)
      Variant: Medium — $29.99 (SKU: TSH-MD)
      Variant: Large — $29.99 (SKU: TSH-LG)
  - Coffee Mug (ACTIVE, 42 in stock)
      Variant: Default Title — $14.99 (SKU: MUG-01)

Success! Your Shopify connection is working.

Error Handling

Error	Cause	Solution
`HttpResponseError: 401 Unauthorized`	Invalid or revoked access token	Regenerate token in Shopify admin > Settings > Apps
`HttpResponseError: 403 Forbidden`	Token lacks required scopes	Enable `read_products` scope in app config
`HttpResponseError: 404 Not Found`	Wrong store domain or API version	Verify store URL is `*.myshopify.com`
`ENOTFOUND your-store.myshopify.com`	Store domain typo or DNS issue	Double-check `SHOPIFY_STORE` value
`GraphqlQueryError` with `userErrors`	Invalid query syntax	Check field names against API version docs
`MODULE_NOT_FOUND @shopify/shopify-api`	Package not installed	Run `npm install @shopify/shopify-api`

Examples

Create a Product and Query via REST

See GraphQL Mutation and REST Examples for a productCreate mutation and legacy REST API usage.

Resources

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-shopify-hello-world/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-shopify-hello-world.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-shopify-hello-world",
  "kind": "skill",
  "name": "shopify-hello-world",
  "description": "Create a minimal working Shopify app that queries products via GraphQL Admin API. Use when starting a new Shopify integration, testing your setup, or learning basic Shopify API patterns. Trigger with phrases like \"shopify hello world\", \"shopify example\", \"shopify quick start\", \"simple shopify app\", \"first shopify API call\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding",
      "general_chat"
    ],
    "tags": [
      "skill-md",
      "saas",
      "ecommerce",
      "shopify",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Create a minimal working Shopify app that queries products via GraphQL Admin API. Use when starting a new Shopify integration, testing your setup, or learning basic Shopify API patterns. Trigger with phrases like \"shopify hello world\", \"shopify example\", \"shopify quick start\", \"simple shopify app\", \"first shopify API call\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "skills/.curated/shopify-hello-world/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/skills/.curated/shopify-hello-world/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/skills/.curated/shopify-hello-world/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(npm:*),",
      "Bash(npx:*),",
      "Bash(node:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Shopify Hello World\n\n## Overview\n\nMinimal working example: query your store's products using the Shopify GraphQL Admin API. Uses `@shopify/shopify-api` with a custom app access token for zero-friction setup.\n\n## Prerequisites\n\n- Completed `shopify-install-auth` setup\n- A Shopify development store\n- An Admin API access token (`shpat_xxx`) from Settings > Apps > Develop apps\n\n## Instructions\n\n### Step 1: Create Project\n\n```bash\nmkdir shopify-hello-world && cd shopify-hello-world\nnpm init -y\nnpm install @shopify/shopify-api dotenv\n```\n\n### Step 2: Configure Environment\n\n```bash\n# .env\nSHOPIFY_S",
  "cost": {
    "context_tokens": 728
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-shopify-hello-world/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.