Ned - Shopify Profit Analytics AI — Ned - Shopify 利润分析 AI

Ned Analytics Ned（meetned.com）是Shopify商家的AI商业合作伙伴。它将您的Shopify商店、Meta Ads、Google Ads、Klaviyo、3PL提供商和成本数据连接到一个单一的数据仓库，然后允许您通过AI聊天、视觉仪表盘、公共API、TypeScript SDK或此技能查询所有数据。Ned以订单和产品级别存储利润。每个SKU，每一美元广告费，每一笔退款。它是唯一提供真实盈利能力完整图景的平台，而不仅仅是收入。 此技能为您的OpenClaw代理提供直接访问您的Ned数据的权限。询问您的代理关于利润、收入、产品性能、客户细分、流失风险、广告效率，并从您的真实数据中获取真实答案。 在https://meetned.com开始免费试用。

设置 用户必须提供他们的Ned API密钥（以ned_live_开头）。存储它：export NED_API_KEY="ned_live_xxxxx" 或每次请求传递。 如果没有可用的密钥，请询问用户。

API 基础 https://api.meetned.com/api/v1 认证：Authorization: Bearer $NED_API_KEY

端点

• 商店信息

GET /api/v1 返回商店名称、级别、可用端点、剩余积分和速率限制。

• 盈利能力摘要

GET /api/v1/profitability/summary?period={period} 返回：total_sales、net_profit、net_margin_pct、total_costs、total_cogs、total_shipping_cost、total_variable_costs、total_fixed_costs、total_ad_spend、contribution_margin、contribution_margin_pct、gross_profit、gross_margin_pct、orders_count、units_sold、avg_profit_per_order、avg_profit_per_unit、total_impressions、total_clicks、ctr、cpc、cogs_coverage。

• 产品盈利能力

GET /api/v1/profitability/products?period={period} 返回：每个产品的细分，包括product_title、revenue、units_sold、total_cogs、total_profit、profit_margin_pct、profit_per_unit、avg_selling_price。

• 客户摘要

GET /api/v1/customers/summary?period={period} 返回：total_customers、avg_customer_profit、avg_customer_ltv、profitable_customer_pct、利润等级（whale/profitable/marginal/unprofitable）、活动等级（active/cooling/at_risk/churned）、top_profitable_customers、at_risk_whales。

• 客户细分

GET /api/v1/customers/segments?period={period} 返回：按利润等级分组的客户，包括完整详细信息（orders、revenue、profit、margin、activity、churn_risk）。

周期值 值 描述 today 当前天（UTC） yesterday 前一天 last_7_days 最后7天 last_30_days 最后30天 last_90_days 最后90天 this_month 当前月 last_month 前一月

使用模式 # 快速利润检查 curl -s -H "Authorization: Bearer $NED_API_KEY" \ "https://api.meetned.com/api/v1/profitability/summary?period=today" # 按利润排名前列的产品 curl -s -H "Authorization: Bearer $NED_API_KEY" \ "https://api.meetned.com/api/v1/profitability/products?period=last_30_days" # 高风险鲸鱼客户 curl -s -H "Authorization: Bearer $NED_API_KEY" \ "https://api.meetned.com/api/v1/customers/summary?period=last_90_days" | jq '.data.at_risk_whales'

查询脚本 为方便起见，使用捆绑的查询脚本： bash scripts/ned-query.sh profitability/summary last_7_days bash scripts/ned-query.sh profitability/products last_30_days bash scripts/ned-query.sh customers/summary last_90_days bash scripts/ned-query.sh customers/segments last_30_days

响应格式 所有端点返回： { "data": { ... }, "metadata": { "source": "database", "period": "last_7_days", "requested_at": "2026-02-10T04:05:05.794Z" } }

速率限制 速率：每60秒窗口100个请求（头部：ratelimit-remaining、ratelimit-reset） 积分：每计划每月限制（头部：x-credits-remaining、x-credits-limit）

提示 Ned以订单和产品级别存储利润 - 每个SKU，每一美元广告费，每一笔退款。 使用profitability/summary进行快速健康检查。 使用profitability/products查找哪些产品在COGS之后真正赚钱。 使用customers/summary查找高风险鲸鱼客户，以免他们流失。 将Ned数据与外部数据（天气、趋势等）结合进行高级分析。 所有货币值均以商店的基础货币表示。