/ Diretório / Playground / claude-ecom
● Comunidade takechanman1228 ⚡ Instantâneo

claude-ecom

por takechanman1228 · takechanman1228/claude-ecom

Drop a sales CSV in; get a KPI decomposition, ranked findings, and concrete next actions — powered by a Python analysis backend.

A Claude Code skill for e-commerce operators. Takes an orders or sales CSV and produces a structured business review: revenue decomposition, conversion and AOV trends, customer cohort signals, and a prioritized action list. Runs a Python backend so math is correct, not LLM-guessed.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

claude-ecom-skill.replay ▶ pronto
0/0

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: claude-ecom

Weekly sales review in 10 minutes instead of 2 hours

👤 DTC founders, e-commerce managers ⏱ ~15 min beginner

Quando usar: Monday morning review of last week's numbers.

Fluxo
  1. Hand over the CSV
    Use claude-ecom. Here's last week's orders.csv — do a KPI decomposition and tell me what moved.✓ Copiado
    → Revenue, CVR, AOV numbers with week-over-week deltas
  2. Ask for findings
    Rank the top 3 findings by impact. Be specific — named SKUs, traffic sources, time windows.✓ Copiado
    → Findings with data points, not 'revenue went up'
  3. Extract actions
    For each finding, propose one concrete action I can take this week.✓ Copiado
    → Action list I could paste in a Monday standup

Resultado: A weekly review I actually read.

Armadilhas
  • Garbage CSVs produce garbage reviews — Clean the export first — merge refunds, exclude test orders
Combine com: filesystem

Understand why a specific SKU is underperforming

👤 Product managers, merchandisers ⏱ ~20 min intermediate

Quando usar: A hero SKU suddenly slowed down and you need to know whether it's traffic, conversion, or pricing.

Fluxo
  1. Filter to SKU
    Use claude-ecom. Focus on SKU SHIRT-BLK-M for the last 60 days. Decompose revenue into traffic × CVR × AOV and compare to the prior 60.✓ Copiado
    → Decomposition with clear delta per factor
  2. Check channel split
    Is the drop concentrated in one channel or across all?✓ Copiado
    → Channel breakdown with concentration analysis

Resultado: A diagnosis, not a vibe.

Customer cohort retention report from order data

👤 Growth teams watching LTV ⏱ ~30 min intermediate

Quando usar: Quarterly review of cohort repeat rates.

Fluxo
  1. Cohort the data
    Use claude-ecom. Build a monthly acquisition-cohort retention table — orders/customer by month since first order.✓ Copiado
    → Triangular retention table
  2. Compare cohorts
    Which cohort is best? Worst? What's different about them?✓ Copiado
    → Hypotheses grounded in the data

Resultado: A retention view you could share with an investor.

Armadilhas
  • Short data windows distort recent cohorts — Flag cohorts with <3 months of history as provisional

Combinações

Combine com outros MCPs para 10× de alavancagem

claude-ecom-skill + filesystem

Point at a folder of weekly CSVs for automated trend analysis

Run the weekly review for each CSV in data/weekly/ and build a running dashboard.✓ Copiado
claude-ecom-skill + bigquery-server

Instead of CSVs, pull from a warehouse

Query BigQuery for last week's orders and feed into claude-ecom for the review.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
load_csv path, column mapping Starting any analysis local
kpi_decompose date range Weekly / monthly review local Python
rank_findings analysis output After decomposition 0
cohort_table cohort granularity Retention analysis local

Custo e limites

O que custa rodar

Cota de API
None
Tokens por chamada
Moderate — summary tables only, not raw rows
Monetário
Free (needs local Python)
Dica
Aggregate in Python; never paste raw orders rows into prompts.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: None
Saída de dados: Order summaries and findings are sent to Claude API; raw rows can stay local if you keep aggregation server-side

Solução de problemas

Erros comuns e correções

Column mapping fails

Standard Shopify/Woo exports work out of the box. For custom exports, supply a column map in the prompt.

Wild numbers in the output

Check for duplicate order rows or non-currency values in the revenue column

Alternativas

claude-ecom vs. outros

AlternativaQuando usarTroca
Looker Studio / Metabase dashboardsYou want persistent dashboards, not one-shot reviewsSetup cost; no LLM-generated narrative
Shopify's own reportsQuick built-in viewsShallow; no cross-store or cohort analysis

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills