Clawpify

Shopify GraphQL Admin API

A comprehensive skill for interacting with Shopify's GraphQL Admin API. This skill enables Claude to query and manage all aspects of Shopify store data.

When to Use This Skill

Use this skill when the user asks about:

Critical Operations Requiring Permission

IMPORTANT: Before executing any of the following operations, you MUST ask for explicit user permission:

Always show what will be changed and wait for user confirmation.

How to Use

1. Use the shopify_graphql tool to execute queries 2. Check for errors (GraphQL issues) and userErrors (validation issues) 3. Use pagination with first/after for large result sets 4. Format all IDs as: gid://shopify/Resource/123

Available References

For detailed patterns and examples, refer to the reference documents:

Quick Examples

List Recent Orders

query {
  orders(first: 10, sortKey: CREATED_AT, reverse: true) {
    nodes {
      id
      name
      totalPriceSet {
        shopMoney { amount currencyCode }
      }
      customer { displayName }
    }
  }
}

Search Products

query {
  products(first: 10, query: "title:*shirt* AND status:ACTIVE") {
    nodes {
      id
      title
      status
    }
  }
}

Check Inventory

query GetInventory($id: ID!) {
  inventoryItem(id: $id) {
    id
    inventoryLevels(first: 5) {
      nodes {
        quantities(names: ["available"]) {
          name
          quantity
        }
        location { name }
      }
    }
  }
}

Error Handling

Always check responses:

Best Practices

1. Request only needed fields to optimize response size 2. Use pagination for lists that may grow 3. Check userErrors in all mutation responses 4. Ask permission before dangerous operations 5. Format results clearly for the user 6. Use bulk operations for large data exports/imports 7. Handle rate limits with exponential backoff

1. Request only needed fields to optimize response size 2. Use pagination for lists that may grow 3. Check userErrors in all mutation responses 4. Ask permission before dangerous operations 5. Format results clearly for the user 6. Use bulk operations for large data exports/imports 7. Handle rate limits with exponential backoff