KosmoKrator

ecommerce

Etsy CLI for Cron Jobs

Use the Etsy CLI for cron jobs with headless JSON commands, schema discovery, credentials, and permission controls.

6 functions 5 read 1 write Manual OAuth token auth

Etsy CLI for Cron Jobs

Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config.

Use the headless CLI from cron when an operation should run without an interactive agent session. The Etsy CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Etsy CLI for Cron Jobs
kosmokrator integrations:configure etsy --set access_token="$ETSY_ACCESS_TOKEN" --set shop_id="$ETSY_SHOP_ID" --enable --read allow --write ask --json
kosmo integrations:call etsy.etsy_list_listings '{"state":"example_state","limit":1,"offset":1}' --json

Discovery Before Execution

Agents and scripts can inspect Etsy docs and schemas before choosing a function.

kosmo integrations:docs etsy --json
kosmo integrations:docs etsy.etsy_list_listings --json
kosmo integrations:schema etsy.etsy_list_listings --json
kosmo integrations:search "Etsy" --json
kosmo integrations:list --json

Useful Etsy CLI Functions

FunctionTypeParametersDescription
etsy.etsy_list_listings Read state, limit, offset List all listings in the Etsy shop. Returns paginated results with optional state filtering (active, draft, inactive, expired).
etsy.etsy_get_listing Read listing_id Get full details for a specific Etsy listing, including title, description, price, images, and state.
etsy.etsy_create_listing Write title, description, price, quantity, shipping_profile_id, taxonomy_id, tags, who_made, when_made, is_supply Create a new listing in the Etsy shop. Requires a title, description, price, quantity, and shipping profile ID.
etsy.etsy_list_orders Read limit, offset, was_paid, was_shipped List orders (receipts) for the Etsy shop. Returns paginated order data including buyer info, items, and totals.
etsy.etsy_get_listing_inventory Read listing_id Get the inventory (products, offerings, and pricing) for a specific Etsy listing.
etsy.etsy_get_current_user Read none Get the profile of the currently authenticated Etsy user, including user ID and primary shop info.

Automation Notes

Related Etsy CLI Pages