@clawpify/skills 1.0.1

package/dist/mcp-server.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+
+// src/mcp-server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
+// src/auth.ts
+async function getAccessToken(config) {
+  const storeUrl = config.storeUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
+  const response = await fetch(`https://${storeUrl}/admin/oauth/access_token`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    body: new URLSearchParams({
+      grant_type: "client_credentials",
+      client_id: config.clientId,
+      client_secret: config.clientSecret
+    })
+  });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`OAuth error (${response.status}): ${text}`);
+  }
+  const data = await response.json();
+  return {
+    accessToken: data.access_token,
+    scope: data.scope,
+    expiresIn: data.expires_in
+  };
+}
+async function createAuthenticatedConfig() {
+  const storeUrl = process.env.SHOPIFY_STORE_URL;
+  const directToken = process.env.SHOPIFY_ACCESS_TOKEN;
+  const clientId = process.env.SHOPIFY_CLIENT_ID;
+  const clientSecret = process.env.SHOPIFY_CLIENT_SECRET;
+  if (!storeUrl) {
+    throw new Error("Missing required environment variable: SHOPIFY_STORE_URL");
+  }
+  if (directToken) {
+    return {
+      storeUrl,
+      accessToken: directToken
+    };
+  }
+  if (clientId && clientSecret) {
+    const token = await getAccessToken({ storeUrl, clientId, clientSecret });
+    return {
+      storeUrl,
+      accessToken: token.accessToken,
+      scope: token.scope,
+      expiresIn: token.expiresIn
+    };
+  }
+  throw new Error(`Missing authentication credentials. Provide either:
+` + `  - SHOPIFY_ACCESS_TOKEN (direct token), or
+` + "  - SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET (OAuth client credentials)");
+}
+
+// src/shopify.ts
+class ShopifyClient {
+  storeUrl;
+  accessToken;
+  apiVersion;
+  constructor(config) {
+    this.storeUrl = config.storeUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
+    this.accessToken = config.accessToken;
+    this.apiVersion = config.apiVersion ?? "2026-01";
+  }
+  async graphql(query, variables) {
+    const url = `https://${this.storeUrl}/admin/api/${this.apiVersion}/graphql.json`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Shopify-Access-Token": this.accessToken
+      },
+      body: JSON.stringify({ query, variables })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Shopify API error (${response.status}): ${text}`);
+    }
+    return response.json();
+  }
+}
+
+// src/mcp-server.ts
+import { readdir, readFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { existsSync } from "node:fs";
+var __dirname2 = dirname(fileURLToPath(import.meta.url));
+var skillsDir = join(__dirname2, "..", "clawpify");
+var configDir = join(homedir(), ".clawpify");
+var envPath = join(configDir, ".env");
+try {
+  if (existsSync(envPath)) {
+    const envContent = await readFile(envPath, "utf-8");
+    for (const line of envContent.split(`
+`)) {
+      const trimmed = line.trim();
+      if (trimmed && !trimmed.startsWith("#")) {
+        const [key, ...valueParts] = trimmed.split("=");
+        const value = valueParts.join("=");
+        if (key && value && !process.env[key]) {
+          process.env[key] = value;
+        }
+      }
+    }
+    console.error(`Loaded config from ${envPath}`);
+  }
+} catch {}
+var shopifyClient = null;
+async function getShopifyClient() {
+  if (!shopifyClient) {
+    const config = await createAuthenticatedConfig();
+    shopifyClient = new ShopifyClient({
+      storeUrl: config.storeUrl,
+      accessToken: config.accessToken
+    });
+  }
+  return shopifyClient;
+}
+var server = new Server({
+  name: "clawpify",
+  version: "1.0.0"
+}, {
+  capabilities: {
+    tools: {},
+    resources: {}
+  }
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "shopify_graphql",
+      description: "Execute GraphQL queries against Shopify Admin API. Use this to query products, orders, customers, inventory, and manage store data.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "GraphQL query or mutation"
+          },
+          variables: {
+            type: "object",
+            description: "GraphQL variables (optional)"
+          }
+        },
+        required: ["query"]
+      }
+    }
+  ]
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name === "shopify_graphql") {
+    const { query, variables } = request.params.arguments;
+    try {
+      const client = await getShopifyClient();
+      const result = await client.graphql(query, variables);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+  throw new Error(`Unknown tool: ${request.params.name}`);
+});
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+  try {
+    const files = await readdir(skillsDir);
+    const resources = files.filter((f) => f.endsWith(".md")).map((f) => ({
+      uri: `shopify://skills/${f.replace(".md", "")}`,
+      name: f.replace(".md", ""),
+      mimeType: "text/markdown",
+      description: `Shopify ${f.replace(".md", "")} skill documentation`
+    }));
+    return { resources };
+  } catch {
+    return { resources: [] };
+  }
+});
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  const uri = request.params.uri;
+  const match = uri.match(/^shopify:\/\/skills\/(.+)$/);
+  if (!match) {
+    throw new Error(`Invalid resource URI: ${uri}`);
+  }
+  const filename = `${match[1]}.md`;
+  const filepath = join(skillsDir, filename);
+  try {
+    const content = await readFile(filepath, "utf-8");
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: "text/markdown",
+          text: content
+        }
+      ]
+    };
+  } catch {
+    throw new Error(`Failed to read resource: ${filename}`);
+  }
+});
+async function main() {
+  const transport = new StdioServerTransport;
+  await server.connect(transport);
+  console.error("Clawpify MCP server running on stdio");
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/dist/shopify.d.ts

@@ -0,0 +1,29 @@
+export interface ShopifyClientConfig {
+    /** Shopify store URL (e.g. "my-store.myshopify.com") */
+    storeUrl: string;
+    /** Admin API access token */
+    accessToken: string;
+    /** API version (defaults to "2026-01") */
+    apiVersion?: string;
+}
+export interface GraphQLResponse<T = any> {
+    data?: T;
+    errors?: Array<{
+        message: string;
+        locations?: Array<{
+            line: number;
+            column: number;
+        }>;
+    }>;
+    extensions?: Record<string, any>;
+}
+export declare class ShopifyClient {
+    private storeUrl;
+    private accessToken;
+    private apiVersion;
+    constructor(config: ShopifyClientConfig);
+    /** Execute a GraphQL query or mutation against the Shopify Admin API */
+    graphql<T = any>(query: string, variables?: Record<string, any>): Promise<GraphQLResponse<T>>;
+}
+export declare function createShopifyClient(): ShopifyClient;
+//# sourceMappingURL=shopify.d.ts.map

package/dist/shopify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopify.d.ts","sourceRoot":"","sources":["../src/shopify.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,mBAAmB;IAMvC,wEAAwE;IAClE,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAmB/B;AAED,wBAAgB,mBAAmB,kBAWlC"}

package/dist/shopify.js

@@ -0,0 +1,41 @@
+// src/shopify.ts
+class ShopifyClient {
+  storeUrl;
+  accessToken;
+  apiVersion;
+  constructor(config) {
+    this.storeUrl = config.storeUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
+    this.accessToken = config.accessToken;
+    this.apiVersion = config.apiVersion ?? "2026-01";
+  }
+  async graphql(query, variables) {
+    const url = `https://${this.storeUrl}/admin/api/${this.apiVersion}/graphql.json`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Shopify-Access-Token": this.accessToken
+      },
+      body: JSON.stringify({ query, variables })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Shopify API error (${response.status}): ${text}`);
+    }
+    return response.json();
+  }
+}
+function createShopifyClient() {
+  const storeUrl = process.env.SHOPIFY_STORE_URL;
+  const accessToken = process.env.SHOPIFY_ACCESS_TOKEN;
+  if (!storeUrl || !accessToken) {
+    throw new Error("Missing required environment variables: SHOPIFY_STORE_URL and SHOPIFY_ACCESS_TOKEN");
+  }
+  return new ShopifyClient({ storeUrl, accessToken });
+}
+export {
+  createShopifyClient,
+  ShopifyClient
+};
+
+export { ShopifyClient, createShopifyClient };

package/dist/skills.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Load all skill files from the clawpify skills directory.
+ * Works both locally and when installed as an npm package.
+ *
+ * Optionally provide a custom directory path to load skills from.
+ */
+export declare function loadSkills(customDir?: string): Promise<string>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpE"}

package/dist/skills.js

@@ -0,0 +1,36 @@
+// src/skills.ts
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+async function loadSkills(customDir) {
+  const baseDir = customDir ?? join(fileURLToPath(import.meta.url), "..", "..", "clawpify");
+  const skillParts = [];
+  await collectMarkdown(baseDir, skillParts);
+  return skillParts.join(`
+
+---
+
+`);
+}
+async function collectMarkdown(dir, parts) {
+  let entries;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await collectMarkdown(fullPath, parts);
+    } else if (entry.name.endsWith(".md")) {
+      const content = await readFile(fullPath, "utf-8");
+      parts.push(content);
+    }
+  }
+}
+export {
+  loadSkills
+};
+
+export { loadSkills };

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@clawpify/skills",
+  "version": "1.0.1",
+  "description": "Shopify Agent SDK — query and manage Shopify stores via GraphQL Admin API with AI agents and MCP",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./agent": {
+      "types": "./dist/agent.d.ts",
+      "bun": "./src/agent.ts",
+      "import": "./dist/agent.js",
+      "default": "./dist/agent.js"
+    },
+    "./client": {
+      "types": "./dist/shopify.d.ts",
+      "bun": "./src/shopify.ts",
+      "import": "./dist/shopify.js",
+      "default": "./dist/shopify.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "bun": "./src/auth.ts",
+      "import": "./dist/auth.js",
+      "default": "./dist/auth.js"
+    },
+    "./skills": {
+      "types": "./dist/skills.d.ts",
+      "bun": "./src/skills.ts",
+      "import": "./dist/skills.js",
+      "default": "./dist/skills.js"
+    }
+  },
+  "bin": {
+    "clawpify": "dist/mcp-server.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "clawpify"
+  ],
+  "scripts": {
+    "build": "bun run build:clean && bun run build:js && bun run build:bin && bun run build:types",
+    "build:clean": "rm -rf dist",
+    "build:js": "bun build ./src/index.ts ./src/agent.ts ./src/shopify.ts ./src/auth.ts ./src/skills.ts --outdir ./dist --target node --format esm --splitting --external @anthropic-ai/sdk --external @modelcontextprotocol/sdk",
+    "build:bin": "bun build ./src/mcp-server.ts --outdir ./dist --target node --format esm --external @anthropic-ai/sdk --external @modelcontextprotocol/sdk",
+    "build:types": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build",
+    "start": "bun run examples/server.ts"
+  },
+  "keywords": [
+    "shopify",
+    "ai",
+    "mcp",
+    "graphql",
+    "agent",
+    "sdk",
+    "claude",
+    "anthropic",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clawpify/skills.git"
+  },
+  "homepage": "https://github.com/clawpify/skills#readme",
+  "bugs": {
+    "url": "https://github.com/clawpify/skills/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.39.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "bun-types": "latest",
+    "typescript": "^5.0.0"
+  }
+}

package/src/agent.ts

@@ -0,0 +1,133 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { ShopifyClient } from "./shopify";
+
+const SHOPIFY_GRAPHQL_TOOL: Anthropic.Tool = {
+  name: "shopify_graphql",
+  description:
+    "Execute a GraphQL query against the Shopify Admin API. Use this to interact with products, orders, customers, inventory, and other Shopify resources.",
+  input_schema: {
+    type: "object" as const,
+    properties: {
+      query: {
+        type: "string",
+        description: "The GraphQL query or mutation to execute",
+      },
+      variables: {
+        type: "object",
+        description: "Optional variables for the GraphQL query",
+      },
+    },
+    required: ["query"],
+  },
+};
+
+export class ShopifyAgent {
+  private anthropic: Anthropic;
+  private shopify: ShopifyClient;
+  private skillContent: string;
+  private model: string;
+
+  constructor(config: {
+    shopify: ShopifyClient;
+    skillContent: string;
+    model?: string;
+  }) {
+    this.anthropic = new Anthropic();
+    this.shopify = config.shopify;
+    this.skillContent = config.skillContent;
+    this.model = config.model ?? "claude-sonnet-4-5";
+  }
+
+  async chat(
+    userMessage: string,
+    conversationHistory: Anthropic.MessageParam[] = []
+  ): Promise<{ response: string; history: Anthropic.MessageParam[] }> {
+    const systemPrompt = `You are a helpful Shopify assistant that can query and manage a Shopify store using the GraphQL Admin API.
+
+${this.skillContent}
+
+When the user asks about products, orders, customers, or any Shopify data, use the shopify_graphql tool to fetch or modify the data. Always explain what you're doing and present results clearly.`;
+
+    const messages: Anthropic.MessageParam[] = [
+      ...conversationHistory,
+      { role: "user", content: userMessage },
+    ];
+
+    let response = await this.anthropic.messages.create({
+      model: this.model,
+      max_tokens: 4096,
+      system: systemPrompt,
+      tools: [SHOPIFY_GRAPHQL_TOOL],
+      messages,
+    });
+
+    const assistantMessages: Anthropic.ContentBlockParam[] = [];
+
+    // Agentic loop: keep processing tool calls until we get a final response
+    while (response.stop_reason === "tool_use") {
+      const toolUseBlocks = response.content.filter(
+        (block: Anthropic.ContentBlock): block is Anthropic.ToolUseBlock =>
+          block.type === "tool_use"
+      );
+
+      assistantMessages.push(...(response.content as Anthropic.ContentBlockParam[]));
+
+      const toolResults: Anthropic.ToolResultBlockParam[] = [];
+
+      for (const toolUse of toolUseBlocks) {
+        if (toolUse.name === "shopify_graphql") {
+          const input = toolUse.input as {
+            query: string;
+            variables?: Record<string, any>;
+          };
+
+          try {
+            const result = await this.shopify.graphql(
+              input.query,
+              input.variables
+            );
+            toolResults.push({
+              type: "tool_result",
+              tool_use_id: toolUse.id,
+              content: JSON.stringify(result, null, 2),
+            });
+          } catch (error) {
+            toolResults.push({
+              type: "tool_result",
+              tool_use_id: toolUse.id,
+              content: `Error: ${error instanceof Error ? error.message : String(error)}`,
+              is_error: true,
+            });
+          }
+        }
+      }
+
+      messages.push({ role: "assistant", content: assistantMessages.slice() });
+      messages.push({ role: "user", content: toolResults });
+      assistantMessages.length = 0;
+
+      response = await this.anthropic.messages.create({
+        model: this.model,
+        max_tokens: 4096,
+        system: systemPrompt,
+        tools: [SHOPIFY_GRAPHQL_TOOL],
+        messages,
+      });
+    }
+
+    // Extract final text response
+    const textBlocks = response.content.filter(
+      (block: Anthropic.ContentBlock): block is Anthropic.TextBlock =>
+        block.type === "text"
+    );
+    const finalResponse = textBlocks.map((b: Anthropic.TextBlock) => b.text).join("\n");
+
+    // Build updated history
+    const updatedHistory: Anthropic.MessageParam[] = [
+      ...messages,
+      { role: "assistant", content: response.content },
+    ];
+
+    return { response: finalResponse, history: updatedHistory };
+  }
+}