@clawpify/skills 1.0.1

package/clawpify/references/markets.md

@@ -0,0 +1,346 @@
+# Shopify Markets
+
+Manage international markets for localized shopping experiences via the GraphQL Admin API.
+
+## Overview
+
+Markets define customized shopping experiences for different regions, including pricing, currency, content, and fulfillment settings.
+
+## List Markets
+
+```graphql
+query ListMarkets($first: Int!) {
+  markets(first: $first) {
+    nodes {
+      id
+      name
+      handle
+      enabled
+      primary
+      currencySettings {
+        baseCurrency {
+          currencyCode
+        }
+        localCurrencies
+      }
+      regions(first: 10) {
+        nodes {
+          ... on MarketRegionCountry {
+            code
+            name
+          }
+        }
+      }
+    }
+  }
+}
+```
+Variables: `{ "first": 10 }`
+
+## Get Market
+
+```graphql
+query GetMarket($id: ID!) {
+  market(id: $id) {
+    id
+    name
+    handle
+    enabled
+    primary
+    currencySettings {
+      baseCurrency {
+        currencyCode
+      }
+      localCurrencies
+    }
+    priceInclusions {
+      includeTaxes
+    }
+    webPresence {
+      domain {
+        host
+      }
+      defaultLocale
+      alternateLocales
+      subfolderSuffix
+    }
+    regions(first: 20) {
+      nodes {
+        ... on MarketRegionCountry {
+          code
+          name
+        }
+      }
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/Market/123" }`
+
+## Create Market
+
+```graphql
+mutation CreateMarket($input: MarketCreateInput!) {
+  marketCreate(input: $input) {
+    market {
+      id
+      name
+      handle
+      enabled
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "input": {
+    "name": "European Union",
+    "handle": "eu",
+    "enabled": true,
+    "regions": [
+      { "countryCode": "DE" },
+      { "countryCode": "FR" },
+      { "countryCode": "IT" },
+      { "countryCode": "ES" },
+      { "countryCode": "NL" }
+    ]
+  }
+}
+```
+
+## Update Market
+
+```graphql
+mutation UpdateMarket($id: ID!, $input: MarketUpdateInput!) {
+  marketUpdate(id: $id, input: $input) {
+    market {
+      id
+      name
+      enabled
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Market/123",
+  "input": {
+    "name": "EU Market",
+    "enabled": true
+  }
+}
+```
+
+## Delete Market
+
+```graphql
+mutation DeleteMarket($id: ID!) {
+  marketDelete(id: $id) {
+    deletedId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Market Localizations
+
+### Get Market Localizable Resource
+
+```graphql
+query GetMarketLocalizableResource($resourceId: ID!) {
+  marketLocalizableResource(resourceId: $resourceId) {
+    resourceId
+    marketLocalizableContent {
+      key
+      value
+      digest
+      marketLocalizationsCount {
+        count
+      }
+    }
+  }
+}
+```
+
+### List Market Localizable Resources
+
+```graphql
+query ListMarketLocalizableResources($resourceType: MarketLocalizableResourceType!, $first: Int!) {
+  marketLocalizableResources(resourceType: $resourceType, first: $first) {
+    nodes {
+      resourceId
+      marketLocalizableContent {
+        key
+        value
+        digest
+      }
+    }
+  }
+}
+```
+
+### Register Market Localizations
+
+```graphql
+mutation RegisterMarketLocalizations($resourceId: ID!, $marketLocalizations: [MarketLocalizationRegisterInput!]!) {
+  marketLocalizationsRegister(resourceId: $resourceId, marketLocalizations: $marketLocalizations) {
+    marketLocalizations {
+      key
+      value
+      marketId
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "resourceId": "gid://shopify/Product/123",
+  "marketLocalizations": [
+    {
+      "key": "title",
+      "value": "Summer Collection T-Shirt (EU Edition)",
+      "marketId": "gid://shopify/Market/456",
+      "marketLocalizableContentDigest": "abc123digest"
+    }
+  ]
+}
+```
+
+### Remove Market Localizations
+
+```graphql
+mutation RemoveMarketLocalizations($resourceId: ID!, $marketLocalizationKeys: [String!]!, $marketIds: [ID!]!) {
+  marketLocalizationsRemove(resourceId: $resourceId, marketLocalizationKeys: $marketLocalizationKeys, marketIds: $marketIds) {
+    marketLocalizations {
+      key
+      marketId
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Resolve Market for Buyer
+
+```graphql
+query ResolveMarket($buyerSignal: BuyerSignalInput!) {
+  marketsResolvedValues(buyerSignal: $buyerSignal) {
+    market {
+      id
+      name
+    }
+    country {
+      code
+    }
+    language
+    currency
+  }
+}
+```
+Variables:
+```json
+{
+  "buyerSignal": {
+    "countryCode": "DE",
+    "language": "de"
+  }
+}
+```
+
+## Market Types
+
+| Type | Description |
+|------|-------------|
+| `PRIMARY` | Default market (usually domestic) |
+| `INTERNATIONAL` | Standard international markets |
+| `B2B` | Business-to-business markets |
+| `SINGLE_COUNTRY` | Market for one country |
+| `MULTI_COUNTRY` | Market spanning multiple countries |
+
+## Market Localizable Resource Types
+
+| Type | Description |
+|------|-------------|
+| `PRODUCT` | Products |
+| `PRODUCT_VARIANT` | Product variants |
+| `COLLECTION` | Collections |
+| `METAFIELD` | Metafields |
+| `METAOBJECT` | Metaobjects |
+
+## Currency Settings
+
+Markets can use:
+- **Base currency** - The shop's default currency
+- **Local currencies** - Show prices in buyer's local currency
+
+```graphql
+query GetMarketCurrencySettings($id: ID!) {
+  market(id: $id) {
+    currencySettings {
+      baseCurrency {
+        currencyCode
+        currencyName
+      }
+      localCurrencies
+    }
+  }
+}
+```
+
+## Web Presence
+
+Configure how the market appears on the storefront:
+
+```graphql
+query GetMarketWebPresence($id: ID!) {
+  market(id: $id) {
+    webPresence {
+      domain {
+        host
+      }
+      subfolderSuffix
+      defaultLocale
+      alternateLocales
+      rootUrls {
+        locale
+        url
+      }
+    }
+  }
+}
+```
+
+## API Scopes Required
+
+- `read_markets` - Read market configurations
+- `write_markets` - Create, update, delete markets
+- `read_translations` - Read market localizations
+- `write_translations` - Manage market localizations
+
+## Notes
+
+- Each shop has one primary market (usually domestic sales)
+- Markets can overlap in regions but buyers are matched to one market
+- Market-specific content overrides default translations
+- Currency conversion uses Shopify's exchange rates

package/clawpify/references/menus.md

@@ -0,0 +1,313 @@
+# Shopify Menus
+
+Manage navigation menus for the online store via the GraphQL Admin API.
+
+## Overview
+
+Menus organize navigation links that help customers find collections, products, pages, blogs, and external URLs. Menus support nested items up to three levels deep.
+
+## List Menus
+
+```graphql
+query ListMenus($first: Int!) {
+  menus(first: $first) {
+    nodes {
+      id
+      title
+      handle
+      itemsCount {
+        count
+      }
+    }
+  }
+}
+```
+Variables: `{ "first": 10 }`
+
+## Get Menu
+
+```graphql
+query GetMenu($id: ID!) {
+  menu(id: $id) {
+    id
+    title
+    handle
+    items {
+      id
+      title
+      type
+      url
+      resourceId
+      items {
+        id
+        title
+        type
+        url
+        items {
+          id
+          title
+          url
+        }
+      }
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/Menu/123" }`
+
+## Create Menu
+
+```graphql
+mutation CreateMenu($title: String!, $handle: String!, $items: [MenuItemCreateInput!]!) {
+  menuCreate(title: $title, handle: $handle, items: $items) {
+    menu {
+      id
+      title
+      handle
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "title": "Main Menu",
+  "handle": "main-menu",
+  "items": [
+    {
+      "title": "Home",
+      "type": "FRONTPAGE",
+      "url": "/"
+    },
+    {
+      "title": "Shop",
+      "type": "COLLECTION",
+      "resourceId": "gid://shopify/Collection/123"
+    },
+    {
+      "title": "About",
+      "type": "PAGE",
+      "resourceId": "gid://shopify/Page/456"
+    },
+    {
+      "title": "Contact",
+      "type": "HTTP",
+      "url": "/pages/contact"
+    }
+  ]
+}
+```
+
+## Create Menu with Nested Items
+
+```graphql
+mutation CreateMenuWithNesting($title: String!, $handle: String!, $items: [MenuItemCreateInput!]!) {
+  menuCreate(title: $title, handle: $handle, items: $items) {
+    menu {
+      id
+      title
+      items {
+        title
+        items {
+          title
+        }
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "title": "Shop By Category",
+  "handle": "shop-categories",
+  "items": [
+    {
+      "title": "Clothing",
+      "type": "COLLECTION",
+      "resourceId": "gid://shopify/Collection/100",
+      "items": [
+        {
+          "title": "T-Shirts",
+          "type": "COLLECTION",
+          "resourceId": "gid://shopify/Collection/101"
+        },
+        {
+          "title": "Pants",
+          "type": "COLLECTION",
+          "resourceId": "gid://shopify/Collection/102"
+        },
+        {
+          "title": "Dresses",
+          "type": "COLLECTION",
+          "resourceId": "gid://shopify/Collection/103"
+        }
+      ]
+    },
+    {
+      "title": "Accessories",
+      "type": "COLLECTION",
+      "resourceId": "gid://shopify/Collection/200",
+      "items": [
+        {
+          "title": "Hats",
+          "type": "COLLECTION",
+          "resourceId": "gid://shopify/Collection/201"
+        },
+        {
+          "title": "Bags",
+          "type": "COLLECTION",
+          "resourceId": "gid://shopify/Collection/202"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Update Menu
+
+```graphql
+mutation UpdateMenu($id: ID!, $title: String!, $handle: String, $items: [MenuItemUpdateInput!]!) {
+  menuUpdate(id: $id, title: $title, handle: $handle, items: $items) {
+    menu {
+      id
+      title
+      handle
+      items {
+        title
+        url
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Menu/123",
+  "title": "Main Navigation",
+  "items": [
+    {
+      "title": "Home",
+      "type": "FRONTPAGE",
+      "url": "/"
+    },
+    {
+      "title": "New Arrivals",
+      "type": "COLLECTION",
+      "resourceId": "gid://shopify/Collection/789"
+    },
+    {
+      "title": "Sale",
+      "type": "COLLECTION",
+      "resourceId": "gid://shopify/Collection/999"
+    }
+  ]
+}
+```
+
+## Delete Menu
+
+```graphql
+mutation DeleteMenu($id: ID!) {
+  menuDelete(id: $id) {
+    deletedMenuId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Menu Item Types
+
+| Type | Description | Required Field |
+|------|-------------|----------------|
+| `FRONTPAGE` | Link to homepage | `url: "/"` |
+| `COLLECTION` | Link to a collection | `resourceId` |
+| `PRODUCT` | Link to a product | `resourceId` |
+| `PAGE` | Link to a page | `resourceId` |
+| `BLOG` | Link to a blog | `resourceId` |
+| `ARTICLE` | Link to an article | `resourceId` |
+| `HTTP` | Custom URL (internal) | `url` |
+| `SEARCH` | Link to search page | - |
+| `CATALOG` | Link to catalog | - |
+
+## Common Menu Handles
+
+| Handle | Description |
+|--------|-------------|
+| `main-menu` | Primary navigation |
+| `footer` | Footer navigation |
+| `header` | Header links |
+
+## Footer Menu Example
+
+```json
+{
+  "title": "Footer",
+  "handle": "footer",
+  "items": [
+    {
+      "title": "Quick Links",
+      "type": "HTTP",
+      "url": "#",
+      "items": [
+        {
+          "title": "Search",
+          "type": "SEARCH"
+        },
+        {
+          "title": "About Us",
+          "type": "PAGE",
+          "resourceId": "gid://shopify/Page/123"
+        }
+      ]
+    },
+    {
+      "title": "Policies",
+      "type": "HTTP",
+      "url": "#",
+      "items": [
+        {
+          "title": "Privacy Policy",
+          "type": "PAGE",
+          "resourceId": "gid://shopify/Page/456"
+        },
+        {
+          "title": "Terms of Service",
+          "type": "PAGE",
+          "resourceId": "gid://shopify/Page/789"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## API Scopes Required
+
+- `read_online_store_navigation` - Read menus
+- `write_online_store_navigation` - Create, update, delete menus
+
+## Notes
+
+- Default menus (`main-menu`, `footer`) cannot have their handles changed
+- Maximum nesting depth is 3 levels
+- Menu updates replace all items (not partial update)
+- Resource IDs must be valid Shopify global IDs
+- Use `HTTP` type for relative URLs within the store