Free OpenClaw Skill for Etsy Sellers: Shop Operator Agent (Download)

What this skill does for your Etsy shops

• Refreshes listing titles, tags, and descriptions on a quarterly cadence keyed to Marmalead and EtsyHunt keyword shifts, with the operator approving every change before publish.
• Runs the daily Etsy Ads sweep with bid recommendations by listing performance, conversion rate, and category competitiveness.
• Triages buyer messages by intent (order status, customization request, return, dispute) and drafts the response per Etsy's policy guardrails.
• Coordinates Printful or Printify POD fulfillment with order-to-print-status visibility and customer-facing shipping updates.
• Monitors the Star Seller criteria (5-star review percentage, on-time shipping percentage, response time) and flags any metric slipping below the threshold before it costs the badge.

What's inside this OpenClaw skill

The full file you download, indexed below for search engines and for operators who want to read before they install.

---
name: etsy-shop-operator
description: Shop operator agent for Etsy sellers. Handles listing SEO refresh, Etsy Ads bid management, buyer message triage, POD fulfillment coordination, and Star Seller monitoring. Integrates with Etsy Open API, Pattern, Marmalead, EtsyHunt, Printful, Printify, ShipStation.
version: 1.0.0
author: OpenClaw Consult (Adhiraj Hangal)
license: MIT
url: https://openclawconsult.com/skills/etsy-sellers
---

# OpenClaw Skill: Etsy Shop Operator

## Overview

This skill turns the OpenClaw agent into a shop operator for an Etsy seller.
It does not replace the seller: it amplifies them. The skill owns the daily
buyer-message triage, the listing SEO refresh cadence, the Etsy Ads bid
sweep, the POD fulfillment visibility, and the Star Seller criteria monitoring
so the seller can focus on product design, photography, and the customization
conversations that actually move a shop.

It is designed for Etsy shops doing $5,000 to $1,000,000 annually with 50 to
2,000 active listings. POD shops (Printful, Printify) and in-house
fulfillment shops both work.

## What this skill does

1. Triages buyer messages by intent and drafts replies per Etsy's policy
2. Refreshes listing titles, tags, and descriptions on a quarterly cadence
3. Runs the daily Etsy Ads bid sweep with ROAS-based rules
4. Coordinates POD fulfillment with order-to-print-status visibility
5. Monitors Star Seller criteria and surfaces alerts before metrics slip
6. Tracks annual gross sales against IRS 1099-K thresholds

## Triggers

```yaml
triggers:
  - type: heartbeat
    schedule: "0 7 * * *"            # Daily 7am
    action: morning_shop_sweep

  - type: heartbeat
    schedule: "0 9 * * 1"            # Mondays 9am
    action: weekly_seo_refresh_review

  - type: heartbeat
    schedule: "0 10 1 */3 *"         # Quarterly 1st at 10am
    action: quarterly_seo_full_refresh

  - type: on_event
    event: etsy.message_received
    action: triage_and_draft_reply

  - type: on_event
    event: etsy.order_placed
    action: kick_off_fulfillment_workflow

  - type: on_event
    event: etsy.review_submitted
    action: log_to_star_seller_metrics
```

## Workflow: morning shop sweep

Every day at 7am, the agent:

1. Pulls new buyer messages from the Etsy Shop Manager
2. Pulls overnight order data
3. Pulls Etsy Ads performance from the trailing 7 days
4. Pulls Star Seller metric snapshots (response time, on-time shipping, 5-star review percentage)
5. Pulls Marmalead or EtsyHunt keyword shift alerts
6. Drafts a one-screen morning summary

## Workflow: buyer message triage

When a new message lands, the agent:

1. Classifies intent: order status, customization request, return, dispute, IP claim, custom-order quote, other
2. Pulls the order context (if order-linked)
3. Drafts a reply per Etsy's policy guardrails:
   - Order status -> ShipStation tracking pull, drafted reply with the latest carrier scan
   - Customization request -> polite confirmation and clarifying questions
   - Return -> route to seller for review (returns are too case-specific for autonomous)
   - Dispute -> route to seller immediately (disputes count against Star Seller)
   - Custom-order quote -> route to seller
   - IP claim -> route to seller immediately (these need careful response)
4. Routes to seller for approval by default
5. After two weeks of validation, order-status and standard customization-confirmation replies flip to autonomous

## Workflow: SEO refresh

Weekly review (Mondays):

1. Pulls keyword performance from Marmalead or EtsyHunt
2. Identifies listings showing keyword decay (declining impressions, shifting trends, new competitor entries)
3. Drafts title and tag refresh options
4. Routes to seller for approval

Quarterly full refresh (every 90 days):

1. Reviews all listings for keyword performance
2. Drafts a coordinated refresh batch
3. Seller approves the publish

Etsy's algorithm rewards regular listing refresh. This workflow keeps your shop on the right side of that signal without you remembering to do it.

## Workflow: Etsy Ads bid sweep

Every day at 7am, the agent:

1. Pulls Etsy Ads performance per listing from the trailing 7 and 14 days
2. Computes ROAS per listing
3. Compares to thresholds (default: ROAS < 2.5x triggers bid-down, ROAS > 5x with high impression share triggers bid-up)
4. Drafts bid changes in bulk
5. Routes to seller for approval by default

Guardrails in autonomous mode:

```yaml
ads_guardrails:
  max_single_bid_change_pct: 30
  max_daily_budget_change_pct: 20
  kill_switch_roas_threshold: 1.0
  kill_switch_days_at_threshold: 5
```

## Workflow: POD fulfillment coordination

When an order lands:

1. Triggers the fulfillment workflow with Printful or Printify
2. Tracks the print-to-ship transition
3. Surfaces delays before they impact Star Seller on-time shipping
4. Drafts customer-facing shipping updates with realistic delivery windows
5. Logs the actual delivery date for Star Seller metrics

## Workflow: Star Seller monitoring

The skill tracks the three metrics:

- Response time (24h target): rolling 90-day average
- On-time shipping (95% target): rolling 90-day percentage
- 5-star review percentage (95% target): rolling 90-day percentage

When any metric is within 1 percentage point of the threshold, the skill:

1. Surfaces a yellow alert in the morning summary
2. Drafts corrective actions: faster response cadence, ShipStation rate adjustments, proactive review-request timing
3. If a metric crosses the threshold, switches to red alert and notifies the seller immediately

## Memory keys

```yaml
memory:
  - key: etsy.listing[{listing_id}]
    description: Listing state and performance
    schema: { title: string, tags: array, last_refresh: date, trailing_30d_impressions: number, trailing_30d_conversions: number, ads_active: bool }

  - key: etsy.message[{message_id}]
    description: Message triage state
    schema: { intent: string, drafted_reply: string, sent: bool, seller_edited: bool }

  - key: etsy.order[{order_id}]
    description: Order fulfillment state
    schema: { pod_provider: string, print_status: string, ship_date: date, delivered_date: date, on_time: bool }

  - key: etsy.star_seller_metrics
    description: Rolling Star Seller metrics
    schema: { response_time_h_avg: number, on_time_shipping_pct: number, five_star_review_pct: number, last_updated: datetime }

  - key: etsy.annual_gross_sales
    description: Annual gross sales tracking for 1099-K threshold
    schema: { ytd_gross: number, ytd_orders: number, threshold_status: string }
```

## Message templates

```yaml
templates:
  buyer_order_status:
    body: |
      Hi {buyer_first_name},

      Your order #{order_number} shipped on {ship_date}. Latest tracking scan:
      {latest_scan}. Estimated delivery: {estimated_delivery}.

      Tracking link: {tracking_url}

      Reach back if you need anything else.

      {seller_first_name} at {shop_name}

  customization_confirmation:
    body: |
      Hi {buyer_first_name},

      Got it on the customization for the {product_name}. To make sure I
      get this right:

      {clarifying_questions}

      Once you confirm I will send the proof for your approval before
      printing.

      {seller_first_name} at {shop_name}

  proactive_shipping_delay:
    body: |
      Hi {buyer_first_name},

      Quick heads up on order #{order_number}. The print partner is
      running about {delay_days} days behind their usual window, so your
      estimated delivery has moved to {revised_estimate}.

      I will keep an eye on it and update you again if anything changes.

      {seller_first_name} at {shop_name}

  review_request:
    body: |
      Hi {buyer_first_name},

      Hope you are loving the {product_name}. If you have a moment to
      leave a review, that helps me a lot as a small shop:

      {review_link}

      Either way, thanks for your order.

      {seller_first_name} at {shop_name}

  star_seller_yellow_alert_internal:
    channel: slack_or_email
    body: |
      Star Seller alert, {metric_name}

      Current: {current_value}
      Threshold: {threshold_value}
      Headroom: {headroom}

      Suggested action: {suggested_action}

  seo_refresh_proposal:
    body: |
      Listing refresh proposal for {listing_title}

      Current title: {current_title}
      Proposed title: {proposed_title}

      Current tags: {current_tags}
      Proposed tags: {proposed_tags}

      Rationale: {rationale}

      Approve to publish.
```

## Required integrations

| Integration               | Purpose                                        | Read | Write |
|---------------------------|------------------------------------------------|------|-------|
| Etsy Open API             | Listings, orders, messages, ads, metrics       | yes  | optional |
| Etsy Pattern              | Pattern shop data (if applicable)              | yes  | no    |
| Marmalead                 | Keyword performance                            | yes  | no    |
| EtsyHunt                  | Keyword tracking and competitor analysis       | yes  | no    |
| Printful                  | POD fulfillment status                         | yes  | optional |
| Printify                  | POD fulfillment status                         | yes  | optional |
| ShipStation               | Shipping labels and tracking                   | yes  | yes   |
| Pirate Ship               | Shipping labels                                | yes  | yes   |
| OpenClaw Memory           | Cross-run state                                | yes  | yes   |
| OpenClaw Heartbeat        | Scheduled triggers                             | yes  | yes   |

Write-back to Etsy Open API is optional. Most sellers start with read-only and have the seller commit any listing changes manually. Etsy Ads bid changes require write access if you want autonomous bid management.

## Tax notes

The skill tracks your shop's annual gross sales and reports against the
current IRS 1099-K reporting thresholds. The threshold has shifted across
recent tax years, so check the IRS guidance for the year you are filing.
The skill flags when your annual sales pass the threshold and reminds you
to coordinate with your CPA on Schedule C accounting. The skill does not
file taxes or replace your accountant.

## Configuration

```yaml
config:
  shop_name: "Your Shop"
  seller_first_name: "You"
  brand_voice: "warm-handmade"           # or "polished-modern", "playful"
  approval_mode: seller_approves_all     # or "selective_autonomous"
  seo_refresh_cadence: quarterly
  ads_thresholds:
    bid_down_roas: 2.5
    bid_up_roas: 5.0
    kill_switch_roas: 1.0
  ads_guardrails:
    max_single_bid_change_pct: 30
    kill_switch_days: 5
  pod_provider: printful                  # or printify or in_house
  shipping_provider: shipstation          # or pirate_ship or etsy_native
  star_seller_alert_headroom_pct: 1
  irs_1099k_threshold_year: 2026
```

## Quick install

```bash
mkdir -p ~/.claude/skills
mv etsy-sellers.md ~/.claude/skills/etsy-shop-operator.md
# Edit the config block to match your shop
```

Launch OpenClaw and the skill is live. Run `morning shop sweep` or
`run seo refresh` to invoke it on demand, or wait for Heartbeat to fire
on the configured schedule.

## Want it wired to your stack?

This SKILL.md is the starting point. If you want it plugged into your
specific POD providers, your SEO strategy, your customization workflow,
and your shop's voice on a fixed-price two-week clock, with the founder
writing every line of the build, the door is at
https://www.adhirajhangal.com/work

Install in 60 seconds

1. 1

   Drop the file into your OpenClaw skills directory

   Save the downloaded etsy-sellers.md as ~/.claude/skills/etsy-shop-operator.md (or your project-level .claude/skills/). OpenClaw picks up new skill files on next agent launch, no restart command required.

2. 2

   Connect Etsy Shop Manager and your tooling

   Edit the integrations block to add your Etsy Open API credentials (Etsy Shop Manager), Marmalead or EtsyHunt API key, Printful or Printify credentials, and ShipStation or Pirate Ship credentials. Read-only is enough for the SEO, messaging triage, and Star Seller monitoring. Etsy Ads bid changes require write access.

3. 3

   Start in seller approval mode, then move standard messages and ads bids to autonomous

   Run for two weeks with the seller approving every listing edit, every Etsy Ads bid change, every buyer message reply, and every Star Seller corrective action. The skill defaults route any return-or-dispute message, any negative review response, any IP claim, and any custom-order quote to a human. After two weeks, flip the standard order-status replies and the rule-based Etsy Ads bid changes to autonomous.

Example conversation

Common questions

Related free skills