Shopify

Tools to interact with Shopify.

ShopifyTools enable an Agent to analyze sales data, product performance, and customer insights using the Shopify Admin GraphQL API.

Prerequisites

The following example requires a Shopify Admin API access token with appropriate scopes.

Set the following environment variables:

• SHOPIFY_SHOP_NAME: Your Shopify shop name (e.g., “my-store” from my-store.myshopify.com)
• SHOPIFY_ACCESS_TOKEN: Your Shopify Admin API access token

You can get your access token from: Shopify Admin > Settings > Apps and sales channels > Develop apps

Required API scopes:

• read_orders (for order and sales data)
• read_products (for product information)
• read_customers (for customer insights)
• read_analytics (for analytics data)

Example

The following agent will analyze sales data and provide insights.

shopify_tools.py

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.shopify import ShopifyTools

sales_agent = Agent(
    name="Sales Analyst",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[ShopifyTools()],
    instructions=[
        "You are a sales analyst for an e-commerce store using Shopify.",
        "Help the user understand their sales performance, product trends, and customer behavior.",
    ],
    markdown=True,
    add_datetime_to_context=True,  # This is important to get the current date and time in the context
)

sales_agent.print_response("What are my top 5 selling products this month?")

Toolkit Params

Parameter	Type	Default	Description
shop_name	str	-	Your Shopify store name (e.g., “my-store” from my-store.myshopify.com). Or set via SHOPIFY_SHOP_NAME environment variable.
access_token	str	-	Shopify Admin API access token with required scopes. Or set via SHOPIFY_ACCESS_TOKEN environment variable.
api_version	str	"2025-10"	Shopify API version.
timeout	int	30	Request timeout in seconds.

Toolkit Functions

Function	Description
get_shop_info	Get basic information about the Shopify store
get_products	Get products from the store with optional status filter
get_orders	Get orders with optional date range and status filters
get_top_selling_products	Get the top selling products by quantity sold
get_products_bought_together	Find products that are frequently bought together for bundle recommendations
get_sales_by_date_range	Get sales summary for a specific date range with daily breakdown
get_order_analytics	Get comprehensive order analytics including revenue, AOV, and fulfillment rates
get_product_sales_breakdown	Get detailed sales breakdown for a specific product
get_customer_order_history	Get order history for a specific customer by email
get_inventory_levels	Get current inventory levels for all products
get_low_stock_products	Get products that are running low on stock
get_sales_trends	Get sales trends comparing current period to previous period
get_average_order_value	Get average order value over time grouped by day, week, or month
get_repeat_customers	Find customers who have made multiple purchases

Developer Resources

• View Tools