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 targe...

Security Scan

The skill's code, runtime instructions, and optional environment variables are consistent with an ecommerce ad-copy generator that charges via a SkillPay billing endpoint; nothing in the bundle requests unrelated credentials, unusual installs, or hidden exfiltration.

Purpose & Capability

Name/description (batch ecommerce ad copy generation with SkillPay billing) align with the included code and SKILL.md: the Python script validates input, calls a billing endpoint, and produces five platform-specific ad copies. All declared behavior is explained by the stated purpose.

Instruction Scope

SKILL.md instructs the agent to validate inputs, call POST /billing/charge, handle insufficient balance, and return structured JSON. The code implements exactly these steps and does not read unrelated files or environment variables beyond the optional SkillPay settings.

Install Mechanism

No install spec (instruction-only) and the provided code is pure Python using stdlib urllib; nothing downloads or extracts remote installers. This is low-risk from an install perspective.

Credentials

No required env vars are declared in the registry; SKILL.md and the code list optional SkillPay-related environment variables (endpoint, API key, payment URL template). These are proportional to a billing integration. Note: SKILLPAY_API_KEY is optional — providing it grants the skill bearer ability to authenticate billing requests, so only supply it to trusted skills/endpoints.

Persistence & Privilege

Skill does not request persistent/always-on privileges, does not modify other skills or system configs, and is user-invocable only. Autonomous invocation is allowed by platform default but is not combined with other privilege escalation indicators.

Assessment

This skill appears internally consistent: it validates inputs, charges a SkillPay endpoint, and returns 5 ad copies. Before installing, verify you trust the SkillPay endpoint (default: https://skillpay.me) and the skill author (source/homepage are missing). Only supply SKILLPAY_API_KEY if you trust the billing provider and the skill; review the code (scripts/ecommerce_ad_copy_generator.py) yourself if you can. If you need stronger assurance, run the included unit tests locally and/or point SKILLPAY_CHARGE_ENDPOINT to a test endpoint to observe behavior without real charges.

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