{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ned-analytics",
    "name": "Ned - Shopify Profit Analytics AI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/matt998759/ned-analytics",
    "canonicalUrl": "https://clawhub.ai/matt998759/ned-analytics",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/ned-analytics",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ned-analytics",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/ned-query.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "ned-analytics",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T01:44:46.222Z",
      "expiresAt": "2026-05-13T01:44:46.222Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ned-analytics",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ned-analytics",
        "contentDisposition": "attachment; filename=\"ned-analytics-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ned-analytics"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ned-analytics"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/ned-analytics",
    "agentPageUrl": "https://openagent3.xyz/skills/ned-analytics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ned-analytics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ned-analytics/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Ned Analytics",
        "body": "Ned (meetned.com) is an AI business partner for Shopify merchants. It connects your Shopify store, Meta Ads, Google Ads, Klaviyo, 3PL providers, and cost data into a single data warehouse — then lets you query it all through AI chat, a visual dashboard, a public API, a TypeScript SDK, or this skill.\n\nNed stores profit down to the order and product level. Every SKU, every ad dollar, every return. It's the only platform that gives you a complete picture of true profitability — not just revenue.\n\nThis skill gives your OpenClaw agent direct access to your Ned data. Ask your agent about profit, revenue, product performance, customer segments, churn risk, ad efficiency — and get real answers from your real numbers.\n\nStart a free trial at https://meetned.com"
      },
      {
        "title": "Setup",
        "body": "The user must provide their Ned API key (starts with ned_live_). Store it:\n\nexport NED_API_KEY=\"ned_live_xxxxx\"\n\nOr pass it per-request. If no key is available, ask the user for it."
      },
      {
        "title": "API Base",
        "body": "https://api.meetned.com/api/v1\n\nAuth: Authorization: Bearer $NED_API_KEY"
      },
      {
        "title": "1. Store Info",
        "body": "GET /api/v1\n\nReturns store name, tier, available endpoints, remaining credits and rate limits."
      },
      {
        "title": "2. Profitability Summary",
        "body": "GET /api/v1/profitability/summary?period={period}\n\nReturns: 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."
      },
      {
        "title": "3. Product Profitability",
        "body": "GET /api/v1/profitability/products?period={period}\n\nReturns: per-product breakdown with product_title, revenue, units_sold, total_cogs, total_profit, profit_margin_pct, profit_per_unit, avg_selling_price."
      },
      {
        "title": "4. Customer Summary",
        "body": "GET /api/v1/customers/summary?period={period}\n\nReturns: total_customers, avg_customer_profit, avg_customer_ltv, profitable_customer_pct, profit tiers (whale/profitable/marginal/unprofitable), activity tiers (active/cooling/at_risk/churned), top_profitable_customers, at_risk_whales."
      },
      {
        "title": "5. Customer Segments",
        "body": "GET /api/v1/customers/segments?period={period}\n\nReturns: customers grouped by profit_tier with full detail (orders, revenue, profit, margin, activity, churn_risk)."
      },
      {
        "title": "Period Values",
        "body": "ValueDescriptiontodayCurrent day (UTC)yesterdayPrevious daylast_7_daysLast 7 dayslast_30_daysLast 30 dayslast_90_daysLast 90 daysthis_monthCurrent monthlast_monthPrevious month"
      },
      {
        "title": "Usage Pattern",
        "body": "# Quick profit check\ncurl -s -H \"Authorization: Bearer $NED_API_KEY\" \\\n  \"https://api.meetned.com/api/v1/profitability/summary?period=today\"\n\n# Top products by profit\ncurl -s -H \"Authorization: Bearer $NED_API_KEY\" \\\n  \"https://api.meetned.com/api/v1/profitability/products?period=last_30_days\"\n\n# At-risk whale customers\ncurl -s -H \"Authorization: Bearer $NED_API_KEY\" \\\n  \"https://api.meetned.com/api/v1/customers/summary?period=last_90_days\" | jq '.data.at_risk_whales'"
      },
      {
        "title": "Query Script",
        "body": "For convenience, use the bundled query script:\n\nbash scripts/ned-query.sh profitability/summary last_7_days\nbash scripts/ned-query.sh profitability/products last_30_days\nbash scripts/ned-query.sh customers/summary last_90_days\nbash scripts/ned-query.sh customers/segments last_30_days"
      },
      {
        "title": "Response Format",
        "body": "All endpoints return:\n\n{\n  \"data\": { ... },\n  \"metadata\": {\n    \"source\": \"database\",\n    \"period\": \"last_7_days\",\n    \"requested_at\": \"2026-02-10T04:05:05.794Z\"\n  }\n}"
      },
      {
        "title": "Rate Limits",
        "body": "Rate: 100 requests per 60-second window (headers: ratelimit-remaining, ratelimit-reset)\nCredits: per-plan monthly limit (headers: x-credits-remaining, x-credits-limit)"
      },
      {
        "title": "Tips",
        "body": "Ned stores profit down to the order and product level — every SKU, every ad dollar, every return\nUse profitability/summary for quick health checks\nUse profitability/products to find which products actually make money after COGS\nUse customers/summary to find at-risk whales before they churn\nCombine Ned data with external data (weather, trends, etc.) for advanced analysis\nAll monetary values are in the store's base currency"
      }
    ],
    "body": "Ned Analytics\n\nNed (meetned.com) is an AI business partner for Shopify merchants. It connects your Shopify store, Meta Ads, Google Ads, Klaviyo, 3PL providers, and cost data into a single data warehouse — then lets you query it all through AI chat, a visual dashboard, a public API, a TypeScript SDK, or this skill.\n\nNed stores profit down to the order and product level. Every SKU, every ad dollar, every return. It's the only platform that gives you a complete picture of true profitability — not just revenue.\n\nThis skill gives your OpenClaw agent direct access to your Ned data. Ask your agent about profit, revenue, product performance, customer segments, churn risk, ad efficiency — and get real answers from your real numbers.\n\nStart a free trial at https://meetned.com\n\nSetup\n\nThe user must provide their Ned API key (starts with ned_live_). Store it:\n\nexport NED_API_KEY=\"ned_live_xxxxx\"\n\n\nOr pass it per-request. If no key is available, ask the user for it.\n\nAPI Base\nhttps://api.meetned.com/api/v1\n\n\nAuth: Authorization: Bearer $NED_API_KEY\n\nEndpoints\n1. Store Info\nGET /api/v1\n\n\nReturns store name, tier, available endpoints, remaining credits and rate limits.\n\n2. Profitability Summary\nGET /api/v1/profitability/summary?period={period}\n\n\nReturns: 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.\n\n3. Product Profitability\nGET /api/v1/profitability/products?period={period}\n\n\nReturns: per-product breakdown with product_title, revenue, units_sold, total_cogs, total_profit, profit_margin_pct, profit_per_unit, avg_selling_price.\n\n4. Customer Summary\nGET /api/v1/customers/summary?period={period}\n\n\nReturns: total_customers, avg_customer_profit, avg_customer_ltv, profitable_customer_pct, profit tiers (whale/profitable/marginal/unprofitable), activity tiers (active/cooling/at_risk/churned), top_profitable_customers, at_risk_whales.\n\n5. Customer Segments\nGET /api/v1/customers/segments?period={period}\n\n\nReturns: customers grouped by profit_tier with full detail (orders, revenue, profit, margin, activity, churn_risk).\n\nPeriod Values\nValue\tDescription\ntoday\tCurrent day (UTC)\nyesterday\tPrevious day\nlast_7_days\tLast 7 days\nlast_30_days\tLast 30 days\nlast_90_days\tLast 90 days\nthis_month\tCurrent month\nlast_month\tPrevious month\nUsage Pattern\n# Quick profit check\ncurl -s -H \"Authorization: Bearer $NED_API_KEY\" \\\n  \"https://api.meetned.com/api/v1/profitability/summary?period=today\"\n\n# Top products by profit\ncurl -s -H \"Authorization: Bearer $NED_API_KEY\" \\\n  \"https://api.meetned.com/api/v1/profitability/products?period=last_30_days\"\n\n# At-risk whale customers\ncurl -s -H \"Authorization: Bearer $NED_API_KEY\" \\\n  \"https://api.meetned.com/api/v1/customers/summary?period=last_90_days\" | jq '.data.at_risk_whales'\n\nQuery Script\n\nFor convenience, use the bundled query script:\n\nbash scripts/ned-query.sh profitability/summary last_7_days\nbash scripts/ned-query.sh profitability/products last_30_days\nbash scripts/ned-query.sh customers/summary last_90_days\nbash scripts/ned-query.sh customers/segments last_30_days\n\nResponse Format\n\nAll endpoints return:\n\n{\n  \"data\": { ... },\n  \"metadata\": {\n    \"source\": \"database\",\n    \"period\": \"last_7_days\",\n    \"requested_at\": \"2026-02-10T04:05:05.794Z\"\n  }\n}\n\nRate Limits\nRate: 100 requests per 60-second window (headers: ratelimit-remaining, ratelimit-reset)\nCredits: per-plan monthly limit (headers: x-credits-remaining, x-credits-limit)\nTips\nNed stores profit down to the order and product level — every SKU, every ad dollar, every return\nUse profitability/summary for quick health checks\nUse profitability/products to find which products actually make money after COGS\nUse customers/summary to find at-risk whales before they churn\nCombine Ned data with external data (weather, trends, etc.) for advanced analysis\nAll monetary values are in the store's base currency"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/matt998759/ned-analytics",
    "publisherUrl": "https://clawhub.ai/matt998759/ned-analytics",
    "owner": "matt998759",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ned-analytics",
    "downloadUrl": "https://openagent3.xyz/downloads/ned-analytics",
    "agentUrl": "https://openagent3.xyz/skills/ned-analytics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ned-analytics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ned-analytics/agent.md"
  }
}