@clawpify/skills 1.0.1

package/clawpify/references/shipping.md

@@ -0,0 +1,406 @@
+# Shopify Shipping & Delivery
+
+Manage delivery profiles, shipping zones, and rates via the GraphQL Admin API.
+
+## Overview
+
+Delivery profiles define shipping settings for products, including zones, rates, and fulfillment locations.
+
+## List Delivery Profiles
+
+```graphql
+query ListDeliveryProfiles($first: Int!) {
+  deliveryProfiles(first: $first) {
+    nodes {
+      id
+      name
+      default
+      profileLocationGroups {
+        locationGroup {
+          id
+          locations(first: 5) {
+            nodes {
+              name
+            }
+          }
+        }
+        locationGroupZones(first: 10) {
+          nodes {
+            zone {
+              id
+              name
+              countries {
+                code {
+                  countryCode
+                }
+                provinces {
+                  code
+                  name
+                }
+              }
+            }
+            methodDefinitions(first: 5) {
+              nodes {
+                id
+                name
+                active
+                rateProvider {
+                  ... on DeliveryRateDefinition {
+                    price {
+                      amount
+                      currencyCode
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## Get Delivery Profile
+
+```graphql
+query GetDeliveryProfile($id: ID!) {
+  deliveryProfile(id: $id) {
+    id
+    name
+    default
+    profileItems(first: 20) {
+      nodes {
+        product {
+          id
+          title
+        }
+        variants(first: 5) {
+          nodes {
+            id
+            title
+          }
+        }
+      }
+    }
+    profileLocationGroups {
+      locationGroup {
+        locations(first: 10) {
+          nodes {
+            id
+            name
+          }
+        }
+      }
+      locationGroupZones(first: 10) {
+        nodes {
+          zone {
+            name
+          }
+          methodDefinitions(first: 5) {
+            nodes {
+              name
+              active
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/DeliveryProfile/123" }`
+
+## Create Delivery Profile
+
+```graphql
+mutation CreateDeliveryProfile($profile: DeliveryProfileInput!) {
+  deliveryProfileCreate(profile: $profile) {
+    profile {
+      id
+      name
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "profile": {
+    "name": "Heavy Items",
+    "locationGroupsToCreate": [
+      {
+        "locations": ["gid://shopify/Location/123"],
+        "zonesToCreate": [
+          {
+            "name": "Domestic",
+            "countries": [
+              {
+                "code": "US",
+                "includeAllProvinces": true
+              }
+            ],
+            "methodDefinitionsToCreate": [
+              {
+                "name": "Standard Shipping",
+                "active": true,
+                "rateDefinition": {
+                  "price": {
+                    "amount": "9.99",
+                    "currencyCode": "USD"
+                  }
+                }
+              },
+              {
+                "name": "Express Shipping",
+                "active": true,
+                "rateDefinition": {
+                  "price": {
+                    "amount": "19.99",
+                    "currencyCode": "USD"
+                  }
+                }
+              }
+            ]
+          }
+        ]
+      }
+    ],
+    "variantsToAssociate": [
+      "gid://shopify/ProductVariant/456",
+      "gid://shopify/ProductVariant/789"
+    ]
+  }
+}
+```
+
+## Update Delivery Profile
+
+```graphql
+mutation UpdateDeliveryProfile($id: ID!, $profile: DeliveryProfileInput!) {
+  deliveryProfileUpdate(id: $id, profile: $profile) {
+    profile {
+      id
+      name
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/DeliveryProfile/123",
+  "profile": {
+    "name": "Heavy Items - Updated",
+    "locationGroupsToUpdate": [
+      {
+        "id": "gid://shopify/DeliveryLocationGroup/456",
+        "zonesToCreate": [
+          {
+            "name": "Canada",
+            "countries": [
+              {
+                "code": "CA",
+                "includeAllProvinces": true
+              }
+            ],
+            "methodDefinitionsToCreate": [
+              {
+                "name": "Canada Standard",
+                "active": true,
+                "rateDefinition": {
+                  "price": {
+                    "amount": "14.99",
+                    "currencyCode": "USD"
+                  }
+                }
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Delete Delivery Profile
+
+```graphql
+mutation DeleteDeliveryProfile($id: ID!) {
+  deliveryProfileRemove(id: $id) {
+    job {
+      id
+      done
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Add Products to Profile
+
+```graphql
+mutation AddProductsToProfile($id: ID!, $profile: DeliveryProfileInput!) {
+  deliveryProfileUpdate(id: $id, profile: $profile) {
+    profile {
+      id
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/DeliveryProfile/123",
+  "profile": {
+    "variantsToAssociate": [
+      "gid://shopify/ProductVariant/111",
+      "gid://shopify/ProductVariant/222"
+    ]
+  }
+}
+```
+
+## Remove Products from Profile
+
+```graphql
+mutation RemoveProductsFromProfile($id: ID!, $profile: DeliveryProfileInput!) {
+  deliveryProfileUpdate(id: $id, profile: $profile) {
+    profile {
+      id
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/DeliveryProfile/123",
+  "profile": {
+    "variantsToDissociate": [
+      "gid://shopify/ProductVariant/111"
+    ]
+  }
+}
+```
+
+## Rate Types
+
+### Flat Rate
+```json
+{
+  "rateDefinition": {
+    "price": {
+      "amount": "9.99",
+      "currencyCode": "USD"
+    }
+  }
+}
+```
+
+### Weight-Based Rate
+```json
+{
+  "weightConditionsToCreate": [
+    {
+      "criteria": {
+        "unit": "KILOGRAMS",
+        "value": 5.0
+      },
+      "operator": "LESS_THAN_OR_EQUAL_TO"
+    }
+  ],
+  "rateDefinition": {
+    "price": {
+      "amount": "9.99",
+      "currencyCode": "USD"
+    }
+  }
+}
+```
+
+### Price-Based Rate
+```json
+{
+  "priceConditionsToCreate": [
+    {
+      "criteria": {
+        "amount": "50.00",
+        "currencyCode": "USD"
+      },
+      "operator": "GREATER_THAN_OR_EQUAL_TO"
+    }
+  ],
+  "rateDefinition": {
+    "price": {
+      "amount": "0.00",
+      "currencyCode": "USD"
+    }
+  }
+}
+```
+
+## Delivery Zone Structure
+
+| Component | Description |
+|-----------|-------------|
+| **Profile** | Top-level shipping configuration |
+| **Location Group** | Group of fulfillment locations |
+| **Zone** | Geographic region (countries/provinces) |
+| **Method Definition** | Shipping option with rate |
+
+## Country Code Examples
+
+| Code | Country |
+|------|---------|
+| `US` | United States |
+| `CA` | Canada |
+| `GB` | United Kingdom |
+| `AU` | Australia |
+| `DE` | Germany |
+| `FR` | France |
+
+## Condition Operators
+
+| Operator | Description |
+|----------|-------------|
+| `GREATER_THAN` | > value |
+| `GREATER_THAN_OR_EQUAL_TO` | >= value |
+| `LESS_THAN` | < value |
+| `LESS_THAN_OR_EQUAL_TO` | <= value |
+| `BETWEEN` | Between two values |
+
+## API Scopes Required
+
+- `read_shipping` - Read delivery profiles
+- `write_shipping` - Create, update, delete delivery profiles
+
+## Notes
+
+- Default profile applies to products not in other profiles
+- Products can only belong to one delivery profile
+- Zones define geographic areas for shipping
+- Rates can be flat, weight-based, or price-based
+- Multiple locations can share the same zone configuration
+- Carrier-calculated rates require additional setup

package/clawpify/references/shop.md

@@ -0,0 +1,307 @@
+# Shopify Shop
+
+Query shop information and settings via the GraphQL Admin API.
+
+## Overview
+
+The Shop object contains core store settings, features, billing information, and configuration details.
+
+## Get Shop Information
+
+```graphql
+query GetShop {
+  shop {
+    id
+    name
+    email
+    myshopifyDomain
+    primaryDomain {
+      host
+      sslEnabled
+    }
+    contactEmail
+    description
+    currencyCode
+    currencyFormats {
+      moneyFormat
+      moneyWithCurrencyFormat
+    }
+    weightUnit
+    unitSystem
+    timezoneAbbreviation
+    ianaTimezone
+    createdAt
+    plan {
+      displayName
+      partnerDevelopment
+      shopifyPlus
+    }
+  }
+}
+```
+
+## Get Shop Address
+
+```graphql
+query GetShopAddress {
+  shop {
+    billingAddress {
+      address1
+      address2
+      city
+      province
+      provinceCode
+      country
+      countryCodeV2
+      zip
+      phone
+      company
+    }
+  }
+}
+```
+
+## Get Shop Features
+
+```graphql
+query GetShopFeatures {
+  shop {
+    features {
+      branding {
+        shopifyBranding
+      }
+      storefront {
+        internationalPriceOverrides
+        internationalPriceRules
+      }
+      internationalDomains {
+        enabled
+      }
+    }
+  }
+}
+```
+
+## Get Shop Locales
+
+```graphql
+query GetShopLocales {
+  shopLocales(published: true) {
+    locale
+    name
+    primary
+    published
+  }
+}
+```
+
+## Get All Locales (Including Unpublished)
+
+```graphql
+query GetAllShopLocales {
+  shopLocales(published: false) {
+    locale
+    name
+    primary
+    published
+  }
+}
+```
+
+## Get Shop Billing Preferences
+
+```graphql
+query GetBillingPreferences {
+  shopBillingPreferences {
+    currency {
+      currencyCode
+      currencyName
+    }
+  }
+}
+```
+
+## Get Shopify Payments Account
+
+```graphql
+query GetPaymentsAccount {
+  shopifyPaymentsAccount {
+    activated
+    balance {
+      amount
+      currencyCode
+    }
+    country
+    defaultCurrency
+    payoutSchedule {
+      interval
+    }
+  }
+}
+```
+
+## Get Available API Versions
+
+```graphql
+query GetApiVersions {
+  publicApiVersions {
+    handle
+    displayName
+    supported
+  }
+}
+```
+
+## Execute ShopifyQL Query
+
+```graphql
+query RunShopifyQL($query: String!) {
+  shopifyqlQuery(query: $query) {
+    ... on TableResponse {
+      tableData {
+        columns {
+          name
+          dataType
+          displayName
+        }
+        rowData
+      }
+    }
+    ... on PolarisVizResponse {
+      data
+    }
+    parseErrors {
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "query": "FROM orders SHOW sum(total_sales) AS total_revenue SINCE -30d UNTIL today"
+}
+```
+
+## Common ShopifyQL Queries
+
+### Sales Summary
+```
+FROM orders
+SHOW sum(total_sales) AS revenue, count() AS order_count
+SINCE -30d UNTIL today
+```
+
+### Top Products
+```
+FROM products
+SHOW sum(quantity) AS units_sold
+GROUP BY product_title
+ORDER BY units_sold DESC
+LIMIT 10
+SINCE -30d
+```
+
+### Sales by Region
+```
+FROM orders
+SHOW sum(total_sales) AS revenue
+GROUP BY billing_country
+ORDER BY revenue DESC
+SINCE -30d
+```
+
+### Daily Sales Trend
+```
+FROM orders
+SHOW sum(total_sales) AS daily_revenue
+GROUP BY day
+SINCE -30d UNTIL today
+```
+
+## Get Shop Functions
+
+```graphql
+query GetShopFunctions($first: Int!) {
+  shopifyFunctions(first: $first) {
+    nodes {
+      id
+      title
+      apiType
+      apiVersion
+      app {
+        title
+      }
+    }
+  }
+}
+```
+Variables: `{ "first": 20 }`
+
+## Get Specific Function
+
+```graphql
+query GetFunction($id: String!) {
+  shopifyFunction(id: $id) {
+    id
+    title
+    apiType
+    apiVersion
+    description
+    app {
+      title
+    }
+  }
+}
+```
+
+## Shop Settings Fields
+
+| Field | Description |
+|-------|-------------|
+| `name` | Store name |
+| `email` | Store email |
+| `myshopifyDomain` | *.myshopify.com domain |
+| `primaryDomain` | Custom domain if set |
+| `currencyCode` | Store currency |
+| `weightUnit` | Weight unit (KILOGRAMS, POUNDS, etc.) |
+| `unitSystem` | METRIC or IMPERIAL |
+| `ianaTimezone` | Timezone (e.g., America/New_York) |
+
+## Plan Information
+
+| Field | Description |
+|-------|-------------|
+| `displayName` | Plan name (Basic, Shopify, Advanced, Plus) |
+| `partnerDevelopment` | Is development store |
+| `shopifyPlus` | Is Shopify Plus |
+
+## Weight Units
+
+| Unit | Description |
+|------|-------------|
+| `KILOGRAMS` | Kilograms |
+| `GRAMS` | Grams |
+| `POUNDS` | Pounds |
+| `OUNCES` | Ounces |
+
+## Currency Formats
+
+| Field | Example |
+|-------|---------|
+| `moneyFormat` | `${{amount}}` |
+| `moneyWithCurrencyFormat` | `${{amount}} USD` |
+
+## API Scopes Required
+
+- No specific scope needed for basic shop info
+- `read_shopify_payments_accounts` - For payments account info
+- `read_locales` - For locale information
+
+## Notes
+
+- Shop info is read-only through GraphQL
+- Use REST API for some shop settings updates
+- ShopifyQL is for analytics queries
+- Functions require apps with function capabilities
+- Domain and billing changes are done through admin UI