Shopify — Admin & Storefront GraphQL APIs (Bankr Edition)

The core Shopify sections of this skill are adapted from the upstream NousResearch/hermes-agent skill (MIT, author: community). The four "Bankr Bridges" sections at the end are new and specific to the Bankr ecosystem.

Work with Shopify stores directly through curl: list products, manage inventory, pull orders, update customers, read metafields. No SDK, no app framework — just the GraphQL endpoint and a custom-app access token. Then bridge the merchant data to onchain primitives via Bankr.

The REST Admin API is legacy since 2024-04 and only receives security fixes. Use GraphQL Admin for all admin work. Use Storefront GraphQL for read-only customer-facing queries (products, collections, cart).

Prerequisites

1. In Shopify admin: Settings → Apps and sales channels → Develop apps → Create an app.
2. Click Configure Admin API scopes, select what you need (examples below), save.
3. Install app → the Admin API access token appears ONCE. Copy it immediately — Shopify will never show it again. Tokens start with shpat_.
4. Set these in your Bankr settings (gear icon → Env Vars):
   • SHOPIFY_ACCESS_TOKEN — admin token (starts with shpat_)
   • SHOPIFY_STORE_DOMAIN — my-store.myshopify.com (the permanent myshopify domain, not your custom one)
   • SHOPIFY_API_VERSION — default 2026-01
   • BANKR_API_KEY — for the Bankr bridge sections; generate at https://bankr.bot/api-keys