Shopify Setup Guide

Prerequisites

• check_circle A Shopify store with admin access (store owner or staff with the "Apps" permission)
• check_circle A Custom App created in your Shopify admin (we'll walk you through this below)

Connecting Shopify to Oskuo

1. 1 Log in to your Shopify admin at your-store.myshopify.com/admin.
2. 2 Go to Settings → Apps and sales channels → Develop apps, then click Create an app. Name it "Oskuo".
3. 3

   Click Configure Admin API scopes and select the following permissions:

   read_products write_products read_orders read_analytics read_inventory write_inventory read_content write_content

   Click Save when done.

4. 4 Click Install app, then reveal and copy the Admin API access token. You will only see this token once — copy it before closing the page.
5. 5 Open Settings → Connectors in Oskuo, find Shopify, and click Add instance. Enter your .myshopify.com URL (e.g. mystore.myshopify.com) and paste the Admin API access token. Click Test to verify the connection, then Save.
6. 6 You're all set. Start a new conversation in Oskuo and ask about your store — products, orders, inventory, and more are now available.

What you can do

Oskuo provides 16 Shopify tools covering products, orders, analytics, inventory, and content.

inventory_2 Products

• check_circle List, search, and filter products with pricing and variant information
• check_circle Get full product details including variants, metafields, and SEO metadata
• check_circle Edit product title, description, vendor, tags, SEO, or status
• check_circle Edit variant pricing, SKU, or compare-at price
• check_circle Set metafields on products, variants, or other resources

receipt_long Orders and Analytics

• check_circle List recent orders with financial and fulfilment status
• check_circle Get order details — summary or fully detailed view
• check_circle Run ShopifyQL analytics queries for sales, sessions, customer, or product data

warehouse Store and Inventory

• check_circle Get basic store information — name, plan, currency, and locations
• check_circle View inventory levels by product or location
• check_circle Adjust inventory for a variant at a specific location
• check_circle List all fulfilment locations

article Content

• check_circle List blog articles across all blogs or filter by a specific blog
• check_circle List all blogs on your store
• check_circle Update or create blog articles with full HTML content

Example prompts

Here are some things you can ask Oskuo once Shopify is connected:

• chat_bubble "Show me orders from the last week"
• chat_bubble "Update the description for our bestselling product"
• chat_bubble "What's our conversion rate this month?"
• chat_bubble "List all products with fewer than 5 items in stock"

Good to know

• info Oskuo can't process payments or issue refunds — that still happens in your Shopify admin.
• info Customer records can't be created or edited through Oskuo yet.
• info Theme code and storefront design can't be changed — Oskuo works with products, orders, and content, not the look of your shop.
• info Discount codes and gift cards can't be created through Oskuo yet.

Keeping things secure

• lock The Admin API access token gives programmatic access to your store data. Treat it as a sensitive secret — never share it or commit it to source control.
• lock Only grant the scopes you need. The recommended set above covers all Oskuo tools, but you can remove write scopes for read-only access.
• lock Revoke access at any time by uninstalling the Custom App in Shopify — Oskuo will immediately lose access to your store.
• lock Your credentials are encrypted with AES-256-GCM before storage. They are never sent to the AI model and are only used server-side to call the Shopify API.
• lock All requests to the Shopify API are made over HTTPS, keeping your store data encrypted in transit.
• lock Consider rotating your API token every few months by creating a new Custom App in Shopify and removing the old one.

Troubleshooting

External resources

• Shopify — create and use custom apps