mguozhen

---
name: social-audience-profiler
description: "Target audience profiler for social media strategy. Build detailed audience personas with psychographics, pain points, content preferences, and platform behavior — so every post speaks directly to the right people. Triggers: target audience, audience profile, audience persona, ideal customer, ICP social media, audience analysis, who to target"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/social-audience-profiler
---

# Social Audience Profiler

Build 3 deep audience personas that make your content feel like it was written for one specific person.

## Usage

```
audience profile: sustainable fashion brand targeting Gen Z
target audience: B2B SaaS selling to HR managers
audience persona: fitness app for busy moms 30-45
ICP: personal finance content for young professionals
```

## What You Get

1. **3 Audience Personas** — primary, secondary, and aspirational
2. **Psychographic Deep Dive** — values, fears, desires, worldview
3. **Content Behavior Map** — what they watch, read, save, share
4. **Pain Point Matrix** — surface, intermediate, and root-level pain
5. **Message-Market Fit** — exact language they use about their problem
6. **Platform Presence** — where to find them and when they scroll

FILE:analyze.sh
#!/usr/bin/env bash
set -euo pipefail
INPUT="-"
[ -z "$INPUT" ] && echo "Usage: audience profile: <brand/product and target market>" && exit 1
SESSION_ID="audience-$(date +%s)"
PROMPT="You are an audience research expert specializing in social media strategy. Build 3 detailed audience personas for: INPUT

## Persona 1: Primary Audience (Core Buyer)

### Demographics
- Age range: 
- Gender split: 
- Location/market: 
- Income level: 
- Education: 
- Job/role: 

### Psychographics
- Core values (top 5): 
- Identity: how they see themselves
- Aspirations: what they want their life to look like in 3 years
- Fears: top 3 things that keep them up at night
- Frustrations: what makes them rage-quit products/services
- Guilty pleasures: what they secretly enjoy

### Pain Point Matrix
| Level | Pain | How They Describe It |
|-------|------|----------------------|
| Surface (what they say) | | |
| Intermediate (what they mean) | | |
| Root (what they actually feel) | | |

### Content Behavior
- Platforms they actively use (ranked): 
- Time of day they scroll: 
- Content they stop to watch: 
- Content they save: 
- Content they share with friends: 
- Content they immediately swipe past: 
- Accounts they follow in this space: [types, not specific names]

### Language & Vocabulary
- Words they use to describe their problem: [quote-style phrases]
- Words they use to describe their goal: [quote-style phrases]
- Phrases that trigger them: [words that feel salesy or fake]
- Phrases that resonate: [words that feel real]

### Message-Market Fit
The ONE sentence that would stop them mid-scroll: 
[Write it]

---

## Persona 2: Secondary Audience (Aspirers)
[Repeat same structure but for secondary audience]

---

## Persona 3: Aspirational Audience (Dream Customers)
[Repeat same structure for aspirational/future audience]

---

## Platform Strategy by Persona
| Platform | Best Persona | Best Content Type | Best Time |
|----------|-------------|-------------------|-----------|
| Instagram | | | |
| TikTok | | | |
| LinkedIn | | | |
| X/Twitter | | | |
| YouTube | | | |
| Pinterest | | | |

## Content Themes That Resonate
For each persona, the top 5 content topics that will get them to stop, engage, and follow:
- Persona 1: [5 topics]
- Persona 2: [5 topics]
- Persona 3: [5 topics]"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json,sys
data=json.load(sys.stdin)
texts=[p.get('text','') for p in data.get('payloads',[]) if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)
[ -z "$REPORT" ] && echo "Error: Could not generate audience profile." && exit 1
echo ""
echo "=== AUDIENCE PROFILER === INPUT ==="
echo ""
echo "$REPORT"

---
name: social-thread-converter
description: "Convert any long-form content into viral Twitter/X threads, LinkedIn posts, or Threads posts. Paste an article, blog post, or idea and get a platform-ready thread with hooks, numbered tweets, and a strong closer. Triggers: thread writer, twitter thread, X thread, thread converter, thread maker, long post, article to thread, blog to thread"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/social-thread-converter
---

# Social Thread Converter

Turn any content into a viral thread — optimized for X/Twitter, LinkedIn, or Threads.

## Usage

```
thread: convert this blog post into a Twitter thread: [paste content]
X thread: turn this into a viral thread about productivity
LinkedIn thread: make a post from this article about AI trends
thread maker: [paste long text] → X thread
```

## What You Get

1. **Full Thread Script** — every tweet/post numbered and character-checked
2. **Hook Tweet** — 3 options for the opening
3. **Thread Structure** — intro → value → close framework
4. **Character Count** — each tweet verified under 280 chars
5. **Engagement Tactics** — where to add polls, images, or quotes
6. **Closing Tweet** — follow/retweet CTA options

FILE:analyze.sh
#!/usr/bin/env bash
set -euo pipefail
INPUT="-"
[ -z "$INPUT" ] && echo "Usage: thread: <content or topic to convert>" && exit 1
SESSION_ID="thread-$(date +%s)"
PROMPT="You are a viral thread writer specializing in X/Twitter, LinkedIn, and Threads. Convert this into a high-performing thread: INPUT

## Platform Selection
Identify the target platform from the input. Default to X/Twitter if not specified.

## Hook Options (3 Alternatives for Tweet 1)
Write 3 alternative opening tweets — each under 280 characters:
**Hook A:** [bold claim or counterintuitive take]
**Hook B:** [\"I [did X]. Here's what I learned:\" format]
**Hook C:** [data or number-led hook]

## Full Thread Script
Write the complete thread — aim for 8-15 tweets depending on content depth.

For EACH tweet:
**Tweet [N]:** 
[Content — max 270 characters, leave room for numbering]
Character count: [X/280]
[Add any media suggestion in brackets if applicable]

Rules:
- Each tweet must stand alone and deliver value
- End each middle tweet with a micro-hook to keep reading
- Use line breaks for readability (2 lines max per tweet)
- No filler tweets — every tweet must earn its place
- Number format: use \"[N/]\" at tweet start (e.g., \"2/ Here's the thing...\")

## Closer Tweet Options
**Closer A — Follow CTA:**
[Tweet asking for a follow + what they'll get]

**Closer B — Retweet CTA:**
[Tweet asking to RT if they found it valuable]

**Closer C — Soft Sell:**
[Tweet pointing to a resource/product/newsletter]

## Engagement Boosters
Suggest where in the thread to add:
- A poll (Tweet X): [poll question + options]
- An image/graphic (Tweet X): [what to show]
- A quote tweet of yourself (if applicable)

## LinkedIn Adaptation
Condense the thread into a single long-form LinkedIn post (max 3,000 chars):
- Keep the hook
- Merge middle points into flowing paragraphs
- Add LinkedIn-specific formatting (line breaks, no hashtags mid-post)

## Thread Stats Prediction
- Expected thread length: [X] tweets, ~[Y] words
- Read time: ~[Z] minutes
- Best posting time for this topic: [day + time]"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json,sys
data=json.load(sys.stdin)
texts=[p.get('text','') for p in data.get('payloads',[]) if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)
[ -z "$REPORT" ] && echo "Error: Could not convert to thread." && exit 1
echo ""
echo "=== THREAD CONVERTER === INPUT ==="
echo ""
echo "$REPORT"

---
name: social-carousel-writer
description: "LinkedIn and Instagram carousel script writer. Generate complete slide-by-slide carousel content with hooks, value slides, and CTAs that drive saves and shares. Triggers: carousel, carousel writer, LinkedIn carousel, Instagram carousel, slide deck, carousel script, swipe post, carousel post"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/social-carousel-writer
---

# Social Carousel Writer

Write a complete, ready-to-design carousel post — every slide scripted and structured.

## Usage

```
carousel: 10 slides about the mistakes new founders make
LinkedIn carousel: how to write cold emails that get replies
Instagram carousel: morning routine that 10x'd my productivity
carousel writer: 7 tools every social media manager needs
```

## What You Get

1. **Complete Slide Script** — every slide written out (headline + body + visual direction)
2. **Hook Slide Options** — 3 alternative cover slides to A/B test
3. **Visual Design Notes** — layout and style suggestions per slide
4. **CTA Slide** — 3 versions of the final slide
5. **Caption** — full post caption to accompany the carousel
6. **Hashtag Set** — 20 optimized hashtags

FILE:analyze.sh
#!/usr/bin/env bash
set -euo pipefail
INPUT="-"
[ -z "$INPUT" ] && echo "Usage: carousel: <topic and slide count>" && exit 1
SESSION_ID="carousel-$(date +%s)"
PROMPT="You are a carousel content specialist for LinkedIn and Instagram. Write a complete carousel post for: INPUT

## Cover Slide (3 Options to A/B Test)
**Option A:** [Headline — bold, curiosity-driven]
**Option B:** [Headline — number-led, promise-based]
**Option C:** [Headline — question format]
Visual direction: [background style, font weight, visual element suggestion]

## Slide-by-Slide Script
For each slide (aim for 8-12 slides total based on the topic):

**Slide [N]: [Slide Title]**
- Headline: [bold, short — max 8 words]
- Body text: [2-4 lines of supporting copy — clear and punchy]
- Visual direction: [what to show — icon / illustration / data visualization / photo / minimal text]
- Transition hook: [optional — last line that makes reader swipe]

[Write all slides]

## CTA Slide (3 Options)
**Option A — Save:**
[Write save-focused CTA slide]

**Option B — Follow:**
[Write follow-focused CTA slide]

**Option C — Comment:**
[Write comment-focused CTA slide]

## Post Caption
Write the full caption to accompany the carousel (150-300 words):
- Hook line
- Brief context
- Tease the content
- CTA to swipe / save
- Sign off

## Hashtag Set
30 hashtags split into 3 tiers:
- Niche (under 100K): [10 hashtags]
- Mid (100K-1M): [10 hashtags]
- Large (1M+): [10 hashtags]

## Design Tips
Quick Canva/Figma tips to make this carousel look great:
- Recommended dimensions: [for LinkedIn / Instagram]
- Font pairing suggestion
- Color palette idea
- One design trick that increases saves"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json,sys
data=json.load(sys.stdin)
texts=[p.get('text','') for p in data.get('payloads',[]) if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)
[ -z "$REPORT" ] && echo "Error: Could not generate carousel script." && exit 1
echo ""
echo "=== CAROUSEL SCRIPT === INPUT ==="
echo ""
echo "$REPORT"

---
name: social-brand-voice
description: "Brand voice guide creator for social media. Define your brand's tone, vocabulary, writing rules, and examples across platforms — so every post sounds consistently on-brand. Triggers: brand voice, tone of voice, brand personality, writing style, brand guide, brand tone, voice guide, content tone"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/social-brand-voice
---

# Social Brand Voice

Build a complete brand voice guide so your content always sounds like YOU.

## Usage

```
brand voice: DTC skincare brand targeting millennial women
tone of voice: B2B fintech startup professional but approachable
brand guide: personal brand for senior software engineer
voice guide: outdoor adventure e-commerce brand fun and bold
```

## What You Get

1. **4 Voice Dimensions** — personality traits with do/don't examples
2. **Tone Spectrum** — where you sit on 5 key tone axes
3. **Vocabulary Guide** — words to use and words to ban
4. **Platform Voice Variants** — how the voice adapts per platform
5. **Before/After Examples** — rewrites showing voice in action
6. **Quick Reference Card** — one-page cheat sheet for your team

FILE:analyze.sh
#!/usr/bin/env bash
set -euo pipefail
INPUT="-"
[ -z "$INPUT" ] && echo "Usage: brand voice: <brand description and target audience>" && exit 1
SESSION_ID="voice-$(date +%s)"
PROMPT="You are a brand strategist specializing in voice and tone. Create a complete brand voice guide for: INPUT

## Brand Personality
Define 4 core personality traits (like 'The Trusted Expert' + 'The Witty Friend'):
For each trait:
- Trait name: [X]
- What it means in practice: [description]
- In our content we: [3 behaviors]
- We never: [3 anti-behaviors]

## Tone Spectrum
Rate on 5 axes (1=left extreme, 10=right extreme):
| Axis | 1 | Score | 10 |
|------|---|-------|-----|
| Formal | | X/10 | Casual |
| Serious | | X/10 | Playful |
| Reserved | | X/10 | Bold |
| Professional | | X/10 | Conversational |
| Distant | | X/10 | Warm |

## Vocabulary Guide
**Words/phrases we love:** [20 specific words that fit the brand]
**Words/phrases we ban:** [20 words that kill the vibe]
**Phrases we own:** [5 signature phrases unique to this brand]
**Emojis we use:** [approved emoji set]
**Emojis we avoid:** [banned emojis]

## Sentence & Structure Rules
- Average sentence length: [X words — short/medium/long]
- Paragraph length: [X sentences max]
- Use of questions: [how often and what kind]
- Use of lists: [when yes, when no]
- Punctuation style: [rules]
- Capitalization: [rules]

## Platform Voice Variants
How the core voice adapts without losing identity:
| Platform | Tone Shift | Format Notes | Example Opening |
|----------|-----------|--------------|-----------------|
| LinkedIn | | | |
| Instagram | | | |
| TikTok | | | |
| X/Twitter | | | |
| Email | | | |

## Before & After Rewrites
Take 3 generic captions and rewrite them in brand voice:

**Post 1 — Product Announcement:**
Before: 'Excited to announce our new product is available now!'
After: [rewrite in brand voice]

**Post 2 — Educational Content:**
Before: 'Here are 5 tips to improve your workflow.'
After: [rewrite in brand voice]

**Post 3 — Customer Story:**
Before: 'Check out what our customer said about us!'
After: [rewrite in brand voice]

## One-Page Quick Reference Card
Summarize everything in a cheat sheet format:
BRAND VOICE: [4 words]
WE SOUND LIKE: [analogy — e.g., 'your smartest friend at a dinner party']
WE NEVER SAY: [top 5 banned phrases]
WE ALWAYS: [top 5 must-do behaviors]
OUR SIGNATURE MOVE: [one thing that makes our writing unmistakably us]"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json,sys
data=json.load(sys.stdin)
texts=[p.get('text','') for p in data.get('payloads',[]) if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)
[ -z "$REPORT" ] && echo "Error: Could not generate brand voice guide." && exit 1
echo ""
echo "=== BRAND VOICE GUIDE === INPUT ==="
echo ""
echo "$REPORT"

---
name: social-content-pillars
description: "Content pillar strategy builder for brands and creators. Define 5 core content pillars, generate 50+ post ideas, and build a repeatable content system that builds authority and grows followers. Triggers: content pillars, content strategy, content system, content topics, content buckets, content framework, editorial strategy"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/social-content-pillars
---

# Social Content Pillars

Build a sustainable content strategy with 5 pillars and 50+ post ideas ready to go.

## Usage

```
content pillars: B2B SaaS founder on LinkedIn
content strategy: fitness coach Instagram + TikTok
content system: e-commerce brand selling eco products
content pillars: freelance designer building personal brand
```

## What You Get

1. **5 Content Pillars** — with rationale and audience impact
2. **50+ Post Ideas** — 10 per pillar, across formats
3. **Content Mix Formula** — how often to post each pillar
4. **Format Guide** — which format works best per pillar
5. **Pillar Hierarchy** — which pillar to lead with for fastest growth
6. **Content Calendar Skeleton** — 4-week repeating schedule

FILE:analyze.sh
#!/usr/bin/env bash
set -euo pipefail
INPUT="-"
[ -z "$INPUT" ] && echo "Usage: content pillars: <brand/creator description and platform>" && exit 1
SESSION_ID="pillars-$(date +%s)"
PROMPT="You are a content strategy expert. Build a complete content pillar system for: INPUT

## Brand/Creator Analysis
- Audience profile: [who they are, what they want]
- Platform primary: [best fit platform]
- Voice: [recommended tone]
- Unique angle: [what makes this different]

## 5 Content Pillars

For each pillar:
### Pillar [N]: [NAME]
- **Purpose:** [why this pillar exists — what it does for the audience]
- **Audience benefit:** [what they get from it]
- **Business benefit:** [what the creator/brand gets]
- **Content ratio:** X% of total posts
- **Best formats:** [reel / carousel / text post / story / thread]
- **10 Post Ideas:**
  1. [Specific post idea with angle]
  2. [Specific post idea]
  3. [Specific post idea]
  4. [Specific post idea]
  5. [Specific post idea]
  6. [Specific post idea]
  7. [Specific post idea]
  8. [Specific post idea]
  9. [Specific post idea]
  10. [Specific post idea]

[Repeat for all 5 pillars]

## Content Mix Formula
Weekly posting rhythm:
| Day | Pillar | Format | Goal |
|-----|--------|--------|------|
| Mon | | | |
| Tue | | | |
| Wed | | | |
| Thu | | | |
| Fri | | | |
| Sat | | | |
| Sun | | | |

## Growth Pillar Strategy
- Pillar to prioritize for fastest follower growth: [Pillar X] — why
- Pillar for deepest engagement: [Pillar X] — why
- Pillar for conversions/sales: [Pillar X] — why

## First 30 Days Post Plan
Map out the first 30 posts using the pillar system — one post per day, pillar rotation."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json,sys
data=json.load(sys.stdin)
texts=[p.get('text','') for p in data.get('payloads',[]) if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)
[ -z "$REPORT" ] && echo "Error: Could not generate content pillars." && exit 1
echo ""
echo "=== CONTENT PILLAR STRATEGY === INPUT ==="
echo ""
echo "$REPORT"

---
name: social-caption-ab-writer
description: "Caption A/B variant writer for social media. Generate 5 caption variations for any post with different angles, tones, and CTAs — ready to split test across Instagram, LinkedIn, TikTok, and X. Triggers: caption writer, caption variants, A/B caption, social media caption, post caption, caption generator, write caption"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/social-caption-ab-writer
---

# Social Caption A/B Writer

Generate 5 battle-tested caption variants for any post, ready to A/B test.

## Usage

```
caption: write 5 variants for a product launch post about wireless earbuds
caption writer: LinkedIn post about my startup's first 100 customers
A/B caption: Instagram post promoting a 30% off sale
caption variants: TikTok about morning routine productivity tips
```

## What You Get

1. **5 Caption Variants** — different angles, tones, and structures
2. **Hashtag Sets** — 3 hashtag groups optimized per variant
3. **CTA Variations** — different call-to-action styles tested
4. **Best Posting Time** — when to post each variant
5. **Testing Framework** — how to run the A/B test properly
6. **Winner Prediction** — which variant is most likely to win and why

FILE:analyze.sh
#!/usr/bin/env bash
set -euo pipefail
INPUT="-"
[ -z "$INPUT" ] && echo "Usage: caption: <post topic and platform>" && exit 1
SESSION_ID="caption-$(date +%s)"
PROMPT="You are a social media copywriter specializing in A/B testing captions. Write 5 caption variants for: INPUT

## 5 Caption Variants

**Variant A — Storytelling**
[Write full caption using narrative arc, personal angle]
Hashtags: [10 relevant hashtags]
CTA: [soft CTA]
Predicted engagement style: comments

**Variant B — Educational/Value-First**
[Write full caption leading with the takeaway/lesson]
Hashtags: [10 relevant hashtags]
CTA: [save/share CTA]
Predicted engagement style: saves

**Variant C — Punchy & Direct**
[Write full caption — short, bold, no fluff, direct offer]
Hashtags: [10 relevant hashtags]
CTA: [link in bio CTA]
Predicted engagement style: clicks

**Variant D — Question/Engagement Bait**
[Write full caption ending with a question that prompts replies]
Hashtags: [10 relevant hashtags]
CTA: [comment CTA]
Predicted engagement style: comments

**Variant E — Social Proof/Results**
[Write full caption leading with results, numbers, transformation]
Hashtags: [10 relevant hashtags]
CTA: [DM CTA]
Predicted engagement style: DMs + saves

## Winner Prediction
- Most likely to win: Variant [X]
- Why: [specific reason based on platform + topic]
- Dark horse: Variant [X] — could surprise if [condition]

## A/B Testing Framework
- Test duration: X days minimum
- Audience split: [how to split]
- Primary metric to track: [metric]
- Secondary metrics: [list]
- Decision threshold: [when to call a winner]

## Platform Adaptation Notes
Adjust the winning variant for:
- Instagram: [specific tweak]
- LinkedIn: [specific tweak]
- TikTok: [specific tweak]
- X/Twitter: [trim to 280 chars version]"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json,sys
data=json.load(sys.stdin)
texts=[p.get('text','') for p in data.get('payloads',[]) if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)
[ -z "$REPORT" ] && echo "Error: Could not generate captions." && exit 1
echo ""
echo "=== CAPTION A/B WRITER === INPUT ==="
echo ""
echo "$REPORT"

---
name: social-hook-generator
description: "Viral hook generator for social media posts. Generate 10+ scroll-stopping opening lines for X/Twitter, LinkedIn, TikTok, Instagram, and Threads optimized for each platform's algorithm and audience behavior. Triggers: hook generator, viral hook, scroll stop, opening line, post hook, attention grabber, first line"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/social-hook-generator
---

# Social Hook Generator

Generate scroll-stopping hooks for any platform, topic, and audience in seconds.

## Usage

```
hook: write hooks for a post about email marketing tips
viral hook: LinkedIn post about remote work productivity
hook generator: TikTok about AI tools for small business
scroll stop: Instagram reel about sustainable fashion
```

## What You Get

1. **10 Hook Variations** — different styles (question, bold claim, story, data, controversy)
2. **Platform-Optimized** — tailored to X, LinkedIn, TikTok, Instagram, Threads
3. **Emotion Triggers** — curiosity, FOMO, surprise, relatability, aspiration
4. **A/B Test Pairs** — top 3 hooks paired for split testing
5. **Hook Scoring** — rated by predicted CTR and scroll-stop power
6. **Customization Tips** — how to make each hook your own

FILE:analyze.sh
#!/usr/bin/env bash
set -euo pipefail
INPUT="-"
[ -z "$INPUT" ] && echo "Usage: hook: <topic and platform>" && exit 1
SESSION_ID="hook-$(date +%s)"
PROMPT="You are a viral content expert who writes scroll-stopping social media hooks. Generate hooks for: INPUT

## Platform Analysis
First identify the target platform(s) from the input. If not specified, cover: X/Twitter, LinkedIn, TikTok/Instagram.

## 10 Hook Variations
Write 10 hooks using these proven styles:

1. **Bold Claim** — make a surprising, counterintuitive statement
2. **Curiosity Gap** — hint at something without revealing it
3. **Question Hook** — ask a question that hits a pain point
4. **Data/Stats** — lead with a specific, surprising number
5. **Story Setup** — open mid-scene or with a relatable moment
6. **Contrarian Take** — challenge a common belief
7. **\"I Did X\" Hook** — personal experience that promises value
8. **List Hook** — promise N things the reader needs
9. **\"Most People Don't Know\"** — exclusivity and insight
10. **FOMO/Urgency** — create fear of missing out

For each hook:
- Write the hook (under 280 chars for X, under 150 chars for TikTok)
- Name the emotion trigger it activates
- Rate scroll-stop power: 🔥 (low) / 🔥🔥 (medium) / 🔥🔥🔥 (high)

## Top 3 A/B Test Pairs
Pick the 3 strongest hooks and pair each with a variant for split testing:
- Hook A: [original]
- Hook B: [same idea, different angle]

## Platform Customization
How to adapt the top hook for each platform:
- X/Twitter: [specific adaptation]
- LinkedIn: [specific adaptation]
- TikTok caption: [specific adaptation]
- Instagram Reels: [specific adaptation]
- Threads: [specific adaptation]

## Hook Writing Rules
Remind the user of the 3 rules to never break when writing hooks."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json,sys
data=json.load(sys.stdin)
texts=[p.get('text','') for p in data.get('payloads',[]) if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)
[ -z "$REPORT" ] && echo "Error: Could not generate hooks." && exit 1
echo ""
echo "=== VIRAL HOOK GENERATOR === Topic: INPUT ==="
echo ""
echo "$REPORT"

---
name: shopify-theme-selector
description: "Shopify theme recommendation and evaluation for any niche. Compare free vs paid themes, analyze conversion features, and get a customization roadmap for your store type and target audience. Triggers: Shopify theme, theme selection, store design, Shopify template, theme recommendation, free theme, paid theme, store template"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-theme-selector
---

# Shopify Theme Selector

Get the perfect Shopify theme recommendation based on your niche, budget, and conversion goals — plus a customization roadmap.

## Usage

```
theme: recommend for pet accessories store
Shopify theme: best for luxury fashion brand
store design: minimalist home decor under $300 budget
theme selector: high-converting theme for supplements
```

## What You Get

1. **Top 5 Theme Recommendations** — scored by fit for your niche
2. **Free vs Paid Comparison** — when to upgrade and when not to
3. **Conversion Feature Checklist** — must-have elements for your niche
4. **Customization Priority List** — what to change first out-of-the-box
5. **App Stack to Pair** — which apps complete the theme's functionality
6. **Page Speed Impact** — which themes are fastest
7. **Mobile Experience Score** — mobile UX comparison across themes

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-theme-selector — Theme recommendation and evaluation for Shopify stores
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: theme: <niche, budget, and goals>"
  echo "Example: theme: recommend for pet accessories store \$200 budget high conversion"
  exit 1
fi

SESSION_ID="theme-$(date +%s)"

PROMPT="You are a Shopify store design expert with deep knowledge of themes, conversion rate optimization, and niche-specific UX patterns. Recommend and evaluate themes for: INPUT

## 1. Niche Design Requirements
For this store type, critical design elements are:
- Layout type: single product / catalog / brand story / hybrid
- Visual hierarchy priority: [product / brand / trust / urgency]
- Key conversion elements needed: [list 5]
- Color psychology recommendation: [palette]
- Typography style: [recommendation]
- Mobile UX requirements: [specific to niche]

## 2. Top 5 Theme Recommendations
Score each theme /100:

**#1 Recommendation: [Theme Name]** (Score: X/100)
- Price: Free / $[price]
- Best for: [use case]
- Conversion features: [list]
- Page speed (Google rating): [fast/average/slow]
- Mobile score: [X/10]
- Customization difficulty: [easy/medium/hard]
- Why it wins for this niche: [specific reason]
- Main limitation: [one weakness]

**#2: [Theme Name]** (Score: X/100)
[Same format]

**#3: [Theme Name]** (Score: X/100)
[Same format]

**#4: [Theme Name]** (Score: X/100)
[Same format]

**#5: [Theme Name]** (Score: X/100)
[Same format]

## 3. Free vs Paid Decision Framework
**Go free if:**
- [Criteria 1]
- [Criteria 2]
- [Criteria 3]

**Invest in paid ($180-$380) if:**
- [Criteria 1]
- [Criteria 2]
- [Criteria 3]

**ROI calculation:** A paid theme that improves CVR by 0.5% on $X/month revenue pays back in X months.

## 4. Conversion Feature Checklist
Must-have features for this niche — verify before buying:
- [ ] Sticky Add-to-Cart button
- [ ] Product image zoom / 360 view
- [ ] Variant swatches (color / size)
- [ ] Bundle / frequently bought together
- [ ] Countdown timer support
- [ ] Trust badges section
- [ ] Reviews integration (Yotpo/Judge.me)
- [ ] Quick view / quick add
- [ ] Mega menu for collections
- [ ] Video support in hero / PDP
- [ ] Size guide popup
- [ ] Back-in-stock notifications
- [ ] Custom metafields display
→ Score your top pick: X/14 features native

## 5. First-Week Customization Priority
In order of conversion impact, customize:
1. [Change] → [Why it matters]
2. [Change] → [Why it matters]
3. [Change] → [Why it matters]
4. [Change] → [Why it matters]
5. [Change] → [Why it matters]
6. [Change] → [Why it matters]
7. [Change] → [Why it matters]

## 6. Recommended App Stack (to complete theme)
Apps that fill gaps in even the best themes:
| Need | App | Free/Paid | Priority |
|------|-----|-----------|----------|
| Reviews | | | |
| Upsell | | | |
| Email capture | | | |
| Size guide | | | |
| Loyalty | | | |
| Search | | | |

## 7. Page Speed Optimization
After theme install, do this before launch:
- Image compression workflow (tool + settings)
- App audit (remove unused apps — each adds 100-300ms)
- Lazy loading configuration
- Font optimization
- Third-party script management
→ Target: Core Web Vitals score >70 on mobile

## 8. Common Theme Mistakes to Avoid
Top 7 mistakes Shopify store owners make with themes — with fixes."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  SHOPIFY THEME RECOMMENDATION"
echo "  Store: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Theme Selector"
echo "  clawhub.ai/mguozhen/shopify-theme-selector"
echo "================================================"

---
name: shopify-cart-recovery
description: "Cart abandonment recovery system for Shopify stores. Build multi-channel recovery sequences using email, SMS, and retargeting ads to win back lost sales and boost conversion rate. Triggers: cart abandonment, cart recovery, abandoned cart, checkout recovery, lost sales, cart email, cart SMS"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-cart-recovery
---

# Shopify Cart Recovery

Build a high-converting multi-channel cart abandonment recovery system for your Shopify store.

## Usage

```
cart recovery: pet accessories store 3% conversion rate
abandoned cart: fashion brand email + SMS strategy
cart abandonment: improve recovery for $80 AOV store
checkout recovery: build full sequence for new Shopify store
```

## What You Get

1. **Recovery Rate Benchmark** — where you stand vs industry average
2. **Multi-Channel Sequence** — email + SMS + retargeting timing map
3. **Email Copy (5 variations)** — subject lines + full body copy
4. **SMS Templates** — 3 messages with compliant opt-out language
5. **Retargeting Ad Angles** — Facebook/Google ads for cart abandoners
6. **Incentive Strategy** — when and how much to discount
7. **Revenue Impact Calculator** — projected monthly recovery revenue

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-cart-recovery — Multi-channel cart abandonment recovery system
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: cart recovery: <store details>"
  echo "Example: cart recovery: fashion store \$75 AOV 2.5% conversion rate"
  exit 1
fi

SESSION_ID="cart-$(date +%s)"

PROMPT="You are a Shopify conversion rate expert specializing in cart abandonment recovery. Build a complete recovery system for: INPUT

## 1. Recovery Rate Benchmark
Industry benchmarks for this niche:
- Average cart abandonment rate: X%
- Average email recovery rate: X%
- Average SMS recovery rate: X%
- Average retargeting recovery rate: X%
- **Total addressable recovery revenue estimate**

## 2. Multi-Channel Recovery Sequence (Timeline)
Map the complete recovery journey:

| Time | Channel | Message Type | Goal |
|------|---------|-------------|------|
| 1 hour | Email | Reminder | Soft nudge |
| 3 hours | SMS | Reminder | Urgency |
| 24 hours | Email | Social proof | Build trust |
| 48 hours | Retargeting | Product focus | Stay top of mind |
| 72 hours | Email | Incentive | Last chance offer |
| 7 days | Email | Win-back | Reengagement |

## 3. Email Sequence (5 Emails)

**Email 1 — Reminder (1 hour after abandonment)**
Subject line options (5 variations):
1. [Option]
2. [Option]
3. [Option]
4. [Option]
5. [Option]

Full body copy (200 words):
[Write complete email for this niche]

**Email 2 — Social Proof (24 hours)**
Subject: [subject]
Body: [Full email — lead with reviews/testimonials, address objections]

**Email 3 — FAQ/Objection Handler (48 hours)**
Subject: [subject]
Body: [Full email — address top 3 reasons people don't buy in this niche]

**Email 4 — Urgency + Incentive (72 hours)**
Subject: [subject]
Body: [Full email — limited time offer, X% off or free shipping]

**Email 5 — Final Goodbye (7 days)**
Subject: [subject]
Body: [Full email — last chance, what they'll miss, close the loop]

## 4. SMS Sequence (3 Messages)
All messages under 160 characters with STOP opt-out:

**SMS 1 (3 hours):** [Message] Reply STOP to unsubscribe.
**SMS 2 (48 hours):** [Message] Reply STOP to unsubscribe.
**SMS 3 (72 hours):** [Message] Reply STOP to unsubscribe.

## 5. Retargeting Ad Strategy
Facebook/Instagram ads for cart abandoners:
- Audience window: 1-day / 3-day / 7-day segments
- Creative angle by window:
  - 1-day: [angle + copy]
  - 3-day: [angle + copy]
  - 7-day: [angle + copy]
- Budget allocation: $X/day per segment
- Frequency cap recommendation

## 6. Incentive Strategy
When and what to offer:
- No discount (Email 1-3): focus on [value prop]
- Discount trigger: only if [criteria]
- Discount type: % off vs free shipping vs gift (which converts better for this niche)
- Incentive amount: X% (margin-safe threshold)
- Urgency mechanism: countdown timer setup

## 7. Revenue Impact Calculator
Assuming this store's metrics:
- Monthly traffic: X visitors
- Add-to-cart rate: X%
- Cart abandonment rate: X%
- Monthly abandoned carts: X
- Recovery rate with this system: X%
- Average order value: $X
- **Monthly recovered revenue: $X**
- **Annual impact: $X**

## 8. Klaviyo / Shopify Setup Guide
Step-by-step to implement:
1. Trigger setup in Klaviyo
2. Shopify checkout abandonment tracking
3. SMS compliance setup (TCPA)
4. A/B test configuration
5. Analytics dashboard setup

## 9. Optimization Checklist (First 30 Days)
What to monitor and optimize after launch."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  CART RECOVERY SYSTEM"
echo "  Store: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Cart Recovery"
echo "  clawhub.ai/mguozhen/shopify-cart-recovery"
echo "================================================"

---
name: shopify-backlink-builder
description: "Link building strategy for Shopify stores. Build a prioritized backlink acquisition plan using guest posting, HARO, digital PR, and competitor link analysis to improve domain authority and organic rankings. Triggers: backlinks, link building, domain authority, DA, guest post, HARO, digital PR, off-page SEO, link acquisition"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-backlink-builder
---

# Shopify Backlink Builder

Build a systematic link acquisition strategy to grow your Shopify store's domain authority and organic traffic.

## Usage

```
backlinks: build strategy for pet accessories store
link building: sustainable fashion brand DA 20
guest post: find opportunities for home fitness niche
digital PR: link acquisition plan for new Shopify store
```

## What You Get

1. **Link Opportunity Audit** — categorized by difficulty and impact
2. **Competitor Backlink Gap** — links your competitors have that you don't
3. **Guest Post Target List** — 20 sites to pitch in your niche
4. **HARO/Digital PR Playbook** — how to get media mentions
5. **Outreach Templates** — proven email templates for link requests
6. **Link Velocity Plan** — how many links per month to build naturally
7. **Internal Link Structure** — maximize value of existing links

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-backlink-builder — Link acquisition strategy for Shopify stores
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: backlinks: <store niche and current DA>"
  echo "Example: backlinks: build strategy for pet accessories store DA 15"
  exit 1
fi

SESSION_ID="backlink-$(date +%s)"

PROMPT="You are an SEO link building expert specializing in Shopify e-commerce stores. Build a complete backlink acquisition strategy for: INPUT

## 1. Link Opportunity Matrix
Categorize and prioritize link types:
| Link Type | Difficulty | Impact | Volume/Month | Priority |
|-----------|-----------|--------|--------------|----------|
| Guest Posts | | | | |
| HARO Responses | | | | |
| Broken Link Building | | | | |
| Resource Page Links | | | | |
| Competitor Steal | | | | |
| Digital PR / Data | | | | |
| Podcast Appearances | | | | |
| Forum/Community | | | | |
| Directory Listings | | | | |
| Supplier/Partner Links | | | | |

## 2. Competitor Backlink Gap Analysis
For the top 3 competitors in this niche, identify:
- Types of sites linking to them
- Content assets attracting the most links
- Link patterns unique to each competitor
- Top 10 link opportunities you can replicate immediately

## 3. Guest Post Target List
20 specific websites to target in this niche:
| Site | Domain Authority | Niche Relevance | Contact Method | Topic Ideas |
|------|-----------------|----------------|----------------|-------------|
[List 20 real, relevant publication types with specific topic angles]

## 4. Digital PR Playbook
Data-driven content that earns links automatically:
- 5 research report ideas for this niche (journalists will cite these)
- How to create and distribute the data
- Target publications to pitch to
- Press release template for link-worthy content
- HARO category to monitor (specific subreddits/topics)

## 5. HARO Response Strategy
- Best HARO categories for this niche
- Response template that gets accepted (150 words)
- Positioning as an expert in this niche
- Response timing (within 1 hour rule)
- Track record: expect X% acceptance rate

## 6. Outreach Email Templates
**Guest Post Pitch:**
Subject: [Subject line]
[200-word email template]

**Resource Page Link Request:**
Subject: [Subject line]
[150-word email template]

**Broken Link Replacement:**
Subject: [Subject line]
[150-word email template]

**Podcast Guest Pitch:**
Subject: [Subject line]
[150-word email template]

## 7. Link Velocity Plan (12 Months)
Natural link building pace to avoid penalties:
- Month 1-3: X links/month (foundation)
- Month 4-6: X links/month (acceleration)
- Month 7-12: X links/month (scale)
- Link type mix per month
- DA targets by month

## 8. Internal Link Optimization
Maximize existing link equity:
- Hub pages to create (link magnets)
- Internal link structure for Shopify (collections → products)
- Anchor text distribution guidelines
- PageRank sculpting strategy

## 9. 90-Day Quick Win Plan
First 90 days to build 30 quality links:
- Week 1-2: [specific actions]
- Week 3-4: [specific actions]
- Month 2: [specific actions]
- Month 3: [specific actions]

## 10. Link Quality Checklist
Before accepting any link, verify:
- DA/DR threshold
- Traffic verification
- Spam score limits
- Niche relevance score
- Follow vs nofollow strategy"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  BACKLINK BUILDING STRATEGY"
echo "  Target: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Backlink Builder"
echo "  clawhub.ai/mguozhen/shopify-backlink-builder"
echo "================================================"

---
name: shopify-social-content-planner
description: "30-day social media content calendar for Shopify stores. Plan Instagram, TikTok, Pinterest, and Facebook content with captions, hashtags, and posting schedules optimized for e-commerce conversion. Triggers: social media calendar, content calendar, social content, Instagram posts, TikTok content, Pinterest, social media plan, content schedule"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-social-content-planner
---

# Shopify Social Content Planner

Generate a 30-day social media content calendar with ready-to-use post ideas, captions, and hashtags for your Shopify store.

## Usage

```
social content: 30-day plan for pet accessories store
content calendar: sustainable fashion Instagram + TikTok
social media: home fitness equipment brand
content plan: new Shopify store beauty products
```

## What You Get

1. **30-Day Content Calendar** — daily post plan across platforms
2. **Content Mix Formula** — 80/20 value vs promotional ratio
3. **Caption Templates** — 10 fill-in-the-blank templates per platform
4. **Hashtag Strategy** — tiered hashtag sets by platform and post type
5. **Content Batching Guide** — how to shoot 30 days of content in 3 hours
6. **Best Posting Times** — platform-specific timing for your niche
7. **Engagement Hooks** — CTAs that drive comments, saves, and shares

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-social-content-planner — 30-day social content calendar generator
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: social content: <store niche and platforms>"
  echo "Example: social content: 30-day plan for pet accessories Instagram TikTok"
  exit 1
fi

SESSION_ID="social-$(date +%s)"

PROMPT="You are a social media strategist specializing in Shopify e-commerce brands. Create a complete 30-day social content plan for: INPUT

## 1. Platform Strategy
For this niche, rank and configure each platform:
| Platform | Priority | Post Frequency | Content Type | Primary Goal |
|----------|----------|---------------|--------------|--------------|
| Instagram Feed | | | | |
| Instagram Reels | | | | |
| Instagram Stories | | | | |
| TikTok | | | | |
| Pinterest | | | | |
| Facebook | | | | |

## 2. Content Mix Formula
Define the 80/20 content strategy:
- Educational/Value: X%
- Entertaining/Relatable: X%
- User Generated Content: X%
- Product Showcase: X%
- Promotional/Sale: X%
- Behind the Scenes: X%
- Community/Engagement: X%

## 3. 30-Day Content Calendar
For each day, provide:
| Day | Platform | Content Type | Hook/Angle | Caption (50 words) | Hashtags | CTA |
[Create all 30 days — keep it specific to the niche, not generic]

Day 1: [fill]
Day 2: [fill]
Day 3: [fill]
... [continue for all 30 days]

## 4. Caption Templates (10 per platform)
**Instagram Templates:**
1. [Template with blanks to fill in]
...10 templates

**TikTok Hook Templates:**
1. [Hook that stops the scroll]
...10 hooks

**Pinterest Description Templates:**
1. [SEO-optimized description template]
...5 templates

## 5. Hashtag Strategy
**Instagram:**
- Niche hashtags (under 100K posts): [10 specific hashtags]
- Mid-size (100K-1M posts): [10 specific hashtags]
- Large (1M+ posts): [5 hashtags]
- Branded hashtag: [recommendation]

**TikTok:**
- Trending hashtags for this niche: [10 specific]
- Evergreen hashtags: [5 specific]

**Pinterest:**
- Board names: [5 board name suggestions]
- Pin keywords: [15 keywords to include]

## 6. Content Batching Guide
3-hour content shoot plan:
- Equipment setup (30 min)
- Shots to capture (list all scenes/angles)
- B-roll list
- UGC collection method
- Editing batch workflow
- Scheduling tools recommendation

## 7. Best Posting Times
For this niche's target audience:
- Instagram: [specific times and days]
- TikTok: [specific times and days]
- Pinterest: [specific times and days]
- Facebook: [specific times and days]

## 8. Engagement Automation
10 engagement tactics that take <5 min/day:
- Comment response templates
- Story interaction ideas
- Collab/duet strategy (TikTok)
- Community building tactics"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  30-DAY SOCIAL CONTENT CALENDAR"
echo "  Brand: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Social Content Planner"
echo "  clawhub.ai/mguozhen/shopify-social-content-planner"
echo "================================================"

---
name: shopify-dropshipping-finder
description: "Dropshipping product research and supplier evaluation for Shopify stores. Analyze product viability, find reliable suppliers, estimate margins, and build a winning dropshipping product portfolio. Triggers: dropshipping, dropship, supplier, Spocket, AliExpress, product sourcing, print on demand, POD, product research dropshipping"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-dropshipping-finder
---

# Shopify Dropshipping Finder

Evaluate dropshipping product opportunities and build a supplier + product strategy for your Shopify store.

## Usage

```
dropshipping: evaluate phone accessories niche
supplier: find reliable source for yoga mats
dropship: analyze margin potential for home decor
product sourcing: pet accessories under $15 COGS
```

## What You Get

1. **Product Viability Score** — market demand, competition, margin potential
2. **Supplier Evaluation Matrix** — reliability, quality, shipping speed scores
3. **Margin Calculator** — COGS, shipping, ad spend, Shopify fees → net profit
4. **Winning Product Criteria** — what makes a product dropship-worthy
5. **Top Supplier Platforms** — ranked comparison for this niche
6. **Differentiation Strategy** — how to stand out in saturated niches
7. **Scale-Up Roadmap** — from dropshipping to private label

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-dropshipping-finder — Product research and supplier evaluation
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: dropshipping: <product or niche>"
  echo "Example: dropshipping: evaluate phone accessories niche"
  exit 1
fi

SESSION_ID="dropship-$(date +%s)"

PROMPT="You are a Shopify dropshipping expert with deep knowledge of product research, supplier evaluation, and profitability analysis. Analyze this dropshipping opportunity: INPUT

## 1. Product Viability Score (out of 100)
Score this opportunity:
- Market demand score (Google Trends, search volume): /20
- Competition level (inverse): /20
- Profit margin potential: /20
- Shipping feasibility: /20
- Brand-building potential: /20
- **Total Viability Score: /100**
→ Verdict: Strong / Moderate / Weak opportunity

## 2. Product Selection Criteria
For this niche, the ideal dropshipping product must:
- Price range: $X - $Y retail
- COGS range: $X - $Y
- Weight/dimensions: [specs to hit under $5 ePacket]
- Impulse buy score: /10
- Problem-solving score: /10
- Top 10 specific winning product ideas in this niche

## 3. Supplier Platform Comparison
| Platform | Best For | Avg Shipping (US) | Quality Control | Min Order | Price Range |
|----------|----------|-------------------|-----------------|-----------|-------------|
| AliExpress | | | | | |
| Spocket | | | | | |
| CJDropshipping | | | | | |
| Zendrop | | | | | |
| Oberlo (via DSers) | | | | | |
| Alibaba (MOQ) | | | | | |
| SaleHoo | | | | | |

**Recommended for this niche:** [Platform + reason]

## 4. Supplier Evaluation Checklist
When vetting a supplier, check:
- Response time (<24h target)
- Sample order evaluation criteria
- Return/refund policy terms
- Shipping time guarantees
- Product quality indicators
- Red flags to watch for

## 5. Margin Calculator
For a typical product in this niche (example: $39.99 retail):
- Retail price: $39.99
- COGS (product): -$X.XX
- Shipping to customer: -$X.XX
- Shopify fees (2%): -$X.XX
- Payment processing (2.9%+$0.30): -$X.XX
- Facebook/Meta CPA estimate: -$X.XX
- **Net profit per order: $X.XX (X%)**
- Break-even ROAS: X.Xx

## 6. Differentiation Strategy
How to win in this niche without competing on price:
- Bundling strategy (what to bundle)
- Custom packaging opportunity
- Brand story angle
- Upsell/cross-sell stack
- Unique value proposition that suppliers can't copy

## 7. Shipping & Fulfillment Plan
- Best shipping options for US/EU/AU customers
- Handling time expectations to set
- Customer communication templates for delays
- Returns handling workflow

## 8. Risk Management
Top risks in this niche and mitigation:
- Supplier reliability risk → mitigation
- Shipping delay risk → mitigation
- Product quality risk → mitigation
- Ad account ban risk → mitigation
- Saturation risk → mitigation

## 9. Scale-Up Roadmap
Phase 1 (Month 1-3): Pure dropshipping, test and validate
Phase 2 (Month 4-6): Negotiate with top 2 suppliers, custom packaging
Phase 3 (Month 7-12): Move to private label / inventory for winning SKUs
Phase 4 (12M+): Brand building, own supply chain

## 10. First 30 Days Action Plan
Week-by-week steps to launch this dropshipping store."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  DROPSHIPPING PRODUCT RESEARCH REPORT"
echo "  Target: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Dropshipping Finder"
echo "  clawhub.ai/mguozhen/shopify-dropshipping-finder"
echo "================================================"

---
name: shopify-email-segmentation
description: "Email list segmentation strategy for Shopify stores. Build customer segments, design automated flows, and create personalized campaigns using Klaviyo, MailChimp, or any ESP. Triggers: email segmentation, email marketing, Klaviyo, email list, customer segments, email flows, email automation, newsletter"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-email-segmentation
---

# Shopify Email Segmentation

Build a high-converting email marketing system with smart segmentation for your Shopify store.

## Usage

```
email segmentation: pet accessories store 5,000 subscribers
Klaviyo: set up segments for fashion brand
email marketing: build flows for new Shopify store
email automation: $200K/year store improve retention
```

## What You Get

1. **Segment Architecture** — 10 core segments every Shopify store needs
2. **RFM Analysis Framework** — Recency, Frequency, Monetary scoring model
3. **Automated Flow Map** — 8 essential Klaviyo/MailChimp flows
4. **Campaign Calendar** — 12-month email calendar by segment
5. **Subject Line Playbook** — formulas by segment type
6. **Revenue Attribution** — expected % of revenue from email
7. **A/B Testing Roadmap** — what to test first and how

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-email-segmentation — Email marketing segmentation strategy
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: email segmentation: <store details>"
  echo "Example: email segmentation: pet store 5000 subscribers Klaviyo"
  exit 1
fi

SESSION_ID="email-seg-$(date +%s)"

PROMPT="You are a Shopify email marketing expert specializing in Klaviyo segmentation and lifecycle automation. Build a complete email marketing strategy for: INPUT

## 1. Core Segment Architecture
Define 10 essential segments with entry/exit criteria:

| Segment | Definition | Size Estimate | Goal |
|---------|-----------|---------------|------|
| Champions | | | |
| Loyal Customers | | | |
| At Risk | | | |
| Lost Customers | | | |
| Promising | | | |
| New Subscribers | | | |
| Browse Abandoners | | | |
| Cart Abandoners | | | |
| One-Time Buyers | | | |
| VIP (High LTV) | | | |

## 2. RFM Scoring Framework
Build RFM model (1-5 scale each):
- Recency breakpoints (days since last purchase)
- Frequency breakpoints (number of orders)
- Monetary breakpoints (total spend in $)
- Combined RFM action matrix

## 3. Automated Flow Map
Design 8 essential flows:

**Flow 1: Welcome Series (5 emails)**
- Email 1 (Day 0): subject, goal, content outline
- Email 2 (Day 2): subject, goal, content outline
- Email 3 (Day 5): subject, goal, content outline
- Email 4 (Day 8): subject, goal, content outline
- Email 5 (Day 14): subject, goal, content outline

**Flow 2: Abandoned Cart (3 emails)**
- Email 1 (1 hour): urgency + product reminder
- Email 2 (24 hours): social proof + FAQ
- Email 3 (72 hours): discount offer

**Flow 3: Browse Abandonment (2 emails)**
**Flow 4: Post-Purchase (4 emails)**
**Flow 5: Winback / Re-engagement (3 emails)**
**Flow 6: VIP / Loyalty (ongoing)**
**Flow 7: Sunset (unengaged cleanup)**
**Flow 8: Birthday / Anniversary**

## 4. Campaign Calendar (12 Months)
Monthly send plan by segment:
| Month | Campaign | Segment | Goal |
|-------|----------|---------|------|
[Fill all 12 months with specific campaign ideas for this niche]

## 5. Subject Line Playbook
10 proven subject line formulas for each segment type:
- Welcome: [5 examples]
- Cart abandon: [5 examples]
- Win-back: [5 examples]
- VIP: [5 examples]
- Promotional: [5 examples]

## 6. Revenue Attribution Targets
Benchmarks for this niche:
- % of total revenue from email (target)
- Revenue per subscriber per month target
- Flow vs campaign revenue split
- Open rate / CTR / CVR benchmarks by flow

## 7. A/B Testing Roadmap (90 Days)
Priority testing queue:
- Week 1-2: Test [variable] in [flow]
- Week 3-4: Test [variable] in [campaign]
- Week 5-8: Test [variable]
- Week 9-12: Test [variable]

## 8. Klaviyo Setup Checklist
Step-by-step to implement this strategy:
- List hygiene steps
- Segment creation order
- Flow activation sequence
- Integration with Shopify data"

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  EMAIL SEGMENTATION STRATEGY"
echo "  Store: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Email Segmentation"
echo "  clawhub.ai/mguozhen/shopify-email-segmentation"
echo "================================================"

---
name: shopify-traffic-analyzer
description: "Website traffic analysis and growth strategy for Shopify stores. Estimate traffic sources, benchmark against competitors, identify growth channels, and build a 90-day traffic plan. Triggers: traffic analysis, website traffic, traffic sources, SimilarWeb, traffic growth, store visitors, organic traffic"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-traffic-analyzer
---

# Shopify Traffic Analyzer

Analyze traffic patterns, benchmark competitors, and build a data-driven traffic growth plan for your Shopify store.

## Usage

```
traffic analysis: mystore.com
traffic growth: pet accessories Shopify store
website traffic: compare with competitor.com
traffic sources: sustainable fashion brand new store
```

## What You Get

1. **Traffic Source Breakdown** — organic, paid, social, direct, referral benchmarks
2. **Competitor Traffic Profile** — estimated visits, top pages, traffic sources
3. **Channel Performance Matrix** — ROI by acquisition channel for your niche
4. **Traffic Gap Analysis** — untapped channels vs competitors
5. **90-Day Traffic Growth Plan** — week-by-week action items
6. **Content Velocity Plan** — how many pieces/week needed to hit traffic goals
7. **Quick Win Opportunities** — 5 actions that can double traffic in 30 days

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-traffic-analyzer — Traffic analysis and growth strategy for Shopify stores
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: traffic analysis: <store URL or niche>"
  echo "Example: traffic analysis: pet accessories Shopify store"
  exit 1
fi

SESSION_ID="traffic-$(date +%s)"

PROMPT="You are a Shopify growth expert specializing in traffic analysis and acquisition strategy. Analyze traffic and build a growth plan for: INPUT

## 1. Traffic Source Benchmark
Industry benchmark for this niche (% of total traffic):
| Channel | Industry Avg | Your Target | Notes |
|---------|-------------|-------------|-------|
| Organic Search | | | |
| Paid Search | | | |
| Social (Organic) | | | |
| Paid Social | | | |
| Direct | | | |
| Email | | | |
| Referral | | | |
| Affiliates | | | |

## 2. Competitor Traffic Profile
Estimate for top 3 competitors in this niche:
- Monthly visit range
- Top traffic sources
- Estimated top 5 landing pages
- Seasonal traffic patterns
- Key traffic differentiators

## 3. Channel ROI Matrix
For this niche, rank channels by ROI potential:
| Channel | Startup Cost | Time to Results | CAC Estimate | Scalability |
|---------|-------------|-----------------|--------------|-------------|
| SEO/Blog | | | | |
| Google Ads | | | | |
| Facebook/Meta Ads | | | | |
| TikTok Ads | | | | |
| Pinterest | | | | |
| Email Marketing | | | | |
| Influencer | | | | |
| Affiliate | | | | |
| PR/Press | | | | |

## 4. Traffic Gap Analysis
Channels competitors are winning that you're likely missing:
- Gap 1: [channel] — how to close it
- Gap 2: [channel] — how to close it
- Gap 3: [channel] — how to close it

## 5. 90-Day Traffic Growth Plan
**Month 1 — Foundation (Weeks 1-4):**
- Week 1: [3 specific actions]
- Week 2: [3 specific actions]
- Week 3: [3 specific actions]
- Week 4: [3 specific actions]
- Traffic target: [+X% or +X visitors]

**Month 2 — Acceleration (Weeks 5-8):**
- Key focus: [channel]
- Weekly actions
- Traffic target

**Month 3 — Scale (Weeks 9-12):**
- Key focus: [channel]
- Weekly actions
- Traffic target

## 6. Content Velocity Plan
To hit organic traffic goals:
- Blog posts per week needed
- Target word count per post
- Internal linking structure
- Content types: how-to / comparison / roundup / news split
- Top 10 content topics to start with

## 7. Technical Traffic Foundations
Critical Shopify technical issues that hurt traffic:
- Page speed benchmarks (target Core Web Vitals scores)
- Mobile optimization checklist
- Structured data / schema markup gaps
- Crawlability and indexation issues to fix first

## 8. Quick Wins — 5 Actions for 2x Traffic in 30 Days
Specific, immediately actionable tactics for rapid traffic growth."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  TRAFFIC ANALYSIS REPORT"
echo "  Target: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Traffic Analyzer"
echo "  clawhub.ai/mguozhen/shopify-traffic-analyzer"
echo "================================================"

---
name: shopify-payment-optimizer
description: "Cross-border payment solution comparison for Shopify stores. Compare fees, settlement speed, currency support, and risk profile across Airwallex, WorldFirst, Pingpong, PayPal, Stripe, and more. Triggers: payment, cross-border payment, settlement, Airwallex, WorldFirst, Pingpong, PayPal, Stripe, currency, collection"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-payment-optimizer
---

# Shopify Payment Optimizer

Find the best cross-border payment stack for your Shopify store's volume, markets, and currency needs.

## Usage

```
payment: compare options for $50K/month US sales
settlement: best option for EU sales paying to China
payment optimizer: dropshipping store 10 countries
cross-border payment: new store under $5K/month
```

## What You Get

1. **Fee Comparison Table** — transaction fees, FX spread, withdrawal fees
2. **Settlement Speed Analysis** — T+0 to T+7 breakdown by provider
3. **Currency Coverage Map** — which provider covers your target markets
4. **Risk & Compliance Assessment** — account freeze risk, reserve policies
5. **Recommended Stack** — primary + backup payment combination
6. **Setup Checklist** — documents needed, approval timeline
7. **Cost Savings Calculator** — estimated annual savings vs PayPal-only

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-payment-optimizer — Cross-border payment stack comparison
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: payment optimizer: <store details>"
  echo "Example: payment: compare options for \$50K/month US sales"
  exit 1
fi

SESSION_ID="payment-$(date +%s)"

PROMPT="You are a cross-border payment expert for Shopify stores selling globally. Analyze and optimize the payment stack for: INPUT

## 1. Payment Provider Comparison Table
Compare these providers across key metrics:
| Provider | Transaction Fee | FX Spread | Settlement Speed | Min Withdrawal | Best For |
|----------|----------------|-----------|-----------------|----------------|----------|
| Airwallex | | | | | |
| WorldFirst | | | | | |
| Pingpong | | | | | |
| Lianlian Pay | | | | | |
| Payoneer | | | | | |
| PayPal | | | | | |
| Stripe | | | | | |
| Shopify Payments | | | | | |

## 2. Fee Deep Dive
For this specific use case, calculate real cost per \$10,000 in sales:
- Transaction fee cost
- FX conversion cost (assuming CNY settlement)
- Withdrawal fee
- **Total effective fee rate**
- Annual cost at projected volume

## 3. Settlement Speed & Cash Flow Impact
Rank providers by settlement speed for this scenario:
- Same-day / T+0 options
- T+1 to T+3 options
- T+7+ (avoid for cash flow)
→ Cash flow impact analysis

## 4. Currency & Market Coverage
Which providers support the target markets:
- List of supported currencies
- Markets with restrictions or higher risk
- Chargeback protection by region

## 5. Risk Assessment
| Provider | Account Freeze Risk | Reserve Policy | Dispute Resolution |
|----------|--------------------|-----------------|--------------------|

## 6. Recommended Payment Stack
**Primary:** [Provider] — why
**Backup:** [Provider] — why
**For PayPal customers:** [Provider] — why
**For high-ticket:** [Provider] — why

## 7. Implementation Checklist
Documents needed for each recommended provider:
- Business registration requirements
- KYC documents
- Shopify integration method (native / API / plugin)
- Typical approval timeline

## 8. Cost Savings vs PayPal-Only
Projected annual savings switching to recommended stack:
- Current PayPal cost estimate
- Optimized stack cost
- Annual savings
- Payback period on setup effort

## 9. Red Flags to Avoid
Common mistakes when setting up cross-border payments for Shopify stores."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  PAYMENT OPTIMIZATION REPORT"
echo "  Scenario: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Payment Optimizer"
echo "  clawhub.ai/mguozhen/shopify-payment-optimizer"
echo "================================================"

---
name: shopify-influencer-evaluator
description: "KOL and influencer evaluation for Shopify brands. Score influencer fit, estimate ROI, generate outreach templates, and build a tiered influencer marketing strategy. Triggers: influencer, KOL, blogger outreach, ugc creator, influencer marketing, brand ambassador, micro influencer"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-influencer-evaluator
---

# Shopify Influencer Evaluator

Evaluate KOL/influencer fit and build a full influencer marketing playbook for your Shopify store.

## Usage

```
influencer: evaluate @username for my yoga mat store
KOL strategy: sustainable fashion brand
ugc creator: pet accessories niche
influencer marketing: home fitness equipment $500 budget
```

## What You Get

1. **Influencer Scoring Matrix** — fit score across 6 dimensions
2. **Tiered Influencer Strategy** — mega / macro / micro / nano mix
3. **ROI Estimation** — expected reach, clicks, conversions, ROAS
4. **Outreach Templates** — DM and email scripts that get replies
5. **Campaign Structure** — gifting vs paid vs affiliate
6. **Content Brief** — what to ask them to create
7. **Tracking Setup** — UTM structure, discount codes, attribution

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-influencer-evaluator — KOL/influencer strategy for Shopify brands
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: influencer: <niche or @handle or campaign goal>"
  echo "Example: influencer: yoga mat store micro influencer strategy"
  exit 1
fi

SESSION_ID="influencer-$(date +%s)"

PROMPT="You are an influencer marketing expert for Shopify DTC brands. Build a full influencer marketing strategy for: INPUT

## 1. Influencer Tier Strategy
Recommend the optimal mix for this niche:
| Tier | Followers | Count | Budget % | Expected ROAS |
|------|-----------|-------|----------|---------------|
| Mega (1M+) | ... | ... | ... | ... |
| Macro (100K-1M) | ... | ... | ... | ... |
| Micro (10K-100K) | ... | ... | ... | ... |
| Nano (1K-10K) | ... | ... | ... | ... |

## 2. Influencer Scoring Matrix
Score each candidate across (1-10):
- Audience relevance to niche
- Engagement rate quality (comments vs likes ratio)
- Content authenticity score
- Past brand collaboration track record
- Audience demographics fit
- Price-to-value ratio
→ Total score /60 = hire threshold: 42+

## 3. Platform Selection
Rank platforms for this niche (Instagram / TikTok / YouTube / Pinterest / Blog):
- Primary platform: [why]
- Secondary platform: [why]
- Skip: [why]

## 4. Campaign Structure Options
**Option A — Gifting Program**
- Who to target, what to send, expected conversion
**Option B — Paid Collaboration**
- Rate benchmarks, deliverables, exclusivity terms
**Option C — Affiliate/Commission**
- Commission rate, cookie window, tracking setup

## 5. Outreach Templates
**DM Script (Instagram/TikTok):**
[150-word personalized DM template]

**Email Script:**
Subject: [subject line]
[300-word email template]

## 6. Content Brief Template
What to brief the influencer:
- Key messages (3 points)
- Mandatory mentions
- Hashtags and @tags
- Do's and Don'ts
- Deliverable specs (format, length, posting time)

## 7. ROI Projection
Assuming \$1,000 budget:
- Expected total reach
- Estimated CTR and clicks
- Conversion rate assumption
- Projected revenue and ROAS
- Break-even analysis

## 8. Tracking & Attribution Setup
- Discount code naming convention
- UTM parameter structure
- Tracking spreadsheet columns
- 30-day performance review checklist

## 9. Top 10 Platforms to Find Influencers
List the best tools/platforms to discover influencers in this niche, with pros/cons."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report."
  exit 1
fi

echo ""
echo "================================================"
echo "  INFLUENCER MARKETING STRATEGY"
echo "  Target: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Influencer Evaluator"
echo "  clawhub.ai/mguozhen/shopify-influencer-evaluator"
echo "================================================"

---
name: shopify-facebook-ad-spy
description: "Facebook & Meta ad intelligence for Shopify stores. Analyze competitor ad creatives, copy angles, targeting strategy, and funnel structure to reverse-engineer winning ad campaigns. Triggers: ad spy, facebook ads, meta ads, competitor ads, ad creative, ad copy analysis, shopify ads"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/shopify-facebook-ad-spy
---

# Shopify Facebook Ad Spy

Reverse-engineer competitor Facebook/Meta ad campaigns for your Shopify niche.

## Usage

```
ad spy: pet accessories store
facebook ads: home fitness equipment
competitor ads: sustainable clothing brand
ad creative analysis: kitchen gadgets
```

## What You Get

1. **Ad Creative Framework** — headline formulas, hook styles, visual patterns that work in your niche
2. **Copy Angle Matrix** — pain point, social proof, urgency, transformation angles
3. **Targeting Strategy** — audience segments, interest stacking, lookalike recommendations
4. **Funnel Structure** — TOF/MOF/BOF ad types and sequencing
5. **Budget Allocation** — testing budget vs scaling budget split
6. **Creative Testing Plan** — 5 ad variants to test first
7. **Winning Ad Swipe File** — templates for your first 3 campaigns

FILE:analyze.sh
#!/usr/bin/env bash
# shopify-facebook-ad-spy — Competitor Facebook/Meta ad intelligence
set -euo pipefail

INPUT="-"
if [ -z "$INPUT" ]; then
  echo "Usage: ad spy: <niche or store URL>"
  echo "Example: ad spy: pet accessories store"
  exit 1
fi

SESSION_ID="fb-adspy-$(date +%s)"

PROMPT="You are a Facebook & Meta advertising expert specializing in Shopify DTC brands. Analyze competitor ad strategy for: INPUT

Produce a complete ad intelligence report with these sections:

## 1. Niche Ad Landscape
- Top 3 ad angles dominant in this niche
- Average ad frequency and saturation level
- Seasonal patterns and peak ad periods

## 2. Winning Creative Frameworks
- Top 5 headline formulas with examples
- Hook styles that get highest CTR (pattern interrupt, question, bold claim)
- Visual patterns: UGC vs polished, lifestyle vs product, video vs static
- Color psychology and branding cues

## 3. Copy Angle Matrix
For each angle, write a sample ad copy (50-80 words):
- Pain Point angle
- Social Proof angle
- Transformation/Before-After angle
- Urgency/Scarcity angle
- Curiosity/Intrigue angle

## 4. Audience Targeting Strategy
- Core interest targeting (top 10 interests)
- Interest stacking combinations
- Lookalike seed audiences (best customer sources)
- Exclusion audiences to reduce wasted spend
- Age/gender/geo breakdown recommendation

## 5. Funnel Ad Sequencing
- TOF (cold): format, objective, budget %
- MOF (warm): retargeting windows, message shift
- BOF (hot): conversion triggers, offer types
- Cross-sell/upsell sequences post-purchase

## 6. Budget & Testing Plan
- Day 1-7 testing budget (per ad set)
- Creative testing matrix (variables to isolate)
- Kill/scale decision thresholds (CTR, CPC, ROAS)
- Scaling playbook: horizontal vs vertical

## 7. Swipe File — 3 Ready-to-Use Ad Templates
For each template: Headline | Primary Text | CTA | Visual Direction

## 8. Quick Win Action Plan
Top 3 things to do in the next 48 hours to launch competitive ads."

RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [ -z "$REPORT" ]; then
  echo "Error: Could not generate report. Make sure openclaw is configured."
  exit 1
fi

echo ""
echo "================================================"
echo "  FACEBOOK AD SPY REPORT"
echo "  Target: INPUT"
echo "================================================"
echo ""
echo "$REPORT"
echo ""
echo "================================================"
echo "  Powered by Shopify Facebook Ad Spy Skill"
echo "  clawhub.ai/mguozhen/shopify-facebook-ad-spy"
echo "================================================"

---
name: seo-playbook-optimizer
description: "SEO + GEO content optimizer based on proven internal SOP playbook. Input a URL or keyword + page content, outputs a full SEO audit: keyword matrix, Title Tag/H1 optimization (3 options), article structure (5Ws+1H), internal linking audit, backlink plan by site stage, and GEO (Generative Engine Optimization) strategy using Claude-powered news content flywheel. Triggers: seo audit, seo optimize, keyword analysis, on-page seo, internal link audit, backlink strategy, title tag optimization, article structure, content gap analysis, anchor text, guest post strategy, pillow links, geo strategy, ai seo, generative engine optimization, news content flywheel, topical authority, claude news articles"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/seo-optimizer
---

# SEO + GEO Playbook Optimizer

Full-stack SEO & GEO audit powered by a battle-tested internal SOP playbook. Covers keyword strategy, on-page optimization, internal linking, link building — plus the **Claude News Flywheel** strategy for building topical authority recognized by both Google and AI search engines.

## Usage

```
seo audit: [keyword or URL]
seo optimize: [keyword] for [site URL]
analyze seo for: [paste page content here]
geo strategy: [niche or site URL]
news flywheel: [topic or site]
```

## Inputs

- **Keyword or URL** (required)
- **Page content / article draft** (optional — paste full text for deeper analysis)
- **Competitor URLs** (optional)
- **Site stage**: `new` (<3mo) | `growing` (3-12mo) | `mature` (>12mo)

## Output

1. **Keyword Matrix** — primary keyword + semantic variants + search intent
2. **Title Tag & H1 Optimization** — 3 alternatives (parallel / CTA / progressive logic)
3. **Article Structure** — H2/H3 framework using 5Ws+1H, content gap analysis
4. **Internal Link Audit** — anchor text rules, link hierarchy, orphan page detection
5. **Backlink Plan** — tiered by site stage (new / growing / mature)
6. **GEO Strategy** — Claude News Flywheel plan for AI engine authority
7. **Execution Priority** — Quick Wins this week vs. 1-month vs. 3-month roadmap
8. **SEO Health Score** — scored across 6 dimensions out of 100

## Core SOP Rules Built-in

- Rankings on page 1 → driven by backlinks; rankings in top 3 → driven by content
- New sites (<3mo): max 1-2 guest posts per important page; always start with pillow links
- Anchor text: same anchor must point to only ONE destination page
- Internal links: 2-5 per page; pillar → child; child → parent + siblings
- Keyword density: natural integration, never keyword-stuffed

## SEO + GEO: Claude News Flywheel

Use Claude to continuously generate news articles → publish to a `/news` section → accumulate topical authority → get recognized as authoritative by **both Google and AI engines** (ChatGPT, Perplexity, Gemini, Claude).

**Why it works:**
- Google rewards sites that consistently publish fresh, niche-relevant content
- AI search engines (GEO) crawl and cite authoritative domain sources as references
- A news section compounds — 200 news articles beat 10 pillar pages for broad keyword coverage
- Dual benefit: traditional SEO ranking + AI citation probability

**Flywheel Steps:**
1. Pick a niche topic cluster (e.g. "Amazon FBA news", "AI tools updates")
2. Use Claude to research + rewrite into original news articles daily/weekly
3. Publish to `/news` or `/blog` with proper on-page SEO
4. Add internal links from news articles → money pages
5. Over 3-6 months, Google recognizes topical authority → rankings rise
6. AI engines start citing your site as a source → GEO traffic begins

FILE:analyze.sh
#!/bin/bash
# SEO Playbook Optimizer — Main entry point
# Usage: ./analyze.sh --keyword "keyword" --content "..." [--url "url"] [--stage new|growing|mature] [--output file.md]

set -euo pipefail

KEYWORD=""
CONTENT=""
URL=""
STAGE="new"
OUTPUT_FILE=""

# Parse args
while [[ $# -gt 0 ]]; do
  case "$1" in
    --keyword) KEYWORD="$2"; shift 2 ;;
    --content) CONTENT="$2"; shift 2 ;;
    --url)     URL="$2";     shift 2 ;;
    --stage)   STAGE="$2";   shift 2 ;;
    --output)  OUTPUT_FILE="$2"; shift 2 ;;
    *) echo "Unknown arg: $1"; exit 1 ;;
  esac
done

if [[ -z "$KEYWORD" && -z "$URL" ]]; then
  echo "Usage: $0 --keyword <keyword> [--content <page_content>] [--url <url>] [--stage new|growing|mature]"
  exit 1
fi

TIMESTAMP=$(date +"%Y-%m-%d %H:%M")

# Build prompt for AI analysis
PROMPT="You are a professional SEO analyst following a proven internal SOP playbook. Produce a comprehensive, actionable SEO report in English.

## Target
Keyword: -'(from URL)'
URL: -(not provided)
Site Stage: STAGE (new=<3mo, growing=3-12mo, mature=>12mo)

## Page Content to Analyze:
-(not provided — analyze keyword only)

---

## Internal SOP Rules (apply strictly):

### Core Principle
- Page 1 rankings are won by backlinks. Top 3 rankings are won by content quality.

### Keyword Strategy
- Identify: primary keyword + semantic variants with the same search intent
- Apply Ahrefs-style metrics: Volume, Keyword Difficulty (KD), Traffic Potential, Parent Topic
- Expand angles using: Who, What, When, Where, Why, How

### Title Tag & H1 Rules
- Title Tag: include high-volume keyword + eye-catching modifier, keep under 60 characters
- H1: concise, complete keyword, not forced for SEO
- Three logical patterns: Parallel (&//) | Call to Action | Progressive (elaboration)
- Provide 3 Title Tag alternatives + 1 H1 recommendation

### Article Structure SOP
- Structure: Title Tag → Meta Description → H1 → H2s → H3s → FAQs → Conclusion
- Expand H2 angles using 5Ws+1H framework
- Benchmark top 5 ranking pages for content gaps
- Meta description: 150-160 characters, include clear CTA

### Internal Link Rules
- 2-5 internal links per page
- Anchor text: mix keyword anchors, brand anchors, naked URLs, and generic anchors
- Same anchor text must ALWAYS point to the same destination (never split)
- Pillar page links → child pages; child page links → parent page + sibling pages
- Homepage anchor: use the homepage's primary target keyword

### Backlink Strategy by Site Stage
New site (<3 months):
  - Quora links: 5 per important page
  - Forum/Comment links: 5 per page, spread across ~20 pages
  - Guest post: 1-2 per important page MAX
  - Always build pillow links (web 2.0, forums) BEFORE guest posts
  - Never spike links on a single page — Google will flag it

Growing site (3-12 months):
  - Target pages ranking positions 8-22 with focused link building
  - Prioritize pages with existing sales + traffic momentum
  - Gradually increase guest post frequency

Mature site (>12 months):
  - Primary target: pages in positions 8-13 → push to top 5
  - Sales top-20 pages: 1 maintenance link each
  - Mirror competitor backlink velocity

### Anchor Text Rules
- Forum/Quora: brand name OR naked URL OR generic text (never exact-match keyword)
- Guest post: exact-match keyword anchor acceptable (target 20-30% of total anchor mix)
- Always vary anchor text naturally across all link types

### GEO Strategy — Claude News Flywheel (SEO + Generative Engine Optimization)
GEO = optimizing to be cited and referenced by AI search engines (ChatGPT, Perplexity, Gemini, Claude) in addition to traditional Google SEO.

Core insight: Use Claude to collect information → rewrite as original news articles → publish to a /news section consistently → accumulate topical authority → Google ranks the site higher AND AI engines start citing the site as an authoritative source.

Why it works:
- Google rewards consistent fresh content in a niche (topical authority)
- AI search engines crawl and reference authoritative domain sources
- News content compounds: 200 articles > 10 pillar pages for keyword coverage
- Dual flywheel: SEO traffic + AI citation traffic

Flywheel implementation:
1. Pick a focused niche topic cluster
2. Use Claude to research + rewrite 2-5 news articles per week (not copy-paste — synthesize + add original angle)
3. Publish to /news or /blog with full on-page SEO (title tag, meta, H1, internal links)
4. Link from each news article to 1-2 money pages (internal link juice)
5. Track: after 3-6 months, check if Google recognizes topical authority (rankings rising across cluster)
6. Track GEO: search your niche in ChatGPT/Perplexity — does your site appear as a cited source?

Output a GEO section in the report with a concrete news content plan for the given keyword/niche.

### Link Building Quality Checklist
- Links must be permanent (not marked as sponsored or guest post)
- No rel='sponsored' or rel='ugc' attributes
- No subdomain placement — main domain only
- Dofollow preferred; nofollow is acceptable for diversity
- Verify no indexing issues on live links

---

## Output Format:

# SEO Audit Report
**Keyword:** [keyword] | **Site Stage:** [stage] | **Date:** TIMESTAMP

---

## 1. Keyword Matrix

| Type | Keyword | Est. Monthly Volume | Competition (KD) | Search Intent |
|------|---------|-------------------|-----------------|---------------|
| Primary | ... | ... | ... | ... |
| Variant | ... | ... | ... | ... |
| Long-tail | ... | ... | ... | ... |
| Question | ... | ... | ... | ... |

**Key Insight:** (2-3 sentences on keyword opportunity)

---

## 2. Title Tag & H1 Optimization

**Current Title Tag:** (score it if content provided, else N/A)

**Recommended Options:**
- Option A: [title] (Logic: Parallel)
- Option B: [title] (Logic: Call to Action)
- Option C: [title] (Logic: Progressive)

**Recommended H1:** [h1]

**Meta Description:** [150-160 char English meta description with CTA]

---

## 3. Article Structure

**Recommended Structure:**
- H1: [title]
- H2-1: [angle — What]
- H2-2: [angle — Why]
- H2-3: [angle — How]
- H2-4: [angle — Who/When/Where as needed]
- H2-FAQ: Frequently Asked Questions (3-5 Qs)
- H2-Conclusion: Summary + CTA

**Content Gaps:** (what top-ranking competitors cover that this page is missing)

---

## 4. Internal Link Audit

| Anchor Text | Destination Page | Compliance |
|-------------|-----------------|------------|
| ... | ... | ✅/⚠️/❌ |

**Issues Found:** (if any)
**New Internal Link Recommendations:** (3-5 actionable suggestions)

---

## 5. Backlink Plan

**Current Stage:** [new/growing/mature]

**This Month's Link Building Plan:**
| Type | Quantity | Target Page | Anchor Text Strategy |
|------|----------|-------------|---------------------|
| Quora | ... | ... | ... |
| Forum/Comment | ... | ... | ... |
| Guest Post | ... | ... | ... |

**Risk Warnings:** (SOP-based cautions for this site's stage)

---

## 6. GEO Strategy — Claude News Flywheel

**Niche Topic Cluster:** [identify the best cluster for this site/keyword]

**Recommended News Article Topics (first 10):**
1. ...
2. ...
3. ...
4. ...
5. ...
6. ...
7. ...
8. ...
9. ...
10. ...

**Publishing Cadence:** [recommended frequency based on site stage]

**Internal Link Plan:** [how each news article should link to money pages]

**GEO Tracking:** Check these AI engines monthly to see if site gets cited:
- ChatGPT: search "[niche] best resources" or "[topic] guide"
- Perplexity: search same queries
- Google AI Overviews: check if site appears in AI summaries

**Expected Timeline:** [when to expect GEO traction based on content volume]

---

## 7. Execution Priority

**Quick Wins (This Week):**
1. ...
2. ...

**Mid-term (1 Month):**
1. ...
2. ...

**Long-term (3 Months):**
1. ...

---

## 8. SEO Health Score

| Dimension | Score (/100) | Key Issue |
|-----------|-------------|-----------|
| Keyword Coverage | xx | ... |
| Page Structure | xx | ... |
| Internal Links | xx | ... |
| Backlink Strategy | xx | ... |
| Content Quality | xx | ... |
| GEO Readiness | xx | ... |
| **Overall** | **xx** | ... |"

# Run AI analysis
echo "Analyzing SEO data, please wait..."
echo ""

SESSION_ID="seo-$(date +%s)"
RESULT=$(openclaw agent --local --session-id "$SESSION_ID" --json -m "$PROMPT" 2>/dev/null)

# Extract text from JSON response
REPORT=$(echo "$RESULT" | python3 -c "
import json, sys
data = json.load(sys.stdin)
payloads = data.get('payloads', [])
texts = [p.get('text','') for p in payloads if p.get('text')]
print('\n'.join(texts))
" 2>/dev/null)

if [[ -z "$REPORT" ]]; then
  REPORT="$RESULT"
fi

echo "$REPORT"

# Save to file if specified
if [[ -n "$OUTPUT_FILE" ]]; then
  echo "$REPORT" > "$OUTPUT_FILE"
  echo ""
  echo "Report saved to: $OUTPUT_FILE"
fi

---
name: amazon-coupon-strategy
description: "Amazon deals, coupons, and promotions strategy agent. Plan Lightning Deals, Prime Exclusive Discounts, coupons, BOGO, Vine enrollment, and social media promo codes. Build a promotional calendar that boosts BSR, drives reviews, and clears excess inventory without destroying margin. Triggers: amazon coupons, lightning deals, prime exclusive discount, amazon promotions, deal strategy, amazon sale, promo code, amazon discount, bogo amazon, amazon vine, black friday amazon, prime day strategy, amazon deals, promotional calendar, amazon coupon strategy"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/amazon-coupon-strategy
---

# Amazon Deals & Promotions Strategy

Plan the right promotions at the right time. From daily coupons to Prime Day Lightning Deals — build a promotional calendar that drives velocity, earns reviews, and moves excess inventory without killing your margins.

## Commands

```
promo plan [product]            # full promotional strategy plan
promo coupon [discount%]        # coupon setup and ROI calculator
promo lightning                 # Lightning Deal eligibility and setup guide
promo prime-day                 # Prime Day strategy (60-day prep plan)
promo bfcm                      # Black Friday / Cyber Monday playbook
promo vine [units]              # Vine enrollment ROI calculator
promo clearance [inventory]     # excess inventory clearance plan
promo social [platform]         # social media promo code strategy
promo calendar                  # 12-month promotional calendar
promo roi [type] [details]      # calculate ROI for any promotion type
```

## What Data to Provide

- **Product & current price** — your regular selling price
- **COGS / landed cost** — to calculate margin floor
- **Current BSR & reviews** — to plan the right promo type
- **Inventory level** — units on hand and inbound
- **Sales velocity** — average units/day
- **Goal** — launch boost / ranking / clearance / reviews

## Promotion Types Overview

### 1. Coupons (Most Flexible)

**How it works**: Green "coupon" badge appears in search results and on product page. Customer clicks to clip, discount applied at checkout.

**Setup**:
- Seller Central → Advertising → Coupons
- Set $ or % discount (minimum meaningful: 5%)
- Budget: set total redemption budget
- Duration: 1 day to 90 days

**Cost**: $0.60 per redemption (charged when coupon is clipped AND redeemed)

**Best for**:
- Ongoing velocity boost (always-on 5–10% coupon)
- New product with low review count
- Price-sensitive categories

**ROI Formula**:
```
Discount cost per unit = Price × Discount% + $0.60
Net margin with coupon = Normal margin - Discount cost
Break-even: Units needed to justify coupon = (Setup cost) / (Margin improvement from rank boost)
```

**Coupon Best Practices**:
- 10%+ gets stronger badge prominence
- Combine with PPC for maximum effect
- Turn off when BSR < 1,000 (already ranking well)
- Never go below your margin floor

---

### 2. Prime Exclusive Discounts

**How it works**: Strikethrough price shown to Prime members in search. One of the strongest CTR drivers available.

**Requirements**:
- Professional seller
- 3+ star rating
- Minimum 10% discount off non-promotional price
- Must be Prime-eligible (FBA or SFP)
- Price after discount must be lowest price in 30 days (or Amazon may suppress)

**Cost**: No additional fee beyond the discount

**Best for**:
- Products with Prime-heavy customer base
- Driving velocity during slow periods
- Pre-Prime Day warm-up

---

### 3. Lightning Deals

**How it works**: Time-limited (4–12 hour) deal featured on Amazon Deals page. Creates urgency with countdown timer and "% claimed" progress bar.

**Requirements**:
- Amazon invitation (not all products qualify on demand)
- Minimum 15–20% discount off regular price
- Sufficient inventory (Amazon recommends 200+ units)
- 3+ star rating, sufficient review count

**Cost**: $150–$500 per deal (varies by event; Prime Day/BFCM slots cost more)

**ROI Calculation**:
```
Units sold during deal (estimate: 3–10× normal daily rate × deal hours)
Revenue: Units × discounted price
Cost: Units × COGS + Deal fee
Net profit/loss: Revenue - Cost
Indirect value: BSR boost → organic sales increase for weeks after
```

**Best for**:
- BSR ranking push
- Liquidating excess inventory fast
- Prime Day / BFCM event participation

**How to get invited**:
- Maintain healthy account metrics
- Consistent sales history
- Check Deals tab in Seller Central regularly
- Some categories have higher invite rates (home, kitchen, toys)

---

### 4. BOGO & Multi-Unit Discounts

**Types**:
- Buy 1 Get 1 Free (BOGO)
- Buy 2 Get X% off
- Tiered: buy 1/$X, buy 2/$Y, buy 3/$Z

**Setup**: Seller Central → Advertising → Promotions → Percentage Off

**Best for**:
- Consumables (drive repeat purchase)
- Multi-pack strategy (increase AOV)
- Moving slow-selling variants

**Margin trap to avoid**: BOGO means you give away 50% of units for free. Ensure COGS allows it:
```
Acceptable if: Price × 1 ≥ (COGS × 2) + Amazon fees × 2 + desired profit
```

---

### 5. Social Media Promo Codes

**How it works**: Create a unique discount code to share on TikTok, Instagram, YouTube, or with influencers. Code applied at checkout.

**Setup**: Seller Central → Advertising → Promotions → Create Promotion → Social Media Promo Code

**Advantages**:
- No $0.60/redemption fee (unlike coupons)
- Can track source of traffic
- Influencer partnerships without Amazon affiliate complexity
- Drives external traffic (Amazon rewards external traffic)

**Best for**:
- Influencer campaigns
- TikTok Shop / TikTok organic content
- Email list promotions
- Reddit / Facebook group seeding

---

### 6. Amazon Vine (Review Generation)

**Cost**: $200 per parent ASIN
**Units enrolled**: 1–30 units given free to Vine Voices
**Timeline to first review**: 2–4 weeks
**Review quality**: Typically detailed, honest, with images/video

**ROI Calculator**:
```
Cost = $200 + (COGS × units enrolled)
Example: $200 + ($8 × 20 units) = $360 total

Expected reviews: 15–25 of 30 enrolled units leave reviews
Cost per review: $360 / 20 reviews = $18/review

Value of reviews:
- Going from 0→20 reviews typically lifts CVR 15–25%
- At $30 price, $5 margin, 5 units/day:
  - Pre-Vine: 5 × $5 = $25/day
  - Post-Vine (20% CVR lift): 6 × $5 = $30/day
  - Extra $5/day → $1,825/year

Break-even: $360 / $5 extra/day = 72 days ✅
```

---

## 12-Month Promotional Calendar

| Month | Primary Promotion | Secondary |
|-------|-----------------|-----------|
| January | 5% always-on coupon (slow season) | Clear holiday overstock |
| February | Valentine's Day deals (if relevant) | Coupon + PPC |
| March | Spring launch deals | Prime Exclusive Discount |
| April | Easter promotions | Multi-unit discount |
| May | Mother's Day | Lightning Deal (if eligible) |
| June | Father's Day | Social promo code |
| **July** | **Prime Day** ⭐ | Lightning Deal + Coupon |
| August | Back to School | Prime Exclusive Discount |
| September | Fall launch | Vine enrollment (new products) |
| October | Halloween, Pre-BFCM | Lightning Deal eligibility check |
| **November** | **Black Friday / Cyber Monday** ⭐ | Lightning Deal + 20%+ coupon |
| December | Holiday (1–15), Clearance (16–31) | Price up then down |

## Prime Day Prep (60-Day Plan)

**60 days before**: Submit Lightning Deal nominations in Seller Central
**45 days before**: Build inventory (Prime Day sells 3–5× normal)
**30 days before**: Launch PPC campaigns at higher bids, start warming BSR
**14 days before**: Activate Prime Exclusive Discount
**7 days before**: Turn on coupon
**Day of**: Monitor stock levels hourly, adjust PPC bids up 30%
**Day after**: Keep coupon active 48 hours to capture deal-discovery traffic
**1 week after**: Analyze BSR change, review velocity, ACOS impact

## Clearance Strategy (Excess Inventory)

When to trigger: >90 days of supply on hand OR approaching long-term storage fee date

**Escalation ladder**:
1. **10% coupon** → 2 weeks, check sell-through
2. **15% Prime Exclusive Discount** → 2 weeks
3. **Lightning Deal** → if eligible
4. **20–30% price drop** → 2 weeks
5. **BOGO / multi-unit** → bundle slow + fast sellers
6. **FBA removal → sell on eBay/website** → if margin still exists
7. **Donation / destruction** → last resort, avoid long-term fees

**Long-term storage fee trigger**: 365+ days = $6.90/cubic foot (US). Act before day 300.

## Output Format

1. **Promotion Recommendation** — best promo type for your situation
2. **ROI Calculation** — projected cost, units moved, net impact
3. **Setup Instructions** — step-by-step for recommended promotion
4. **Promotional Calendar** — next 90 days of planned promotions
5. **Margin Floor Check** — confirm no promotion prices below break-even

## Rules

1. Never discount below your margin floor (COGS + fees + minimum $1 profit)
2. Don't run too many promotions simultaneously — cannibalization effect
3. Always pair promotions with PPC increases (more traffic = more deal value)
4. Track BSR before/after every promotion to measure true impact
5. Reset regular price before creating % discounts (Amazon calculates % off listed price)

---
name: amazon-return-optimizer
description: "Amazon return rate analyzer and reduction agent. Identify why customers return your products, fix listing accuracy issues, improve packaging to reduce damage returns, and manage FBA removal orders and reimbursement claims. Triggers: return rate, amazon returns, reduce returns, return analysis, fba returns, return reason, product return, amazon refund, return optimization, high return rate, listing accuracy, amazon removal order, fba reimbursement, return report, customer returns"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/amazon-return-optimizer
---

# Amazon Return Rate Optimizer

High return rates kill your margins and can get your listing suppressed. Diagnose why customers return your product, fix the root causes, and recover lost revenue from FBA reimbursements.

## Commands

```
return analyze [data]           # analyze return reasons and patterns
return audit [product]          # listing accuracy audit to reduce returns
return benchmark [category]     # return rate benchmarks for your category
return reimbursement            # FBA reimbursement claim guide
return packaging                # packaging improvement checklist
return response [reason]        # how to address specific return reason
return removal                  # FBA removal order strategy
return report                   # generate return reduction action plan
```

## What Data to Provide

- **Return rate %** — from Seller Central Voice of Customer or FBA Returns report
- **Return reasons** — paste the return reason breakdown
- **Product category** — for benchmark comparison
- **Current listing** — title, bullets, images description
- **Packaging details** — how product is packaged for shipment

## Return Rate Benchmarks by Category

| Category | Average Return Rate | High Alert |
|----------|--------------------|-----------:|
| Electronics | 8–15% | >20% |
| Clothing / Apparel | 20–40% | >45% |
| Shoes | 25–35% | >40% |
| Jewelry | 10–20% | >25% |
| Toys | 5–10% | >15% |
| Home & Kitchen | 5–12% | >18% |
| Beauty / Health | 5–10% | >15% |
| Sports & Outdoors | 5–10% | >15% |
| Books | 1–3% | >5% |
| Food & Grocery | 2–5% | >8% |

**Amazon suppression risk**: Return rate >15% above category average may trigger review

## Return Reason Analysis Framework

### Top Amazon Return Reasons & Fixes

| Return Reason | Root Cause | Fix |
|--------------|-----------|-----|
| "Item defective or doesn't work" | Manufacturing defect | Supplier QC, materials upgrade |
| "Inaccurate website description" | Listing mismatch | Rewrite bullets, update images |
| "Item smaller/larger than expected" | Size not clear | Add size comparison image, dimensions in title |
| "Wrong item sent" | Pick & pack error | Work with FBA, check SKU setup |
| "No longer needed" | Impulse purchase | Add urgency to listing, not fixable |
| "Item arrived damaged" | Packaging failure | Improve inner packaging, double-box |
| "Didn't like the quality" | Expectation mismatch | Honest listing, better photos |
| "Bought by mistake" | Listing confusion | Clearer title, compatibility section |
| "Doesn't fit" | Size guide missing | Add size chart, fit guide to listing |
| "Missing parts/accessories" | Incomplete shipment | QC check on packing line |

### Prioritization Matrix

```
High Return Rate × Fixable = ACT NOW
High Return Rate × Not Fixable = Manage/Accept
Low Return Rate × Fixable = Nice to Have
Low Return Rate × Not Fixable = Ignore
```

## Listing Accuracy Audit

Run this checklist to reduce expectation-gap returns:

### Dimensions & Size
- [ ] Exact dimensions in title or first bullet (not just in description)
- [ ] Size comparison image (next to common object or hand)
- [ ] Weight listed if relevant to customer decision
- [ ] Package dimensions vs. product dimensions clearly distinguished

### Materials & Quality
- [ ] Material composition stated (100% cotton, not just "soft fabric")
- [ ] Color accuracy: photo matches real product (calibrated display)
- [ ] Texture/finish described accurately (glossy vs. matte, rough vs. smooth)
- [ ] Fragrance/scent honestly described

### Compatibility
- [ ] Compatible models/sizes explicitly listed (for accessories)
- [ ] Incompatible items listed ("Does NOT fit iPhone 15 Pro Max")
- [ ] Power requirements, voltage, plug type (for electronics)
- [ ] Age appropriateness (for toys, children's products)

### What's in the Box
- [ ] Complete list of included items in listing
- [ ] What's NOT included (batteries, tools, etc.)
- [ ] Flat lay image showing all components

## Packaging Improvement Guide

### Transit Damage Prevention

| Issue | Solution |
|-------|---------|
| Product shifting in box | Add void fill (air pillows, paper) |
| Box crushing | Double-wall corrugated, minimum 32 ECT |
| Glass/fragile items | Bubble wrap + foam inserts, "Fragile" label |
| Electronics | Anti-static bag + foam surround |
| Liquid products | Sealed inner bag + absorbent pad |

**Amazon Drop Test Standard**: Box should survive 3-foot drop on each face, edge, and corner

### FBA Packaging Requirements
- Products must be in sealed poly bag or box (no exposed products)
- Barcodes scannable through packaging
- Sets/bundles bagged together with "Sold as Set" label
- Adult products in opaque packaging

## FBA Reimbursement Claims

Amazon owes you money when:
- Units lost in FBA warehouse
- Units damaged by Amazon (not customer)
- Customer returned item but Amazon didn't restock or reimburse
- Overcharged FBA fees (wrong size tier)

### Reimbursement Process

1. **Lost inventory**: Check Inventory Reconciliation Report → file case if discrepancy
2. **Damaged by Amazon**: Check FBA Customer Returns report → units marked "Damaged:Amazon" → file claim
3. **Customer return not received**: Wait 45 days after return initiated → file claim if not processed
4. **Fee overcharge**: Check FBA Fee Preview → measure product → file dispute if wrong tier

**Time limits**: Most claims must be filed within 18 months of incident

**Tools**: Sellerboard, Getida, GETIDA (recovery services that work on % of recovered amount)

## Return Reduction Action Plan Template

```
Week 1: Audit
- Download return reason report (90 days)
- Identify top 3 return reasons
- Score each: fixable in listing vs. product vs. packaging

Week 2: Listing Fixes
- Update listing based on accuracy audit
- Add size comparison image
- Rewrite any misleading bullets

Week 3: Packaging Fix
- Order improved packaging materials
- Update FBA prep instructions

Week 4: Monitor
- Compare return rate to 30 days prior
- File any pending reimbursement claims
- Repeat monthly
```

## Output Format

1. **Return Rate Diagnosis** — which reasons are causing most returns
2. **Priority Fix List** — top 3 changes ranked by impact
3. **Listing Accuracy Checklist** — specific items to update
4. **Packaging Recommendations** — if damage is a factor
5. **Reimbursement Opportunity** — estimate of recoverable Amazon errors
6. **30-Day Action Plan** — week-by-week improvement roadmap

---
name: amazon-pricing-strategy
description: "Amazon pricing strategy and repricing agent. Set competitive prices, build repricing rules, analyze Buy Box win rate, plan promotional pricing, and balance margin vs. volume. Works for private label and resellers. Triggers: amazon pricing, repricing, buy box, price strategy, amazon price, competitive pricing, price optimization, dynamic pricing, buy box winner, price war, margin optimization, amazon repricer, price elasticity, promotional pricing, amazon price strategy"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/amazon-pricing-strategy
---

# Amazon Pricing Strategy Agent

Set the right price to win Buy Box, maximize revenue, and protect margins. From launch pricing to long-term repricing rules — your pricing co-pilot.

## Commands

```
price analyze [product]         # full pricing strategy analysis
price launch [cogs] [market]    # optimal launch price recommendation
price buybox [situation]        # Buy Box win strategy
price reprice [rules]           # set up repricing logic
price elastic [data]            # price elasticity analysis
price promo [type]              # promotional pricing plan
price floor [cogs]              # calculate minimum viable price
price compare [competitors]     # competitive price positioning
price seasonal                  # seasonal pricing calendar
```

## What Data to Provide

- **Your COGS** (landed cost per unit)
- **Current price & sales velocity**
- **Competitor prices** — paste from search results
- **Buy Box win rate** — from Seller Central
- **Target margin %** — your profit floor
- **Product stage** — launch / growth / mature / declining

## Pricing Strategy by Stage

### Stage 1: Launch Pricing (First 30–60 days)
**Goal**: Velocity over margin — get reviews and ranking fast

| Approach | Price Point | When to Use |
|----------|------------|-------------|
| Aggressive launch | 10–20% below market average | New product, competitive category |
| Parity launch | Match #1 competitor | Differentiated product, strong listing |
| Premium launch | 10–15% above average | Clear differentiation, strong brand |

**Launch pricing formula**:
```
Floor price = COGS × 1.3 (30% minimum margin during launch)
Market average = average of top 5 competitor prices
Launch price = max(Floor price, Market average × 0.85)
```

### Stage 2: Growth Pricing (60–180 days)
**Goal**: Balance velocity and margin

- Raise price $1–2 every 2 weeks as reviews accumulate
- Stop raising when sales velocity drops >15%
- Target: get to your "full price" within 90 days of launch

### Stage 3: Mature Pricing (180+ days)
**Goal**: Maximize profit, defend position

- Monitor competitor prices weekly
- Reprice within a defined band (floor to ceiling)
- Use promotions to stimulate volume during slow periods

### Stage 4: Declining (Low BSR, high competition)
**Goal**: Liquidate cleanly or relaunch

- Drop price to move inventory before storage fees spike
- Consider removal if margin-negative

## Buy Box Strategy

### How Amazon Decides Buy Box Winner (Private Label)
For your own brand (no other sellers): You win Buy Box if:
- Account Health is Good
- You have FBA inventory available
- Price is competitive vs. your own historical pricing
- Not flagged for high-price violation

### Buy Box for Resellers (Multi-Seller Competition)
Amazon's algorithm weights:
1. **Price** (most important) — lowest landed price often wins
2. **Fulfillment method** — FBA beats FBM
3. **Seller metrics** — ODR, late shipment rate
4. **Inventory availability** — in-stock wins
5. **Account health** — healthy accounts preferred

**Repricing rules for Buy Box:**
```
IF (my price > lowest FBA competitor price + $0.50):
  → Lower price by $0.25
IF (I'm winning Buy Box and margin > target):
  → Try raising price by $0.10 every 24 hours
IF (price hits floor):
  → Stop repricing, accept lower Buy Box share
```

## Price Floor Calculation

Never price below your floor. Calculate it:

```
Minimum viable price = COGS + Amazon fees + minimum profit

Example (Standard product, $9 COGS):
COGS:                    $9.00
Referral fee (15%):      $X × 15%
FBA fee:                 $3.22 (large standard, 1lb)
Min profit target:       $2.00
─────────────────────────────
Solve: Price = COGS + FBA + (Price × 0.15) + Min Profit
Price = (9 + 3.22 + 2) / (1 - 0.15) = $16.73 floor
```

## Promotional Pricing Playbook

### Lightning Deals
- Minimum discount: 15–20% off regular price
- Amazon selects eligible products (can't self-submit all products)
- Best timing: Prime Day, Black Friday, Cyber Monday
- Cost: $150–$300 per deal slot (varies by event)
- ROI: Best for BSR ranking boost, not pure profit

### Coupons
- Clip-and-save badge improves CTR (green badge visible in search)
- Set 5–20% discount (lower amounts still get the badge)
- Cost: $0.60 per redemption
- Best for: Driving trial on new products, price-sensitive categories

### Prime Exclusive Discounts
- Only shown to Prime members
- Requires: 10%+ discount, 3+ star rating
- Shows strikethrough price in search — strong CTR driver

### BOGO / Multi-unit
- "Buy 2, get 10% off" — increases average order value
- Good for consumables, multi-pack strategy

## Price Elasticity Framework

Without sales data, estimate elasticity by category:

| Category Type | Elasticity | Meaning |
|--------------|-----------|---------|
| Commodity (generic, many sellers) | High | Small price drop → big volume gain |
| Differentiated (brand, unique features) | Low | Price changes don't move volume much |
| Gift / impulse | Medium | Sweet spot pricing matters |
| Consumable / repeat purchase | Low-Medium | Loyalty reduces price sensitivity |

**To measure your elasticity**:
1. Raise price $2 for 2 weeks, note sales change
2. Drop price $2 for 2 weeks, note sales change
3. Calculate: % change in units / % change in price = elasticity coefficient

## Seasonal Pricing Calendar

| Period | Strategy |
|--------|---------|
| Jan–Feb | Hold or slight discount (post-holiday slowdown) |
| Mar–Apr | Restore full price, spring categories up |
| May–Jun | Stable, prep Prime Day inventory |
| Jul (Prime Day) | Deep discounts day-of, price back up after |
| Aug–Sep | Hold price, prep Q4 |
| Oct | Price up 5–10% before holiday rush |
| Nov (BFCM) | Lightning deals, coupons, max promotion |
| Dec 1–15 | Hold premium price (urgent gift buyers) |
| Dec 16–25 | Drop price to clear remaining inventory |

## Output Format

1. **Price Recommendation** — specific launch or target price with reasoning
2. **Floor Price Calculation** — your absolute minimum viable price
3. **Repricing Rules** — min/max band and trigger conditions
4. **Competitive Positioning** — where you sit vs. top 5 competitors
5. **Promo Calendar** — recommended discount events for next 90 days

---
name: amazon-product-photography
description: "Amazon product photography planning and briefing agent. Plan main images, lifestyle shots, infographics, and size comparison photos. Generate photographer briefs, shot lists, and image optimization guidelines for maximum click-through rate and conversion. Triggers: product photography, amazon photos, main image, lifestyle photo, infographic, photo brief, amazon images, product photos, amazon listing images, image optimization, photo shot list, amazon ctr, product photo guide, image strategy, amazon photo requirements"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/amazon-product-photography
---

# Amazon Product Photography Guide

Plan and brief your product photography to maximize CTR and conversion. From main image strategy to infographic design — know exactly what images you need and why.

## Commands

```
photo plan [product]            # full 7-image strategy plan
photo main [product]            # main image brief
photo lifestyle [product]       # lifestyle shot list
photo infographic [product]     # infographic content plan
photo brief                     # generate photographer brief doc
photo audit [describe images]   # score existing images
photo requirements              # Amazon technical requirements
photo mobile                    # mobile thumbnail optimization
```

## What Data to Provide

- **Product type & category** — what it is
- **Target customer** — who uses it (age, gender, lifestyle)
- **Key selling points** — top 3 features to visually communicate
- **Competitors** — describe their images so we can differentiate
- **Brand style** — clean/minimal vs. lifestyle/warm vs. technical/studio

## 7-Image Strategy Framework

### Image 1: Main Image (Most Critical)
**Purpose**: Win the click in search results
**Rules**:
- Pure white background (RGB 255,255,255) — mandatory
- Product fills 85%+ of frame
- No text, no props, no logos (except on product itself)
- Show the actual product, not packaging (usually)
- High resolution: minimum 1000px on shortest side (2000px recommended)

**CTR Optimization**:
- Show your best angle (usually 3/4 view)
- If multiple pieces, show all of them
- If color variations, show the most appealing color
- Consider: what thumbnail wins at 100px × 100px?

### Image 2: Feature Callout / Infographic
**Purpose**: Communicate 3–4 key features fast
**Format**: Product image + text overlays pointing to features
**Best for**: Technical products, multi-feature products
**Copy**: Short feature labels, not full sentences

### Image 3: Lifestyle / In-Use Shot
**Purpose**: Help customer visualize owning the product
**Elements**:
- Real person using the product (or implied use context)
- Environment matches target customer's life
- Emotion: show the feeling of using the product
- No direct eye contact with camera (feels more authentic)

### Image 4: Size Comparison
**Purpose**: Set accurate size expectations, reduce returns
**Options**:
- Product next to a common object (coin, hand, ruler)
- Dimensions overlaid on product photo
- Before/after size context (e.g., fits in a pocket)

### Image 5: Benefits / Results Shot
**Purpose**: Show the outcome, not just the product
**Examples**:
- Skincare: before/after or glowing skin close-up
- Kitchen tool: beautiful finished dish
- Fitness: person after workout looking energized
- Organization: tidy shelf vs. cluttered shelf

### Image 6: What's in the Box
**Purpose**: Eliminate "what do I get?" uncertainty
**Format**: Flat lay of all included items with numbered callouts
**Include**: All accessories, documentation, packaging

### Image 7: Social Proof / Certification
**Purpose**: Build trust and reduce purchase hesitation
**Options**:
- "X,000+ customers" with star rating graphic
- Certification logos (CE, FDA, BPA-free)
- Award badges
- Press mentions / media logos

## Infographic Design Guide

### Layout Options
| Type | Best For |
|------|----------|
| **Icon grid** | Products with 4–6 distinct features |
| **Side-by-side comparison** | Vs. competitor or vs. old way |
| **Before/after** | Products with transformative results |
| **How it works** (3-step) | Products with process/usage sequence |
| **Spec breakdown** | Technical/measurement-driven products |

### Infographic Copy Rules
- Headline: max 6 words, benefit-focused
- Feature label: max 3 words
- Supporting line: max 10 words
- Font minimum: 24pt equivalent (must be readable at thumbnail)
- High contrast: dark text on light, or light on dark — no grey-on-grey

## Photographer Brief Template

```
PROJECT: [Brand] [Product] Amazon Listing Photography
DATE: [Date]
DELIVERABLES: 7 images per colorway

IMAGE SPECS:
- Resolution: 3000 × 3000px minimum
- Format: JPEG, sRGB color profile
- Main image: pure white background (#FFFFFF)
- Secondary images: [style direction]

BRAND STYLE:
- Color palette: [hex codes]
- Mood: [clean/warm/technical/lifestyle]
- Reference images: [attach 2-3 reference photos]

SHOT LIST:
1. Main hero — [angle], [background], [props if any]
2. Feature callout — [which features to highlight]
3. Lifestyle — [scene description], [model type if any]
4. Size comparison — [comparison object]
5. Results/benefit — [what to show]
6. What's in the box — [flat lay setup]
7. Trust/certification — [which certifications to display]

MODELS/PROPS NEEDED:
- [List any models, ages, demographics]
- [List props needed]

DO NOT:
- [List brand-specific restrictions]
- Competitors' products in frame
- Logos not belonging to brand
```

## Amazon Image Technical Requirements

| Requirement | Specification |
|-------------|--------------|
| Main image background | Pure white (RGB 255,255,255) |
| Minimum resolution | 1000px on shortest side |
| Recommended resolution | 2000px+ (enables zoom) |
| File formats | JPEG, PNG, GIF, TIFF |
| Max file size | 10MB |
| Product in frame | Must fill ≥85% of image |
| Forbidden on main | Text, logos, watermarks, props |

## CTR by Image Type (Research Benchmarks)

- Main image with product only: baseline
- Main image showing all variants: +8% CTR
- Main image with lifestyle element (rule-bending): risky but +15% if approved
- A/B tested main image: +12–25% CTR improvement

## Output Format

1. **7-Image Shot List** — exact brief for each image
2. **Infographic Content Plan** — which features, what copy, what layout
3. **Photographer Brief** — complete ready-to-send document
4. **Main Image Critique** — if existing image provided, specific improvements
5. **Mobile Thumbnail Test** — does it work at 100px?

## Rules

1. Main image compliance is non-negotiable — violations get listings suppressed
2. Always plan for the mobile thumbnail first (most searches are mobile)
3. Every image must answer one customer question — no "decorative" filler images
4. Lifestyle images should show aspiration, not just product use
5. Infographic text must be readable without zooming on mobile

---
name: amazon-aplus-content
description: "Amazon A+ content (Enhanced Brand Content) builder. Design module layouts, write conversion-optimized copy, create brand story sections, and plan comparison charts. Works for Standard A+ and Premium A+. Triggers: a+ content, amazon a+, enhanced brand content, ebc, amazon brand story, a+ modules, premium a+, a+ content builder, amazon brand content, a+ copy, brand story, a+ design, amazon ebc, product detail page, a+ comparison chart"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/amazon-aplus-content
---

# Amazon A+ Content Builder

Design high-converting A+ content modules, write compelling copy, and plan your brand story. Turn your product detail page into a sales machine.

## Commands

```
a+ plan [product]               # plan A+ module layout strategy
a+ copy [module type]           # write copy for specific module
a+ brand story                  # write brand story section
a+ compare [products]           # build comparison chart
a+ audit [paste existing]       # score and improve existing A+
a+ premium                      # Premium A+ module planning
a+ mobile                       # mobile-optimized A+ checklist
a+ save [product]               # save A+ content plan
```

## What Data to Provide

- **Product & brand** — what you sell, your brand positioning
- **Target customer** — who buys, their pain points and desires
- **Key differentiators** — what makes you better than competitors
- **Brand assets** — colors, fonts, visual style (describe or paste)
- **Competitor A+** — describe competitor pages to differentiate

## A+ Module Types Reference

### Standard A+ (Available to Brand Registry sellers)

| Module | Best Used For | Copy Length |
|--------|--------------|-------------|
| **Header Image with Text** | Hero brand statement | Headline 150 chars, body 300 chars |
| **Image & Text** | Feature highlights | 300 chars per block |
| **Image Sidebar** | Specifications + visual | 200 chars |
| **Technical Specs Table** | Product details | 20 rows max |
| **Four Image with Text** | Use cases / benefits | 200 chars each |
| **Logo + Description** | Brand intro | 600 chars |
| **Comparison Chart** | Product line showcase | Up to 6 ASINs |
| **Single Image** | Lifestyle/usage shot | No text required |

### Premium A+ (For qualifying brands with Brand Story)

Additional modules:
- **Interactive Image Hotspot** — clickable image zones
- **Q&A Module** — FAQ format with expandable answers
- **Video Module** — embed product/brand video
- **Carousel** — swipeable multi-image module

## A+ Content Strategy by Goal

### Goal: Reduce Returns
Focus on: Technical specs table, size/fit guide, what's-in-the-box module
Copy angle: Set accurate expectations, answer "will this fit/work for me?"

### Goal: Increase Conversion Rate
Focus on: Hero image with power headline, 3–4 key benefits with lifestyle photos
Copy angle: Emotional benefit + proof point in every module

### Goal: Build Brand Loyalty
Focus on: Brand story, founder narrative, sustainability/mission
Copy angle: Why we exist, what we stand for, our promise

### Goal: Upsell Product Line
Focus on: Comparison chart (position this product as mid-tier, show premium)
Copy angle: "Good / Better / Best" positioning

## Copy Framework by Module

### Hero Header Formula
```
[Transformation Statement] — [How You Achieve It]
Example: "Sleep Through the Night — Engineered for Side Sleepers"
```

### Feature Module Formula
```
[Benefit Headline — NOT feature]
[1-sentence explanation of how it works]
[Proof point or spec if available]

❌ Weak: "Memory Foam Material"
✅ Strong: "Wakes Up With You — Responds to body heat in 3 seconds for perfect pressure relief"
```

### Brand Story Framework (600 chars)
```
1. Origin (2 sentences): Why we started, what problem we saw
2. Mission (1 sentence): What we're trying to do for customers
3. Promise (1 sentence): What you can always expect from us
4. CTA: Invite them into the community/brand
```

## A+ Content Rules (Amazon Policy)

**Prohibited:**
- Pricing or promotional information ("$49.99", "Buy 2 get 1 free")
- References to customer reviews ("As seen in 5-star reviews")
- Time-sensitive claims ("Limited time offer")
- Competitor brand names
- Shipping information
- "Best seller" or "#1" claims without substantiation
- Blurry, low-resolution images (<72 DPI)

**Recommended image specs:**
- Minimum: 970px wide
- Ideal: 1500px wide (auto-scales for mobile)
- Aspect ratios vary by module — check Seller Central for exact specs

## Conversion Rate Benchmarks

| A+ Quality Level | Typical CVR Lift |
|-----------------|-----------------|
| No A+ content | Baseline |
| Basic A+ (text-heavy) | +3–5% |
| Good A+ (balanced images + copy) | +8–12% |
| Premium A+ (interactive, video) | +15–20% |

## Mobile Optimization Checklist

- [ ] Text readable without zooming (min 16px equivalent)
- [ ] No critical info hidden in image (mobile crops differently)
- [ ] Headline visible above fold on mobile
- [ ] Comparison chart columns ≤4 (wider tables scroll poorly)
- [ ] Videos have captions (60% watch without sound)

## Output Format

1. **Module Layout Plan** — recommended sequence of 5–7 modules
2. **Copy for Each Module** — headline + body text, ready to paste
3. **Image Brief** — what each image should show (for designer/photographer)
4. **Brand Story Draft** — complete 600-char brand story
5. **Conversion Score** — 100-point audit with specific improvements

## Rules

1. Lead every module with a benefit, not a feature
2. Mobile-first: if it doesn't work on a 375px screen, redesign it
3. No module should repeat information from another
4. Every image needs a clear subject — no busy backgrounds
5. Brand story must feel human, not corporate

---
name: cross-border-payment-guide
description: "Cross-border payment solution guide for Amazon and e-commerce sellers. Compare Payoneer, WorldFirst (Airwallex), PingPong, XTransfer, and LianLian on fees, FX rates, withdrawal limits, and account features. Calculate currency conversion costs and choose the best collection account for your market. Triggers: cross-border payment, payoneer, worldfirst, pingpong, xtransfer, amazon payment, currency collection, fx rate, foreign currency, amazon settlement, lianlian, airwallex, cross-border collection, currency exchange, amazon payout, seller payment account"
allowed-tools: Bash
metadata:
  openclaw:
    homepage: https://github.com/mguozhen/cross-border-payment-guide
---

# Cross-Border Payment Solution Guide

Choose the right payment collection account for your Amazon business. Compare fees, FX rates, withdrawal speed, and features — keep more of your hard-earned revenue.

## Commands

```
payment compare                 # compare all major payment platforms
payment fees [platform] [amount]  # calculate exact fees for a transfer
payment fx [currency] [amount]  # compare FX rates across platforms
payment recommend [profile]     # get personalized recommendation
payment setup [platform]        # account setup requirements
payment tax [country]           # tax reporting requirements
payment multi                   # multi-currency account strategy
payment save [setup]            # save payment configuration
```

## What Data to Provide

- **Amazon marketplaces** — where you sell (US, UK, DE, JP, etc.)
- **Monthly revenue** — to calculate which platform saves most
- **Home currency** — what you want to withdraw to (CNY, USD, etc.)
- **Withdrawal frequency** — daily, weekly, monthly
- **Business type** — individual, company, Chinese entity

## Platform Comparison

### Payoneer
| Feature | Details |
|---------|---------|
| Receiving fee | 0% (from Amazon) |
| Withdrawal fee | 2% (to local bank) |
| FX spread | 2–3.5% above mid-market |
| Withdrawal speed | 2–5 business days |
| Min withdrawal | $50 |
| Supported markets | 200+ countries |
| Best for | Global sellers, non-Chinese sellers |
| Weakness | Higher FX spread, slow for large amounts |

### WorldFirst (now Airwallex in some markets)
| Feature | Details |
|---------|---------|
| Receiving fee | 0% |
| Withdrawal fee | 0.3–0.5% |
| FX spread | 0.5–1.5% above mid-market |
| Withdrawal speed | Same day to 2 days |
| Min withdrawal | None |
| Supported markets | 40+ currencies |
| Best for | High-volume sellers, competitive FX needs |
| Weakness | Stricter compliance checks |

### PingPong
| Feature | Details |
|---------|---------|
| Receiving fee | 0% |
| Withdrawal fee | 1% (USD→CNY) |
| FX spread | 1–2% |
| Withdrawal speed | 1–3 business days |
| Min withdrawal | $200 |
| Best for | Chinese sellers, small-medium volume |
| Weakness | Limited non-Chinese withdrawal options |

### XTransfer
| Feature | Details |
|---------|---------|
| Receiving fee | 0% |
| Withdrawal fee | 0% |
| FX spread | 0.3–0.8% (competitive) |
| Withdrawal speed | Same day (CNY) |
| Min withdrawal | None |
| Best for | Chinese manufacturing companies, B2B |
| Weakness | Newer platform, less brand recognition |

### LianLian Pay
| Feature | Details |
|---------|---------|
| Receiving fee | 0% |
| Withdrawal fee | 0.7–1% |
| FX spread | 1–2% |
| Withdrawal speed | 1–3 business days |
| Best for | Chinese individual sellers |
| Weakness | Limited to CNY withdrawal primarily |

## FX Cost Calculator

**Monthly revenue**: $10,000 USD → CNY

| Platform | FX Spread | Withdrawal Fee | Total Cost | You Receive (approx) |
|----------|-----------|---------------|------------|---------------------|
| XTransfer | 0.5% | 0% | $50 | ¥71,892 |
| WorldFirst | 1.0% | 0.3% | $130 | ¥71,012 |
| PingPong | 1.5% | 1.0% | $250 | ¥70,096 |
| Payoneer | 2.5% | 2.0% | $450 | ¥68,544 |

*Based on approximate USD/CNY rate of 7.25. Actual rates vary daily.*

**Annual savings** (XTransfer vs Payoneer at $10k/month): ~$4,800/year

## Multi-Currency Strategy

For sellers on multiple Amazon marketplaces:

```
Amazon US (USD) ──────────────────────→ WorldFirst/XTransfer USD account
Amazon UK (GBP) ──────────────────────→ WorldFirst GBP account (hold & convert at best rate)
Amazon DE (EUR) ──────────────────────→ WorldFirst EUR account
Amazon JP (JPY) ──────────────────────→ Payoneer JPY → convert when rate is favorable
                                                    ↓
                              Convert to CNY when exchange rate peaks
                              Withdraw to Chinese business bank account
```

**Key Strategy**: Hold in foreign currency, convert when rate is favorable. Don't auto-convert every withdrawal.

## Platform Selection by Seller Profile

| Seller Type | Recommended Platform | Why |
|-------------|---------------------|-----|
| New seller, <$5k/month | PingPong or LianLian | Easy setup, low minimum |
| Chinese seller, $5k–$50k/month | XTransfer or WorldFirst | Best FX rates |
| Global seller (non-CN) | Payoneer or WorldFirst | Wider coverage |
| High volume >$50k/month | WorldFirst or Airwallex | Volume discounts, dedicated support |
| B2B factory/manufacturer | XTransfer | Purpose-built for manufacturers |
| Multi-marketplace seller | WorldFirst | Best multi-currency account |

## Tax Reporting Considerations

### For Chinese Sellers (人民币提现)
- Withdrawals >$50,000/person/year require State Administration of Foreign Exchange (SAFE) documentation
- Company accounts have higher limits than personal accounts
- Keep all transaction records for VAT filing
- Use company account vs. personal account — different tax treatment

### VAT Registration (EU/UK Sellers)
If selling in EU/UK, you may need VAT registration:
- UK: Register if selling >£85,000/year or using Amazon FBA in UK
- Germany: Register before first sale (no threshold for non-EU sellers)
- Use platforms like Avalara or Taxjar for automated VAT compliance

## Setup Requirements by Platform

### Payoneer
- Valid passport or national ID
- Proof of address
- Bank account details
- Business documentation (if business account)

### WorldFirst
- Company registration documents
- Director/shareholder ID
- Business bank account
- Proof of Amazon seller account

### PingPong / XTransfer / LianLian
- Chinese ID card (for individuals)
- Business license (for companies)
- Amazon seller account verification

## Output Format

1. **Platform Recommendation** — best fit based on your profile
2. **Annual Cost Comparison** — exact savings vs. your current platform
3. **Multi-Currency Strategy** — when to convert, which accounts to use
4. **Setup Checklist** — documents needed for recommended platform
5. **Tax Reminders** — jurisdiction-specific compliance notes