shopify-setup
/shopify-setup
Konfiguruje uwierzytelnianie Shopify CLI i dostęp do Admin API dla sklepu: instalacja CLI, logowanie, utworzenie własnej aplikacji, zapis tokenu dostępu i weryfikacja, także przy problemach z tokenem.
- Autor
- jezweb ↗
- Repozytorium
- claude-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 09.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Konfiguruje uwierzytelnianie Shopify CLI i dostęp do Admin API dla sklepu: instalacja CLI, logowanie, utworzenie własnej aplikacji, zapis tokenu dostępu i weryfikacja, także przy problemach z tokenem.
Oryginalny opis (EN)
Set up Shopify CLI auth and Admin API access for a store. Install CLI, authenticate, create custom app, store access token, verify. Use whenever the user wants to connect to a Shopify store, set up Shopify API access, install Shopify CLI, or troubleshoot Shopify auth / Admin API token issues.
Jak działa
- Workflow
- Critical Patterns
- Reference Files
Podgląd SKILL.md
---
name: shopify-setup
description: "Set up Shopify CLI auth and Admin API access for a store. Install CLI, authenticate, create custom app, store access token, verify. Use whenever the user wants to connect to a Shopify store, set up Shopify API access, install Shopify CLI, or troubleshoot Shopify auth / Admin API token issues."
compatibility: claude-code-only
---
# Shopify Setup
Set up working Shopify CLI authentication and Admin API access for a store. Produces a verified API connection ready for product and content management.
## Workflow
### Step 1: Check Prerequisites
Verify the Shopify CLI is installed:
```bash
shopify version
```
If not installed:
```bash
npm install -g @shopify/cli
```
### Step 2: Authenticate with the Store
```bash
shopify auth login --store mystore.myshopify.com
```
This opens a browser for OAuth. The user must be a store owner or staff member with appropriate permissions.
After login, verify:
```bash
shopify store info
```
### Step 3: Create a Custom App for API Access
Custom apps provide stable Admin API access tokens (unlike CLI session tokens which expire).
**Check if an app already exists**: Ask the user if they have a custom app set up. If yes, skip to Step 4.
**If no custom app exists**, guide the user through creation via browser:
1. Navigate to `https://{store}.myshopify.com/admin/settings/apps/development`
2. Click **Create an app**
3. Name it (e.g. "Claude Code Integration")
4. Click **Configure Admin API scopes**
5. Enable these scopes (see `references/api-scopes.md` for details):
- `read_products`, `write_products`
- `read_content`, `write_content`
- `read_product_listings`
- `read_inventory`, `write_inventory`
- `read_files`, `write_files`
6. Click **Save** then **Install app**
7. Copy the **Admin API access token** (shown only once)
Use browser automation (Chrome MCP or playwright-cli) if the user prefers assistance navigating the admin.
### Step 4: Store the Access Token
Store the token securely. Never commit it to git.
**For project use** — create `.dev.vars`:
```
SHOPIFY_STORE=mystore.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxxx
```
Ensure `.dev.vars` is in `.gitignore`.
**For cross-project use** — store in your preferred secrets manager (environment variable, 1Password CLI, etc.).
### Step 5: Verify API Access
Test the connection with a simple GraphQL query:
```bash
curl -s https://{store}.myshopify.com/admin/api/2025-01/graphql.json \
-H "Content-Type: application/json" \
-H "X-Shopify-Access-Token: {token}" \
-d '{"query": "{ shop { name primaryDomain { url } } }"}' | jq .
```
Expected response includes the shop name and domain. If you get a 401, the token is invalid or expired — recreate the app.
### Step 6: Save Store Config
Create a `shopify.config.json` in the project root for other skills to reference:
```json
{
"store": "mystore.myshopify.com",
"apiVersion": "2025-01",
"tokenSource": ".dev.vars"
}
```
---
## Critical Patterns
### API Version
Always specify an explicit API version (e.g. `2025-01`). Using `unstable` in production will break without warning. Shopify retires API versions quarterly.
### Token Types
| Token | Format | Use |
|-------|--------|-----|
| Admin API access token | `shpat_*` | Custom apps — stable, long-lived |
| CLI session token | Short-lived | Shopify CLI commands only |
| Storefront API token | `shpca_*` | Public storefront queries |
This skill sets up **Admin API access tokens** — the right choice for product and content management.
### Rate Limits
Shopify uses a leaky bucket rate limiter:
- **REST**: 40 requests/second burst, 2/second sustained
- **GraphQL**: 1,000 cost points per second, max 2,000 points per query
For bulk operations, use the `bulkOperationRunQuery` mutation instead of looping.
---
## Reference Files
- `references/api-scopes.md` — Admin API scopes needed for product and content management
Pliki w paczce (2)
- SKILL.md 4 KB
- references/api-scopes.md 2 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · jezweb/claude-skills | 100 | MIT |
| OrcaQubits/agentic-commerce-skills-plugins | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 9d062a1414e2 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100shopify-install-auth
Instaluje i konfiguruje uwierzytelnianie aplikacji Shopify z OAuth, tokenami sesji i SDK @shopify/shopify-api, dla dostępu do Admin lub Storefront API. - 95shopify-use-shopify-cli
Sprawdza konfigurację aplikacji i rozszerzeń Shopify przez CLI, obsługuje sklep i zmienia produkty po SKU lub lokalizacji. - 100shopify-app-development
Buduje aplikację Shopify z uwierzytelnianiem sesji, zapytaniami Admin GraphQL i obsługą webhooków weryfikowanych przez HMAC. - 95shopify-admin
Pisze i wyjaśnia zapytania oraz mutacje Admin GraphQL dla aplikacji rozszerzających panel administracyjny sklepu Shopify. - 100shopify-hello-world
Tworzy minimalną aplikację Shopify pobierającą produkty przez GraphQL Admin API, przydatną na starcie integracji i do sprawdzenia konfiguracji. - 100rp-source-shopify
Odczytuje prywatne dane Shopify przez Shopify CLI na maszynie operatora importu: przechwycenie rozpoznania, wznawialne kroki, wiersze pokrycia źródła i zbiorczy eksport całego sklepu.