shop-app

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

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

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 orders aggregated from email receipts, check return eligibility, and reorder past purchases from one place. ## 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 and returns: Authenticate via device-authorization flow to fetch orders from all connected stores, view carrier tracking and ETAs, and check return windows and policies. - Reorder and checkout links: Build direct checkout URLs from variant IDs, including multi-item carts and pre-filled customer details. - Use Case: A user asks "Where's my Yoto order?" — the Skill authenticates, fetches up to 50 orders, matches the store, and returns the carrier, tracking URL, and delivery ETA. ## Quick Start Ask the assistant to search Shop.app for wireless earbuds under $50 that ship to your country, or ask it to track a recent order after completing the device sign-in flow.

Frequently Asked Questions about shop-app

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

FAQPage Schema
How do I search for products on Shop.app from the command line?

Send a GET request to https://shop.app/agents/search with a query parameter using curl. You can add filters like min_price, max_price, ships_to, and categories. No authentication is required for product search, and results return as plain-text markdown.

How do I track an order with the Shop.app API?

Authenticate via 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. Filter client-side by store name or order date.

Does Shop.app product search require authentication?

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

How do I find similar products by image on Shop.app?

POST to /agents/search with a JSON body containing the base64-encoded image bytes under similarTo.media. Image URLs are not accepted, so download the image first with curl and encode it with base64 before sending.

Why does the Shop.app token request return authorization_pending?

authorization_pending means the user has not completed sign-in at the provided URL yet. Keep polling the token endpoint at the specified interval; on slow_down add 5 seconds, and restart the flow on expired_token or access_denied.

What are the limitations of the Shop.app shopping assistant?

It cannot process payments, guarantee product quality, or give medical, legal, or financial advice. Prohibited categories like alcohol, weapons, and medications are filtered, and checkout always completes on the merchant's own site.