ecommerce-ad-copy-generator

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 validation plus error handling.

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

Parse and validate input fields:
- user_id
- product_name
- selling_points (list or delimited string)
- target_audience
Call SkillPay POST /billing/charge with amount 0.10 USDT.
If billing succeeds, generate exactly 5 platform-adapted ad copies.
If billing returns insufficient balance, return INSUFFICIENT_BALANCE with payment_url.
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