@clawpify/skills 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clawpify
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# Clawpify
+
+Shopify Agent SDK. Query and manage Shopify stores with AI agents and MCP.
+
+## Install
+
+```bash
+npm install @clawpify/skills
+```
+
+## Quick Start
+
+```ts
+import { ShopifyClient } from "@clawpify/skills";
+
+const client = new ShopifyClient({
+  storeUrl: "my-store.myshopify.com",
+  accessToken: "shpat_xxxxx",
+});
+
+const { data } = await client.graphql(`{
+  products(first: 5) {
+    nodes { id title }
+  }
+}`);
+```
+
+## AI Agent
+
+Requires `@anthropic-ai/sdk`:
+
+```ts
+import { ShopifyClient } from "@clawpify/skills";
+import { ShopifyAgent } from "@clawpify/skills/agent";
+import { loadSkills } from "@clawpify/skills/skills";
+
+const client = new ShopifyClient({ storeUrl, accessToken });
+const agent = new ShopifyAgent({ shopify: client, skillContent: await loadSkills() });
+
+const result = await agent.chat("List my products");
+console.log(result.response);
+```
+
+## MCP Server
+
+Add to `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "shopify": {
+      "command": "npx",
+      "args": ["@clawpify/skills"]
+    }
+  }
+}
+```
+
+Create `~/.clawpify/.env`:
+
+```bash
+SHOPIFY_STORE_URL=your-store.myshopify.com
+SHOPIFY_CLIENT_ID=your-client-id
+SHOPIFY_CLIENT_SECRET=shpss_xxxxx
+```
+
+## What It Covers
+
+Products, Orders, Customers, Inventory, Discounts, Collections, Gift Cards, Refunds, Draft Orders, Webhooks, and [more](./clawpify/references/).
+
+## License
+
+MIT

package/clawpify/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: clawpify
+description: Query and manage Shopify stores via GraphQL Admin API. Use for products, orders, customers, inventory, discounts, and all Shopify data operations.
+dependencies:
+  - Tool: shopify_graphql (from MCP server or custom function)
+---
+
+# 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:
+- Products (list, search, create, update, delete)
+- Orders (view, cancel, fulfill)
+- Customers (list, create, update)
+- Inventory (check levels, adjust quantities)
+- Discounts (create codes, manage promotions)
+- Any other Shopify store operations
+
+## Critical Operations Requiring Permission
+
+IMPORTANT: Before executing any of the following operations, you MUST ask for explicit user permission:
+
+- Refunds: Create refunds (permanent financial transactions)
+- Order Cancellations: Cancel orders (may trigger refunds)
+- Gift Card Deactivation: Permanently disable gift cards
+- Inventory Adjustments: Modify stock levels
+- Product Deletions: Permanently remove products
+- Discount Activations: Change pricing for customers
+
+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:
+- products.md - Products and variants management
+- orders.md - Order operations
+- customers.md - Customer management
+- inventory.md - Inventory and locations
+- discounts.md - Discount codes and promotions
+- collections.md - Product collections
+- fulfillments.md - Order fulfillment and shipping
+- refunds.md - Process refunds
+- draft-orders.md - Draft order creation
+- gift-cards.md - Gift card management
+- webhooks.md - Event subscriptions
+- locations.md - Store locations
+- marketing.md - Marketing activities
+- markets.md - Multi-market setup
+- menus.md - Navigation menus
+- metafields.md - Custom data fields
+- pages.md - Store pages
+- blogs.md - Blog management
+- files.md - File uploads
+- shipping.md - Shipping configuration
+- shop.md - Store information
+- subscriptions.md - Subscription management
+- translations.md - Content translations
+- segments.md - Customer segments
+- bulk-operations.md - Bulk data operations
+
+## Quick Examples
+
+### List Recent Orders
+```graphql
+query {
+  orders(first: 10, sortKey: CREATED_AT, reverse: true) {
+    nodes {
+      id
+      name
+      totalPriceSet {
+        shopMoney { amount currencyCode }
+      }
+      customer { displayName }
+    }
+  }
+}
+```
+
+### Search Products
+```graphql
+query {
+  products(first: 10, query: "title:*shirt* AND status:ACTIVE") {
+    nodes {
+      id
+      title
+      status
+    }
+  }
+}
+```
+
+### Check Inventory
+```graphql
+query GetInventory($id: ID!) {
+  inventoryItem(id: $id) {
+    id
+    inventoryLevels(first: 5) {
+      nodes {
+        quantities(names: ["available"]) {
+          name
+          quantity
+        }
+        location { name }
+      }
+    }
+  }
+}
+```
+
+## Error Handling
+
+Always check responses:
+- `errors` array = GraphQL syntax issues
+- `userErrors` in mutations = validation problems
+
+## 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

package/clawpify/references/blogs.md

@@ -0,0 +1,385 @@
+# Shopify Blogs & Articles
+
+Manage blogs and blog articles via the GraphQL Admin API.
+
+## Overview
+
+Blogs are containers for articles (blog posts). Each shop can have multiple blogs, and each blog contains multiple articles.
+
+## List Blogs
+
+```graphql
+query ListBlogs($first: Int!) {
+  blogs(first: $first) {
+    nodes {
+      id
+      title
+      handle
+      articlesCount {
+        count
+      }
+    }
+  }
+}
+```
+Variables: `{ "first": 10 }`
+
+## Get Blog
+
+```graphql
+query GetBlog($id: ID!) {
+  blog(id: $id) {
+    id
+    title
+    handle
+    articlesCount {
+      count
+    }
+    articles(first: 10) {
+      nodes {
+        id
+        title
+        publishedAt
+      }
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/Blog/123" }`
+
+## Create Blog
+
+```graphql
+mutation CreateBlog($blog: BlogCreateInput!) {
+  blogCreate(blog: $blog) {
+    blog {
+      id
+      title
+      handle
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "blog": {
+    "title": "Company News",
+    "handle": "news"
+  }
+}
+```
+
+## Update Blog
+
+```graphql
+mutation UpdateBlog($id: ID!, $blog: BlogUpdateInput!) {
+  blogUpdate(id: $id, blog: $blog) {
+    blog {
+      id
+      title
+      handle
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Blog/123",
+  "blog": {
+    "title": "Latest News"
+  }
+}
+```
+
+## Delete Blog
+
+```graphql
+mutation DeleteBlog($id: ID!) {
+  blogDelete(id: $id) {
+    deletedBlogId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## List Articles
+
+```graphql
+query ListArticles($first: Int!, $after: String, $query: String) {
+  articles(first: $first, after: $after, query: $query, sortKey: PUBLISHED_AT, reverse: true) {
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    nodes {
+      id
+      title
+      handle
+      publishedAt
+      author {
+        name
+      }
+      blog {
+        title
+      }
+      tags
+    }
+  }
+}
+```
+Variables: `{ "first": 10 }`
+
+## Get Article
+
+```graphql
+query GetArticle($id: ID!) {
+  article(id: $id) {
+    id
+    title
+    handle
+    body
+    summary
+    publishedAt
+    author {
+      name
+      email
+    }
+    blog {
+      id
+      title
+    }
+    image {
+      url
+      altText
+    }
+    tags
+    templateSuffix
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/Article/123" }`
+
+## Create Article
+
+```graphql
+mutation CreateArticle($article: ArticleCreateInput!, $blog: ArticleBlogInput) {
+  articleCreate(article: $article, blog: $blog) {
+    article {
+      id
+      title
+      handle
+      publishedAt
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "article": {
+    "title": "Summer Collection Launch",
+    "handle": "summer-collection-launch",
+    "body": "<p>We're excited to announce our new summer collection...</p>",
+    "summary": "Introducing our latest summer styles",
+    "author": {
+      "name": "Marketing Team"
+    },
+    "tags": ["summer", "new-arrivals", "collection"],
+    "isPublished": true,
+    "publishedAt": "2025-06-01T09:00:00Z"
+  },
+  "blog": {
+    "id": "gid://shopify/Blog/123"
+  }
+}
+```
+
+## Create Article with Image
+
+```graphql
+mutation CreateArticleWithImage($article: ArticleCreateInput!, $blog: ArticleBlogInput) {
+  articleCreate(article: $article, blog: $blog) {
+    article {
+      id
+      title
+      image {
+        url
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "article": {
+    "title": "Product Spotlight",
+    "body": "<p>Check out our featured product...</p>",
+    "isPublished": true,
+    "image": {
+      "url": "https://example.com/images/featured.jpg",
+      "altText": "Featured product image"
+    }
+  },
+  "blog": {
+    "id": "gid://shopify/Blog/123"
+  }
+}
+```
+
+## Update Article
+
+```graphql
+mutation UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
+  articleUpdate(id: $id, article: $article) {
+    article {
+      id
+      title
+      body
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Article/123",
+  "article": {
+    "body": "<p>Updated article content...</p>",
+    "tags": ["summer", "sale", "featured"]
+  }
+}
+```
+
+## Move Article to Different Blog
+
+```graphql
+mutation MoveArticle($id: ID!, $article: ArticleUpdateInput!, $blog: ArticleBlogInput) {
+  articleUpdate(id: $id, article: $article, blog: $blog) {
+    article {
+      id
+      blog {
+        id
+        title
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Article/123",
+  "article": {},
+  "blog": {
+    "id": "gid://shopify/Blog/456"
+  }
+}
+```
+
+## Delete Article
+
+```graphql
+mutation DeleteArticle($id: ID!) {
+  articleDelete(id: $id) {
+    deletedArticleId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Get Article Tags
+
+```graphql
+query GetArticleTags($limit: Int!) {
+  articleTags(limit: $limit, sort: POPULAR) {
+    ... on String {
+      __typename
+    }
+  }
+}
+```
+
+## Get Article Authors
+
+```graphql
+query GetArticleAuthors($first: Int!) {
+  articleAuthors(first: $first) {
+    nodes {
+      name
+    }
+  }
+}
+```
+
+## Search Articles by Tag
+
+```graphql
+query SearchArticlesByTag($tag: String!) {
+  articles(first: 10, query: $tag) {
+    nodes {
+      id
+      title
+      tags
+    }
+  }
+}
+```
+Variables: `{ "tag": "tag:summer" }`
+
+## Article Search Filters
+
+| Filter | Example | Description |
+|--------|---------|-------------|
+| `title` | `title:summer` | Filter by title |
+| `author` | `author:John` | Filter by author |
+| `tag` | `tag:featured` | Filter by tag |
+| `blog_title` | `blog_title:News` | Filter by blog |
+| `created_at` | `created_at:>2024-01-01` | Filter by creation date |
+| `published_at` | `published_at:>2024-01-01` | Filter by publish date |
+
+## API Scopes Required
+
+- `read_content` - Read blogs and articles
+- `write_content` - Create, update, delete blogs and articles
+
+## Notes
+
+- Articles require a blog to belong to
+- Tags are strings and case-insensitive
+- Use `publishedAt` to schedule future publication
+- Set `isPublished: false` to save as draft
+- HTML in body is sanitized by Shopify
+- Images should be uploaded first or provided via URL