shop-app

Search products, track orders, manage returns, and build checkout URLs via the Shop.app agent API.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill shop-app-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shop-app
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/optional-skills/productivity/shop-app
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill shop-app-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shopping across multiple stores requires juggling separate sites for product discovery, order tracking, returns, and reordering. This Skill connects to Shop.app's agent API so you can search products across stores, track deliveries, check return eligibility, and reorder past purchases from one conversation. ## Core Features & Use Cases - Cross-Store Product Search: Query Shop.app's catalog with filters for price, shipping country, availability, and category, plus find similar items by variant ID or image. - Order Tracking & Management: Authenticate via device-authorization flow to fetch orders aggregated from all connected stores, view tracking details, and check delivery ETAs. - Returns & Reordering: Look up return policies and eligibility per product, then build checkout URLs from past order variant IDs to reorder items. - Use Case: Ask "Where's my Yoto order?" and the Skill authenticates, fetches your recent orders, finds the matching store, and presents carrier, tracking code, and ETA. ## Quick Start Ask the agent to search Shop.app for wireless earbuds under $50 that ship to the US and show the top-rated options with buy links.

Frequently Asked Questions about shop-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search products across multiple stores with Shop.app?▼

Send a GET request to https://shop.app/agents/search with a query parameter and optional filters like min_price, max_price, and ships_to. No authentication is required for product search, and results return as plain-text markdown with prices, ratings, and checkout links.

How to track an order using the Shop.app API?▼

Authenticate through the device-authorization flow, then fetch orders from /agents/orders with your bearer token. Each order includes a Tracking section with carrier, tracking code, tracking URL, and ETA for in-transit deliveries.

Does Shop.app product search require authentication?▼

No, product search and similar-product lookup work without any authentication. Auth via the RFC 8628 device-authorization flow is only required for per-user operations like orders, tracking, returns, and reordering.

Can I find similar products from an image with Shop.app?▼

Yes, POST to /agents/search with a base64-encoded image in the similarTo.media field. You must download the image first and encode it with base64, since image URLs are not accepted by the endpoint.

Why does the Shop.app token request return authorization_pending?▼

The authorization_pending error means the user has not yet completed sign-in at the provided URL. Keep polling the token endpoint at the specified interval until the user authorizes, and add 5 seconds if you receive a slow_down response.

What are the limitations of the Shop.app shopping skill?▼

The skill cannot process payments, guarantee product quality, or complete purchases; users pay on the store's own site. Prohibited categories like alcohol, weapons, and medications are filtered, and product data is merchant-supplied.