Shopstage with shopstage-cli

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

   Run the commands: products, posts, post create, publish, plan-week, report, usage.

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 --query "bag" --json
npx shopstage-cli post create --product <id> --format reels
npx shopstage-cli publish <postId>

Example requests

• “npx shopstage-cli plan-week”
• “npx shopstage-cli media shoot --product <id> --shots beyaz-fon,premium-tema --motion yavas-yaklasma”
• “npx shopstage-cli orders --from 2026-10-01”

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