Overview
Queries your Shopify store for real-time data when agents need fresh data not yet synced to the database.
When to Use
- Specific order lookup for CS enrichment (freshest data)
- Product search by SKU/name against live catalog
- Real-time low stock check
- Customer info for CS enrichment
- Do NOT use for: aggregate reports (use database), bulk data sync (use backfill scripts), write operations (not supported)
Workflow
- Determine query type (order, product, inventory, recent-orders, customer)
- Run the appropriate query from
references/query-patterns.md
- Parse JSON response; handle
{"error": "..."} if present
- Log any customer data access with purpose (compliance)
| Need | Use |
|---|
| Aggregate reports, P&L, margins |