edcc34aa6d
Create centralized tools/ directory with REGISTRY.md index and 29 integration guides covering analytics, SEO, CRM, payments, referral, email, ads, automation, and commerce platforms. Each guide includes API endpoints, authentication, common operations, and links to relevant skills. Updated AGENTS.md and key skills (referral-program, analytics-tracking, email-sequence, paid-ads) with tool integration references. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
177 lines
3.1 KiB
Markdown
177 lines
3.1 KiB
Markdown
# Shopify
|
|
|
|
E-commerce platform for online stores and retail.
|
|
|
|
## Capabilities
|
|
|
|
| Integration | Available | Notes |
|
|
|-------------|-----------|-------|
|
|
| API | ✓ | REST Admin API, Storefront API, GraphQL |
|
|
| MCP | - | Not available |
|
|
| CLI | ✓ | Shopify CLI for themes and apps |
|
|
| SDK | ✓ | Official libraries for multiple languages |
|
|
|
|
## Authentication
|
|
|
|
- **Type**: Access Token (Custom App or OAuth)
|
|
- **Header**: `X-Shopify-Access-Token: {access_token}`
|
|
- **Base URL**: `https://{shop}.myshopify.com/admin/api/2024-01/`
|
|
|
|
## Common Agent Operations
|
|
|
|
### Get shop info
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/shop.json
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
### List products
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/products.json?limit=50
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
### Get product
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/products/{product_id}.json
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
### Create product
|
|
|
|
```bash
|
|
POST https://{shop}.myshopify.com/admin/api/2024-01/products.json
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
|
|
{
|
|
"product": {
|
|
"title": "Product Name",
|
|
"body_html": "<p>Description</p>",
|
|
"vendor": "Brand",
|
|
"product_type": "Category",
|
|
"variants": [{
|
|
"price": "99.00",
|
|
"sku": "SKU-001"
|
|
}]
|
|
}
|
|
}
|
|
```
|
|
|
|
### List orders
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/orders.json?status=any&limit=50
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
### Get order
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/orders/{order_id}.json
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
### List customers
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/customers.json?limit=50
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
### Search customers
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/customers/search.json?query=email:user@example.com
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
### Get analytics
|
|
|
|
```bash
|
|
GET https://{shop}.myshopify.com/admin/api/2024-01/reports.json
|
|
|
|
X-Shopify-Access-Token: {access_token}
|
|
```
|
|
|
|
## GraphQL API
|
|
|
|
```graphql
|
|
{
|
|
products(first: 10) {
|
|
edges {
|
|
node {
|
|
id
|
|
title
|
|
totalInventory
|
|
priceRangeV2 {
|
|
minVariantPrice {
|
|
amount
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## CLI Commands
|
|
|
|
```bash
|
|
# Login
|
|
shopify login --store={shop}
|
|
|
|
# Create theme
|
|
shopify theme init
|
|
|
|
# Push theme
|
|
shopify theme push
|
|
|
|
# Preview theme
|
|
shopify theme dev
|
|
|
|
# Create app
|
|
shopify app create node
|
|
```
|
|
|
|
## Webhook Topics
|
|
|
|
| Topic | When |
|
|
|-------|------|
|
|
| `orders/create` | New order |
|
|
| `orders/paid` | Order paid |
|
|
| `orders/fulfilled` | Order shipped |
|
|
| `customers/create` | New customer |
|
|
| `products/update` | Product changed |
|
|
| `checkouts/create` | Checkout started |
|
|
|
|
## When to Use
|
|
|
|
- E-commerce store management
|
|
- Product catalog operations
|
|
- Order processing
|
|
- Customer data management
|
|
- Inventory tracking
|
|
|
|
## Rate Limits
|
|
|
|
- REST: 2 requests/second
|
|
- GraphQL: 50 points/second
|
|
- Bulk operations available
|
|
|
|
## Relevant Skills
|
|
|
|
- analytics-tracking
|
|
- email-sequence
|
|
- referral-program
|