SkillHub

ecommerce-ad-copy-generator

v1.0.0

Generate paid ecommerce ad copy in batch with SkillPay billing. Use when the user needs 5 ready-to-use ad copies from product name, selling points, and target audience; charge 0.10 USDT per request via /billing/charge; return payment_url when balance is insufficient; and enforce strict input validat...

Sourced from ClawHub, Authored by 安东子

Installation

Please help me install the skill `ecommerce-ad-copy-generator` from SkillHub official store. npx skills add wingogx/ecommerce-ad-copy-generator

Ecommerce Ad Copy Generator

Overview

Generate 5 conversion-focused ad copies for Facebook / Google / TikTok from structured product input. Charge 0.10 USDT per run before content generation.

Workflow

  1. Parse and validate input fields:
  2. user_id
  3. product_name
  4. selling_points (list or delimited string)
  5. target_audience
  6. Call SkillPay POST /billing/charge with amount 0.10 USDT.
  7. If billing succeeds, generate exactly 5 platform-adapted ad copies.
  8. If billing returns insufficient balance, return INSUFFICIENT_BALANCE with payment_url.
  9. Return structured JSON output for downstream use.

Run

  • Core script: scripts/ecommerce_ad_copy_generator.py
  • Test script: scripts/test_ecommerce_ad_copy_generator.py

Run with direct arguments:

python3 scripts/ecommerce_ad_copy_generator.py 
  --user-id user_001 
  --product-name "CloudBoost 智能投放器" 
  --selling-points 智能出价 多平台同步 分钟级报表 
  --target-audience "跨境电商运营团队"

Run with JSON file:

python3 scripts/ecommerce_ad_copy_generator.py --input-file ./payload.json

Run tests:

python3 -m unittest scripts/test_ecommerce_ad_copy_generator.py -v

Output Contract

Success: - success: true - pricing.amount: "0.10" - pricing.currency: "USDT" - copies: exactly 5 items, each containing: - platform - headline - body - cta

Billing failure: - VALIDATION_ERROR for invalid input - INSUFFICIENT_BALANCE and payment_url when top-up is required - BILLING_ERROR for non-balance billing failures

Environment Variables

  • SKILLPAY_CHARGE_ENDPOINT (default: https://skillpay.me/billing/charge)
  • SKILLPAY_API_KEY (optional bearer token)
  • SKILLPAY_PAYMENT_URL_TEMPLATE (optional; supports {user_id})
  • SKILLPAY_TOPUP_BASE_URL (default: https://skillpay.me/pay)

References

  • SkillPay request/response assumptions and fallback behavior: references/skillpay-api-contract.md