AgentSkillsCN

Shopify E-commerce Ops

订单、产品、销售报表

SKILL.md
--- frontmatter
id: shopify-ecommerce-ops
name: Shopify E-commerce Ops
description: Orders, products, sales reports
role: sales
requiredTools:
  - type: mcpService
    serviceType: shopify

Shopify E-commerce Ops

When working with Shopify orders and products:

  • •Use shopify_get_order (tool name may have a suffix if multiple Shopify servers exist) to find an order by ID or number (e.g. #1001).
  • •Use shopify_search_products to search products by title for inventory and pricing; inventory lives on variants (inventory_quantity).
  • •Use shopify_sales_report to summarize order counts and gross sales by date range.
  • •Summarize results clearly; cite order IDs or date ranges when relevant.
  • •Shopify uses offline access tokens so data can be queried in the background.

Step-by-step instructions

  1. •For "order #1001" or "order by ID": call shopify_get_order with the order ID or number.
  2. •For "products matching X" or inventory/pricing: call shopify_search_products with the search query; report title, variants, inventory_quantity, and pricing from the response.
  3. •For "sales last week" or revenue summary: call shopify_sales_report with the date range; report order counts and gross sales.
  4. •When summarizing orders: include status, total, and key line items if relevant; for products, include variant inventory when the user asks about stock.
  5. •If the user asks for a date range, use it for shopify_sales_report; otherwise infer (e.g. last 7 days) or ask.

Examples of inputs and outputs

  • •

    Input: "What's in order #1001?"
    Output: Order status, total, and line items (product, quantity, price) from shopify_get_order.

  • •

    Input: "Sales summary for last month."
    Output: Order count and gross sales from shopify_sales_report for that date range; cite the range.

  • •

    Input: "Do we have stock for product X?"
    Output: Product and variant info including inventory_quantity from shopify_search_products; summarize stock status.

Common edge cases

  • •Order not found: Say "Order [id/number] not found" and suggest checking the ID or number format.
  • •No products found: Say "No products matching [query]" and suggest a different search term.
  • •Date range for sales: shopify_sales_report needs a date range; infer from "last week/month" or ask.
  • •API/OAuth error: Report that Shopify returned an error and suggest reconnecting or retrying.

Tool usage for specific purposes

  • •shopify_get_order: Use to look up an order by ID or number (e.g. #1001); returns order details and line items.
  • •shopify_search_products: Use to search products by title; use for inventory (variants.inventory_quantity) and pricing.
  • •shopify_sales_report: Use for order counts and gross sales over a date range; always specify the range.