ai-ecom-skills 0.1.0

AI e-commerce skills for Qianchuan advertising operations, compatible with Codex/OpenClaw/Cursor

ai-ecom-skills

AI e-commerce skills for Qianchuan (巨量千川) advertising operations.

Compatible with Codex, OpenClaw, and Cursor.

Installation

pip install ai-ecom-skills

Quick Start

# Install skill to all platforms (Codex/OpenClaw/Cursor)
ai-ecom-skills install --target all

# Set backend API URL
export BACKEND_API_BASE_URL=http://localhost:8080

# Restart your agent (Codex/OpenClaw/Cursor)

CLI Commands

Command	Description
ai-ecom-skills install --target all	Install to all platforms
ai-ecom-skills install --target codex	Install to Codex only
ai-ecom-skills install --target openclaw	Install to OpenClaw only
ai-ecom-skills uninstall --target all	Uninstall from all platforms
ai-ecom-skills list	Show installation status
ai-ecom-skills info	Show skill information

Features

Analysis Skills

• ReviewSummarySkill - Summarize execution results (before/after comparison)
• RiskGuardrailSkill - Check risk policies (kill_switch, budget limits)
• ActionProposalDraftSkill - Generate optimization proposals

Fetch Skills

• FetchPlanCoreContextSkill - Fetch plan basic info
• FetchPlanMetricsSkill - Fetch daily metrics (ROI/cost/GMV)
• FetchPlanHourlyMetricsSkill - Fetch hourly metrics

Execute Skills

• ExecuteAdjustBudgetSkill - Adjust plan budget
• ExecuteAdjustBidSkill - Adjust plan bid
• ExecutePausePlanSkill - Pause an ad plan

Python Usage

from ai_ecom_skills.skills.review_summary import ReviewSummarySkill
from ai_ecom_skills.schemas.agent import AgentTaskRequest

skill = ReviewSummarySkill()
request = AgentTaskRequest(
    targetId="plan-001",
    context={
        "metrics_before": {"roi": 2.5, "cost": 100.0},
        "metrics_after": {"roi": 3.8, "cost": 120.0},
        "execution_label": "提高预算 20%",
    },
)
suggestion = skill.run(request)
print(suggestion.summary)

Requirements

• Python >= 3.11
• Backend API service running (for Fetch/Execute skills)

License

MIT