Shopstage with Hermes Agent

Setup steps

1. 1

   In the Shopstage dashboard, create an API key under Settings > Integrations. The key is shown only once.

2. 2

   Set the key as an environment variable: export SHOPSTAGE_API_KEY=...

3. 3

   Add the SKILL.md file to the agent's skill folder and run commands with npx shopstage-cli.

4. 4

   Add --json to the commands; the output becomes JSON the agent can parse.

export SHOPSTAGE_API_KEY=<YOUR_API_KEY>
npx shopstage-cli products --on-sale --json
npx shopstage-cli plan-week --json

Example requests

• “Check my usage quota”
• “List posts for products running low on stock”

What it can do

• list_products

  Lists and searches products, filters discounted ones

• list_posts

  Lists posts by status

• create_post

  Creates a post, Reel, carousel or story from a product

• publish_now

  Publishes a post right away

• plan_week

  Plans the weekly publishing calendar

• get_report

  Gets the performance report

• get_usage

  Shows plan quota and usage