shop-app

Search products, track orders, and manage returns via Shop.app's agent API.

Updated May 11, 2026
One-click install
npx skills add https://github.com/jason660519/Project-Manager --skill shop-app-jason660519
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shop-app
Source: https://github.com/jason660519/Project-Manager/tree/main/hermes-agent/optional-skills/productivity/shop-app
Command: npx skills add https://github.com/jason660519/Project-Manager --skill shop-app-jason660519

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shop.app provides a unified interface to search products across stores, track orders, and manage returns and reorders, reducing friction in cross-store shopping.

Core Features & Use Cases

  • Product Search: discover items across multiple shops and compare prices with availability information using the /agents/search endpoint.
  • Authenticated Actions: track orders, manage returns, and reorders via a device-code flow, with per-session tokens stored in memory and never persisted.
  • Order Management & Returns: fetch orders, view statuses, access tracking details, and generate checkout or reorder links.

Quick Start

Ask Shop.app to search products across stores and track an order or initiate a return.

Frequently Asked Questions about shop-app

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

FAQPage Schema
How do I track orders and manage returns across multiple ecommerce stores?

Track orders and manage returns across stores by using a Shop.app agent API that fetches order statuses, tracking details, and return links via authenticated endpoints. It requires a device-code flow to generate per-session tokens for secure access.

Can I search for products across different shops without authentication?

Product search across different shops does not require authentication. The Shop.app API operates on a two-tier model where the search endpoint is open, allowing you to discover items and compare prices without needing a device-code login.

How does the device-code flow work for secure order tracking and reorders?

The device-code flow authenticates users for order tracking and reorders by generating per-session tokens stored in memory. This ensures secure access to order management actions without persisting credentials.

Do I need an HTTP client to query the Shop.app agent API for product search?

You need an HTTP client like curl to query the Shop.app agent API for product search. The API uses endpoints such as the search URL to return product availability and pricing data in plain-text markdown.

What are the limitations of using in-memory tokens for ecommerce order management?

In-memory tokens for ecommerce order management are never persisted, meaning authentication is lost when the session ends. This limitation requires re-authentication via the device-code flow for each new session to access orders and returns.

Can I generate checkout links for reordering products through an agent API?

Generate checkout links for reordering products through the Shop.app agent API by accessing the orders endpoint. Authenticated requests fetch order histories and produce direct reorder links in plain-text markdown format.