@clawpify/skills 1.0.1

package/clawpify/references/locations.md

@@ -0,0 +1,349 @@
+# Shopify Locations
+
+Manage inventory locations for fulfillment via the GraphQL Admin API.
+
+## Overview
+
+Locations are physical places where you stock inventory and fulfill orders from. Each location can have different inventory levels and fulfillment settings.
+
+## List Locations
+
+```graphql
+query ListLocations($first: Int!, $includeInactive: Boolean) {
+  locations(first: $first, includeInactive: $includeInactive) {
+    nodes {
+      id
+      name
+      isActive
+      fulfillsOnlineOrders
+      address {
+        address1
+        address2
+        city
+        province
+        country
+        zip
+        phone
+      }
+    }
+  }
+}
+```
+Variables: `{ "first": 20, "includeInactive": false }`
+
+## Get Location
+
+```graphql
+query GetLocation($id: ID!) {
+  location(id: $id) {
+    id
+    name
+    isActive
+    isPrimary
+    fulfillsOnlineOrders
+    hasActiveInventory
+    shipsInventory
+    address {
+      address1
+      address2
+      city
+      province
+      provinceCode
+      country
+      countryCode
+      zip
+      phone
+    }
+    localPickupSettingsV2 {
+      instructions
+      pickupTime
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/Location/123" }`
+
+## Get Locations Count
+
+```graphql
+query GetLocationsCount {
+  locationsCount {
+    count
+  }
+}
+```
+
+## Add Location
+
+```graphql
+mutation AddLocation($input: LocationAddInput!) {
+  locationAdd(input: $input) {
+    location {
+      id
+      name
+      address {
+        address1
+        city
+        country
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "input": {
+    "name": "New York Warehouse",
+    "address": {
+      "address1": "123 Warehouse Ave",
+      "city": "New York",
+      "provinceCode": "NY",
+      "countryCode": "US",
+      "zip": "10001",
+      "phone": "+1-212-555-0100"
+    },
+    "fulfillsOnlineOrders": true
+  }
+}
+```
+
+## Edit Location
+
+```graphql
+mutation EditLocation($id: ID!, $input: LocationEditInput!) {
+  locationEdit(id: $id, input: $input) {
+    location {
+      id
+      name
+      address {
+        address1
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Location/123",
+  "input": {
+    "name": "NY Warehouse - Main",
+    "address": {
+      "phone": "+1-212-555-0200"
+    }
+  }
+}
+```
+
+## Activate Location
+
+```graphql
+mutation ActivateLocation($locationId: ID!) {
+  locationActivate(locationId: $locationId) {
+    location {
+      id
+      isActive
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Deactivate Location
+
+```graphql
+mutation DeactivateLocation($locationId: ID!, $destinationLocationId: ID) {
+  locationDeactivate(locationId: $locationId, destinationLocationId: $destinationLocationId) {
+    location {
+      id
+      isActive
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+Note: When deactivating, inventory moves to the destination location.
+
+## Delete Location
+
+```graphql
+mutation DeleteLocation($locationId: ID!) {
+  locationDelete(locationId: $locationId) {
+    deletedLocationId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Enable Local Pickup
+
+```graphql
+mutation EnableLocalPickup($localPickupSettings: DeliveryLocationLocalPickupEnableInput!) {
+  locationLocalPickupEnable(localPickupSettings: $localPickupSettings) {
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "localPickupSettings": {
+    "locationId": "gid://shopify/Location/123",
+    "instructions": "Located at the back of the store. Ring the bell for assistance.",
+    "pickupTime": "TWENTY_FOUR_HOURS"
+  }
+}
+```
+
+## Disable Local Pickup
+
+```graphql
+mutation DisableLocalPickup($locationId: ID!) {
+  locationLocalPickupDisable(locationId: $locationId) {
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Location by Identifier
+
+```graphql
+query GetLocationByIdentifier($identifier: LocationIdentifierInput!) {
+  locationByIdentifier(identifier: $identifier) {
+    id
+    name
+    isActive
+  }
+}
+```
+Variables:
+```json
+{
+  "identifier": {
+    "gid": "gid://shopify/Location/123"
+  }
+}
+```
+
+## Locations for Delivery Profiles
+
+```graphql
+query GetDeliveryLocations($first: Int!) {
+  locationsAvailableForDeliveryProfilesConnection(first: $first) {
+    nodes {
+      id
+      name
+      fulfillsOnlineOrders
+    }
+  }
+}
+```
+
+## Location Fields
+
+| Field | Description |
+|-------|-------------|
+| `name` | Display name |
+| `isActive` | Whether location is active |
+| `isPrimary` | Default location for inventory |
+| `fulfillsOnlineOrders` | Can fulfill online orders |
+| `hasActiveInventory` | Has inventory tracked here |
+| `shipsInventory` | Can ship from this location |
+| `activatable` | Can be activated |
+| `deactivatable` | Can be deactivated |
+| `deletable` | Can be deleted |
+
+## Local Pickup Times
+
+| Value | Description |
+|-------|-------------|
+| `ONE_HOUR` | Ready in 1 hour |
+| `TWO_HOURS` | Ready in 2 hours |
+| `FOUR_HOURS` | Ready in 4 hours |
+| `TWENTY_FOUR_HOURS` | Ready in 24 hours |
+| `TWO_TO_FOUR_DAYS` | Ready in 2-4 days |
+| `FIVE_OR_MORE_DAYS` | Ready in 5+ days |
+
+## B2B Company Locations
+
+For B2B businesses:
+
+```graphql
+query ListCompanyLocations($first: Int!) {
+  companyLocations(first: $first) {
+    nodes {
+      id
+      name
+      company {
+        id
+        name
+      }
+      billingAddress {
+        address1
+        city
+      }
+      shippingAddress {
+        address1
+        city
+      }
+    }
+  }
+}
+```
+
+### Create Company Location
+
+```graphql
+mutation CreateCompanyLocation($companyId: ID!, $input: CompanyLocationInput!) {
+  companyLocationCreate(companyId: $companyId, input: $input) {
+    companyLocation {
+      id
+      name
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## API Scopes Required
+
+- `read_locations` - Read locations
+- `write_locations` - Create, update, delete locations
+- `read_inventory` - Read inventory at locations
+- `write_inventory` - Manage inventory at locations
+
+## Notes
+
+- At least one location must remain active
+- Deactivating transfers inventory to another location
+- Primary location is the default for new inventory
+- Location changes affect fulfillment order assignments
+- Local pickup requires location address to be complete

package/clawpify/references/marketing.md

@@ -0,0 +1,352 @@
+# Shopify Marketing
+
+Manage marketing activities, events, and customer marketing consent via the GraphQL Admin API.
+
+## Marketing Activities
+
+Marketing activities track promotional campaigns like email marketing, social media ads, and other marketing efforts.
+
+### List Marketing Activities
+
+```graphql
+query ListMarketingActivities($first: Int!, $after: String) {
+  marketingActivities(first: $first, after: $after, sortKey: CREATED_AT, reverse: true) {
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    nodes {
+      id
+      title
+      activityListUrl
+      status
+      createdAt
+      budget {
+        budgetType
+        total {
+          amount
+          currencyCode
+        }
+      }
+      utmParameters {
+        campaign
+        source
+        medium
+      }
+    }
+  }
+}
+```
+Variables: `{ "first": 10 }`
+
+### Get Marketing Activity
+
+```graphql
+query GetMarketingActivity($id: ID!) {
+  marketingActivity(id: $id) {
+    id
+    title
+    status
+    activityListUrl
+    createdAt
+    budget {
+      budgetType
+      total {
+        amount
+        currencyCode
+      }
+    }
+    utmParameters {
+      campaign
+      source
+      medium
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/MarketingActivity/123" }`
+
+### Create External Marketing Activity
+
+```graphql
+mutation CreateExternalMarketingActivity($input: MarketingActivityCreateExternalInput!) {
+  marketingActivityCreateExternal(input: $input) {
+    marketingActivity {
+      id
+      title
+      status
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "input": {
+    "title": "Summer Email Campaign",
+    "remoteId": "campaign-123",
+    "utm": {
+      "campaign": "summer_sale",
+      "source": "email",
+      "medium": "newsletter"
+    },
+    "budget": {
+      "budgetType": "DAILY",
+      "total": {
+        "amount": "100.00",
+        "currencyCode": "USD"
+      }
+    },
+    "scheduledToEndAt": "2025-08-31T23:59:59Z",
+    "adSpend": {
+      "amount": "0.00",
+      "currencyCode": "USD"
+    },
+    "channelHandle": "email-marketing"
+  }
+}
+```
+
+### Update External Marketing Activity
+
+```graphql
+mutation UpdateExternalMarketingActivity($marketingActivityId: ID!, $input: MarketingActivityUpdateExternalInput!) {
+  marketingActivityUpdateExternal(marketingActivityId: $marketingActivityId, input: $input) {
+    marketingActivity {
+      id
+      title
+      status
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+### Delete External Marketing Activity
+
+```graphql
+mutation DeleteExternalMarketingActivity($marketingActivityId: ID!) {
+  marketingActivityDeleteExternal(marketingActivityId: $marketingActivityId) {
+    deletedMarketingActivityId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Marketing Events
+
+Marketing events represent trackable marketing-related actions.
+
+### List Marketing Events
+
+```graphql
+query ListMarketingEvents($first: Int!) {
+  marketingEvents(first: $first, sortKey: STARTED_AT, reverse: true) {
+    nodes {
+      id
+      type
+      startedAt
+      channel
+      utmParameters {
+        campaign
+        source
+        medium
+      }
+    }
+  }
+}
+```
+
+### Get Marketing Event
+
+```graphql
+query GetMarketingEvent($id: ID!) {
+  marketingEvent(id: $id) {
+    id
+    type
+    startedAt
+    endedAt
+    channel
+    utmParameters {
+      campaign
+      source
+      medium
+    }
+  }
+}
+```
+
+## Marketing Engagement
+
+Track engagement metrics for marketing activities.
+
+### Create Marketing Engagement
+
+```graphql
+mutation CreateMarketingEngagement($marketingActivityId: ID!, $marketingEngagement: MarketingEngagementInput!) {
+  marketingEngagementCreate(marketingActivityId: $marketingActivityId, marketingEngagement: $marketingEngagement) {
+    marketingEngagement {
+      occurredOn
+      impressionsCount
+      clicksCount
+      sessionsCount
+      salesAmount {
+        amount
+        currencyCode
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "marketingActivityId": "gid://shopify/MarketingActivity/123",
+  "marketingEngagement": {
+    "occurredOn": "2025-01-15",
+    "impressionsCount": 5000,
+    "clicksCount": 150,
+    "sessionsCount": 120,
+    "ordersCount": 10,
+    "salesAmount": {
+      "amount": "1500.00",
+      "currencyCode": "USD"
+    }
+  }
+}
+```
+
+### Delete Marketing Engagements
+
+```graphql
+mutation DeleteMarketingEngagements($channelHandle: String!) {
+  marketingEngagementsDelete(channelHandle: $channelHandle) {
+    deletedMarketingEngagementsCount
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Customer Marketing Consent
+
+### Update Email Marketing Consent
+
+```graphql
+mutation UpdateEmailMarketingConsent($input: CustomerEmailMarketingConsentUpdateInput!) {
+  customerEmailMarketingConsentUpdate(input: $input) {
+    customer {
+      id
+      defaultEmailAddress {
+        emailAddress
+        marketingState
+        marketingOptInLevel
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "input": {
+    "customerId": "gid://shopify/Customer/123",
+    "emailMarketingConsent": {
+      "marketingState": "SUBSCRIBED",
+      "marketingOptInLevel": "SINGLE_OPT_IN",
+      "consentUpdatedAt": "2025-01-15T10:00:00Z"
+    }
+  }
+}
+```
+
+### Update SMS Marketing Consent
+
+```graphql
+mutation UpdateSmsMarketingConsent($input: CustomerSmsMarketingConsentUpdateInput!) {
+  customerSmsMarketingConsentUpdate(input: $input) {
+    customer {
+      id
+      smsMarketingConsent {
+        marketingState
+        marketingOptInLevel
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "input": {
+    "customerId": "gid://shopify/Customer/123",
+    "smsMarketingConsent": {
+      "marketingState": "SUBSCRIBED",
+      "marketingOptInLevel": "SINGLE_OPT_IN",
+      "consentUpdatedAt": "2025-01-15T10:00:00Z"
+    }
+  }
+}
+```
+
+## Marketing Consent States
+
+| State | Description |
+|-------|-------------|
+| `NOT_SUBSCRIBED` | Customer has not subscribed |
+| `PENDING` | Awaiting confirmation (double opt-in) |
+| `SUBSCRIBED` | Customer is subscribed |
+| `UNSUBSCRIBED` | Customer has unsubscribed |
+| `REDACTED` | Customer data has been redacted |
+| `INVALID` | Invalid contact information |
+
+## Opt-In Levels
+
+| Level | Description |
+|-------|-------------|
+| `SINGLE_OPT_IN` | Subscribed without confirmation |
+| `CONFIRMED_OPT_IN` | Subscribed with email/SMS confirmation |
+| `UNKNOWN` | Opt-in level not specified |
+
+## UTM Parameters
+
+Track marketing attribution with UTM parameters:
+
+| Parameter | Description |
+|-----------|-------------|
+| `campaign` | Campaign name |
+| `source` | Traffic source (google, facebook, email) |
+| `medium` | Marketing medium (cpc, banner, newsletter) |
+| `term` | Paid search keywords |
+| `content` | Differentiate similar content/links |
+
+## API Scopes Required
+
+- `read_marketing_events` - Read marketing events
+- `write_marketing_events` - Create/update marketing events
+- `read_customers` - Read customer marketing consent
+- `write_customers` - Update customer marketing consent