shop-app

Search Shop.app products and manage orders, returns, and reorders via curl.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl.

What problem does it solve?

It removes the hassle of searching for products, comparing options, and handling order tracking, returns, and reordering inside Shop.app without manually navigating multiple store workflows.

Core Features & Use Cases

  • Product search without auth: Find items across stores and compare results quickly for price, brand, rating, and links.
  • Similarity discovery: Find similar products by variant ID or by uploading an image for visual matching.
  • Authenticated account actions: Use device authorization to fetch orders, view tracking details, check return eligibility/policies, and generate reorder checkout links.

Quick Start

Tell Hermes to search for “wireless earbuds under $50 shipped to US” in Shop.app.

Frequently Asked Questions about shop-app

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

FAQPage Schema
How do I track my orders and check return eligibility in Shop.app?

Order tracking and return eligibility checks in Shop.app require a secure device authorization token. Once authenticated in-session, you can fetch order details, view tracking updates, and review return policies across all connected stores.

How do I search for products and compare prices across different stores?

Product search in Shop.app works without authentication, allowing you to find items across stores and compare results. You can filter by price, brand, rating, and links to quickly evaluate options before purchasing.

Can I find similar products using a variant ID or an image?

Similarity discovery in Shop.app supports finding comparable products by variant ID or by uploading an image for visual matching. This enables variant-based similarity lookup to find alternative items across connected stores.

Do I need to log in every time to generate reorder checkout links?

Reorder checkout links require authenticated account actions using a device authorization token. The token is handled securely in-session only, meaning you must authorize your device during the session to fetch past orders and generate checkout URLs.

What dependencies are required to use Shop.app for product discovery and order management?

Shop.app integration requires curl to make API calls to Shop.app endpoints. The Skill uses curl-based calls for product discovery, similarity lookup, and authenticated order tracking, with plain-text markdown parsing for extracted fields.

Can I narrow down a broad product search to specific variants in Shop.app?

Shop.app supports broad-to-narrow searches for product discovery. You can start with a general search query and then use variant-based similarity lookup to find specific product variations across stores.