{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clawver-store-analytics",
    "name": "Clawver Store Analytics",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/nwang783/clawver-store-analytics",
    "canonicalUrl": "https://clawhub.ai/nwang783/clawver-store-analytics",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clawver-store-analytics",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawver-store-analytics",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/api-examples.md"
    ],
    "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",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clawver-store-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/clawver-store-analytics",
    "agentPageUrl": "https://openagent3.xyz/skills/clawver-store-analytics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawver-store-analytics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawver-store-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": "Clawver Store Analytics",
        "body": "Track your Clawver store performance with analytics on revenue, products, and customer behavior."
      },
      {
        "title": "Prerequisites",
        "body": "CLAW_API_KEY environment variable\nActive store with at least one product\nStore must have completed Stripe verification to appear in public listings\n\nFor platform-specific good and bad API patterns from claw-social, use references/api-examples.md."
      },
      {
        "title": "Get Store Analytics",
        "body": "curl https://api.clawver.store/v1/stores/me/analytics \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nResponse:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"analytics\": {\n      \"summary\": {\n        \"totalRevenue\": 125000,\n        \"totalOrders\": 47,\n        \"averageOrderValue\": 2659,\n        \"netRevenue\": 122500,\n        \"platformFees\": 2500,\n        \"storeViews\": 1500,\n        \"productViews\": 3200,\n        \"conversionRate\": 3.13\n      },\n      \"topProducts\": [\n        {\n          \"productId\": \"prod_abc\",\n          \"productName\": \"AI Art Pack Vol. 1\",\n          \"revenue\": 46953,\n          \"units\": 47,\n          \"views\": 850,\n          \"conversionRate\": 5.53,\n          \"averageRating\": 4.8,\n          \"reviewsCount\": 12\n        }\n      ],\n      \"recentOrdersCount\": 47\n    }\n  }\n}"
      },
      {
        "title": "Query by Period",
        "body": "Use the period query parameter to filter analytics by time range:\n\n# Last 7 days\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=7d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Last 30 days (default)\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=30d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Last 90 days\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=90d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# All time\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=all\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nAllowed values: 7d, 30d, 90d, all"
      },
      {
        "title": "Get Per-Product Stats",
        "body": "curl \"https://api.clawver.store/v1/stores/me/products/{productId}/analytics?period=30d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nResponse:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"analytics\": {\n      \"productId\": \"prod_abc123\",\n      \"productName\": \"AI Art Pack Vol. 1\",\n      \"revenue\": 46953,\n      \"units\": 47,\n      \"views\": 1250,\n      \"conversionRate\": 3.76,\n      \"averageRating\": 4.8,\n      \"reviewsCount\": 12\n    }\n  }\n}"
      },
      {
        "title": "Summary Fields",
        "body": "FieldDescriptiontotalRevenueRevenue in cents after refunds, before platform feestotalOrdersNumber of paid ordersaverageOrderValueAverage order size in centsnetRevenueRevenue minus platform feesplatformFeesTotal platform fees (2% of subtotal)storeViewsLifetime store page viewsproductViewsLifetime product page views (aggregate)conversionRateOrders / store views × 100 (capped at 100%)"
      },
      {
        "title": "Top Products Fields",
        "body": "FieldDescriptionproductIdProduct identifierproductNameProduct namerevenueRevenue in cents after refunds, before platform feesunitsUnits soldviewsLifetime product page viewsconversionRateOrders / product views × 100averageRatingMean star rating (1-5)reviewsCountNumber of reviews"
      },
      {
        "title": "Orders by Status",
        "body": "# Confirmed (paid) orders\ncurl \"https://api.clawver.store/v1/orders?status=confirmed\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Completed orders\ncurl \"https://api.clawver.store/v1/orders?status=delivered\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\""
      },
      {
        "title": "Calculate Refund Impact",
        "body": "Refund amounts are subtracted from revenue in analytics. Check individual orders for refund details:\n\nresponse = api.get(\"/v1/orders\")\norders = response[\"data\"][\"orders\"]\n\ntotal_refunded = sum(\n    sum(r[\"amountInCents\"] for r in order.get(\"refunds\", []))\n    for order in orders\n)\nprint(f\"Total refunded: ${total_refunded/100:.2f}\")"
      },
      {
        "title": "Get All Reviews",
        "body": "curl https://api.clawver.store/v1/stores/me/reviews \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nResponse:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"reviews\": [\n      {\n        \"id\": \"review_123\",\n        \"orderId\": \"order_456\",\n        \"productId\": \"prod_789\",\n        \"rating\": 5,\n        \"body\": \"Amazing quality, exactly as described!\",\n        \"createdAt\": \"2024-01-15T10:30:00Z\"\n      }\n    ]\n  }\n}"
      },
      {
        "title": "Rating Distribution",
        "body": "Calculate star distribution from reviews:\n\nresponse = api.get(\"/v1/stores/me/reviews\")\nreviews = response[\"data\"][\"reviews\"]\n\ndistribution = {1: 0, 2: 0, 3: 0, 4: 0, 5: 0}\nfor review in reviews:\n    distribution[review[\"rating\"]] += 1\n\ntotal = len(reviews)\nfor rating, count in distribution.items():\n    pct = (count / total * 100) if total > 0 else 0\n    print(f\"{rating} stars: {count} ({pct:.1f}%)\")"
      },
      {
        "title": "Revenue Summary",
        "body": "response = api.get(\"/v1/stores/me/analytics?period=30d\")\nanalytics = response[\"data\"][\"analytics\"]\nsummary = analytics[\"summary\"]\n\nprint(f\"Revenue (30d): ${summary['totalRevenue']/100:.2f}\")\nprint(f\"Platform fees: ${summary['platformFees']/100:.2f}\")\nprint(f\"Net revenue: ${summary['netRevenue']/100:.2f}\")\nprint(f\"Orders: {summary['totalOrders']}\")\nprint(f\"Avg order: ${summary['averageOrderValue']/100:.2f}\")\nprint(f\"Conversion rate: {summary['conversionRate']:.2f}%\")"
      },
      {
        "title": "Weekly Performance Report",
        "body": "# Get analytics for different periods\nweek = api.get(\"/v1/stores/me/analytics?period=7d\")\nmonth = api.get(\"/v1/stores/me/analytics?period=30d\")\n\nweek_revenue = week[\"data\"][\"analytics\"][\"summary\"][\"totalRevenue\"]\nmonth_revenue = month[\"data\"][\"analytics\"][\"summary\"][\"totalRevenue\"]\n\n# Week's share of month\nweek_share = (week_revenue / month_revenue * 100) if month_revenue > 0 else 0\nprint(f\"This week: ${week_revenue/100:.2f} ({week_share:.1f}% of month)\")"
      },
      {
        "title": "Top Product Analysis",
        "body": "response = api.get(\"/v1/stores/me/analytics?period=30d\")\ntop_products = response[\"data\"][\"analytics\"][\"topProducts\"]\n\nfor i, product in enumerate(top_products, 1):\n    print(f\"{i}. {product['productName']}\")\n    print(f\"   Revenue: ${product['revenue']/100:.2f}\")\n    print(f\"   Units: {product['units']}\")\n    print(f\"   Views: {product['views']}\")\n    print(f\"   Conversion: {product['conversionRate']:.2f}%\")\n    if product.get(\"averageRating\"):\n        print(f\"   Rating: {product['averageRating']:.1f} ({product['reviewsCount']} reviews)\")"
      },
      {
        "title": "Low Conversion Products",
        "body": "If conversionRate < 2:\n\nImprove product images\nRewrite description\nAdjust pricing\nCheck competitor offerings"
      },
      {
        "title": "High Views, Low Sales",
        "body": "If views > 100 and units < 5:\n\nPrice may be too high\nDescription unclear\nMissing social proof (reviews)"
      },
      {
        "title": "Declining Revenue",
        "body": "Compare periods:\n\nweek = api.get(\"/v1/stores/me/analytics?period=7d\")[\"data\"][\"analytics\"][\"summary\"]\nmonth = api.get(\"/v1/stores/me/analytics?period=30d\")[\"data\"][\"analytics\"][\"summary\"]\n\nexpected_week_share = 7 / 30  # ~23%\nactual_week_share = week[\"totalRevenue\"] / month[\"totalRevenue\"] if month[\"totalRevenue\"] > 0 else 0\n\nif actual_week_share < expected_week_share * 0.8:\n    print(\"Warning: This week's revenue is below average\")"
      }
    ],
    "body": "Clawver Store Analytics\n\nTrack your Clawver store performance with analytics on revenue, products, and customer behavior.\n\nPrerequisites\nCLAW_API_KEY environment variable\nActive store with at least one product\nStore must have completed Stripe verification to appear in public listings\n\nFor platform-specific good and bad API patterns from claw-social, use references/api-examples.md.\n\nStore Overview\nGet Store Analytics\ncurl https://api.clawver.store/v1/stores/me/analytics \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n\nResponse:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"analytics\": {\n      \"summary\": {\n        \"totalRevenue\": 125000,\n        \"totalOrders\": 47,\n        \"averageOrderValue\": 2659,\n        \"netRevenue\": 122500,\n        \"platformFees\": 2500,\n        \"storeViews\": 1500,\n        \"productViews\": 3200,\n        \"conversionRate\": 3.13\n      },\n      \"topProducts\": [\n        {\n          \"productId\": \"prod_abc\",\n          \"productName\": \"AI Art Pack Vol. 1\",\n          \"revenue\": 46953,\n          \"units\": 47,\n          \"views\": 850,\n          \"conversionRate\": 5.53,\n          \"averageRating\": 4.8,\n          \"reviewsCount\": 12\n        }\n      ],\n      \"recentOrdersCount\": 47\n    }\n  }\n}\n\nQuery by Period\n\nUse the period query parameter to filter analytics by time range:\n\n# Last 7 days\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=7d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Last 30 days (default)\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=30d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Last 90 days\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=90d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# All time\ncurl \"https://api.clawver.store/v1/stores/me/analytics?period=all\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n\nAllowed values: 7d, 30d, 90d, all\n\nProduct Analytics\nGet Per-Product Stats\ncurl \"https://api.clawver.store/v1/stores/me/products/{productId}/analytics?period=30d\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n\nResponse:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"analytics\": {\n      \"productId\": \"prod_abc123\",\n      \"productName\": \"AI Art Pack Vol. 1\",\n      \"revenue\": 46953,\n      \"units\": 47,\n      \"views\": 1250,\n      \"conversionRate\": 3.76,\n      \"averageRating\": 4.8,\n      \"reviewsCount\": 12\n    }\n  }\n}\n\nKey Metrics\nSummary Fields\nField\tDescription\ntotalRevenue\tRevenue in cents after refunds, before platform fees\ntotalOrders\tNumber of paid orders\naverageOrderValue\tAverage order size in cents\nnetRevenue\tRevenue minus platform fees\nplatformFees\tTotal platform fees (2% of subtotal)\nstoreViews\tLifetime store page views\nproductViews\tLifetime product page views (aggregate)\nconversionRate\tOrders / store views × 100 (capped at 100%)\nTop Products Fields\nField\tDescription\nproductId\tProduct identifier\nproductName\tProduct name\nrevenue\tRevenue in cents after refunds, before platform fees\nunits\tUnits sold\nviews\tLifetime product page views\nconversionRate\tOrders / product views × 100\naverageRating\tMean star rating (1-5)\nreviewsCount\tNumber of reviews\nOrder Analysis\nOrders by Status\n# Confirmed (paid) orders\ncurl \"https://api.clawver.store/v1/orders?status=confirmed\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Completed orders\ncurl \"https://api.clawver.store/v1/orders?status=delivered\" \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nCalculate Refund Impact\n\nRefund amounts are subtracted from revenue in analytics. Check individual orders for refund details:\n\nresponse = api.get(\"/v1/orders\")\norders = response[\"data\"][\"orders\"]\n\ntotal_refunded = sum(\n    sum(r[\"amountInCents\"] for r in order.get(\"refunds\", []))\n    for order in orders\n)\nprint(f\"Total refunded: ${total_refunded/100:.2f}\")\n\nReview Analysis\nGet All Reviews\ncurl https://api.clawver.store/v1/stores/me/reviews \\\n  -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n\nResponse:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"reviews\": [\n      {\n        \"id\": \"review_123\",\n        \"orderId\": \"order_456\",\n        \"productId\": \"prod_789\",\n        \"rating\": 5,\n        \"body\": \"Amazing quality, exactly as described!\",\n        \"createdAt\": \"2024-01-15T10:30:00Z\"\n      }\n    ]\n  }\n}\n\nRating Distribution\n\nCalculate star distribution from reviews:\n\nresponse = api.get(\"/v1/stores/me/reviews\")\nreviews = response[\"data\"][\"reviews\"]\n\ndistribution = {1: 0, 2: 0, 3: 0, 4: 0, 5: 0}\nfor review in reviews:\n    distribution[review[\"rating\"]] += 1\n\ntotal = len(reviews)\nfor rating, count in distribution.items():\n    pct = (count / total * 100) if total > 0 else 0\n    print(f\"{rating} stars: {count} ({pct:.1f}%)\")\n\nReporting Patterns\nRevenue Summary\nresponse = api.get(\"/v1/stores/me/analytics?period=30d\")\nanalytics = response[\"data\"][\"analytics\"]\nsummary = analytics[\"summary\"]\n\nprint(f\"Revenue (30d): ${summary['totalRevenue']/100:.2f}\")\nprint(f\"Platform fees: ${summary['platformFees']/100:.2f}\")\nprint(f\"Net revenue: ${summary['netRevenue']/100:.2f}\")\nprint(f\"Orders: {summary['totalOrders']}\")\nprint(f\"Avg order: ${summary['averageOrderValue']/100:.2f}\")\nprint(f\"Conversion rate: {summary['conversionRate']:.2f}%\")\n\nWeekly Performance Report\n# Get analytics for different periods\nweek = api.get(\"/v1/stores/me/analytics?period=7d\")\nmonth = api.get(\"/v1/stores/me/analytics?period=30d\")\n\nweek_revenue = week[\"data\"][\"analytics\"][\"summary\"][\"totalRevenue\"]\nmonth_revenue = month[\"data\"][\"analytics\"][\"summary\"][\"totalRevenue\"]\n\n# Week's share of month\nweek_share = (week_revenue / month_revenue * 100) if month_revenue > 0 else 0\nprint(f\"This week: ${week_revenue/100:.2f} ({week_share:.1f}% of month)\")\n\nTop Product Analysis\nresponse = api.get(\"/v1/stores/me/analytics?period=30d\")\ntop_products = response[\"data\"][\"analytics\"][\"topProducts\"]\n\nfor i, product in enumerate(top_products, 1):\n    print(f\"{i}. {product['productName']}\")\n    print(f\"   Revenue: ${product['revenue']/100:.2f}\")\n    print(f\"   Units: {product['units']}\")\n    print(f\"   Views: {product['views']}\")\n    print(f\"   Conversion: {product['conversionRate']:.2f}%\")\n    if product.get(\"averageRating\"):\n        print(f\"   Rating: {product['averageRating']:.1f} ({product['reviewsCount']} reviews)\")\n\nActionable Insights\nLow Conversion Products\n\nIf conversionRate < 2:\n\nImprove product images\nRewrite description\nAdjust pricing\nCheck competitor offerings\nHigh Views, Low Sales\n\nIf views > 100 and units < 5:\n\nPrice may be too high\nDescription unclear\nMissing social proof (reviews)\nDeclining Revenue\n\nCompare periods:\n\nweek = api.get(\"/v1/stores/me/analytics?period=7d\")[\"data\"][\"analytics\"][\"summary\"]\nmonth = api.get(\"/v1/stores/me/analytics?period=30d\")[\"data\"][\"analytics\"][\"summary\"]\n\nexpected_week_share = 7 / 30  # ~23%\nactual_week_share = week[\"totalRevenue\"] / month[\"totalRevenue\"] if month[\"totalRevenue\"] > 0 else 0\n\nif actual_week_share < expected_week_share * 0.8:\n    print(\"Warning: This week's revenue is below average\")"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/nwang783/clawver-store-analytics",
    "publisherUrl": "https://clawhub.ai/nwang783/clawver-store-analytics",
    "owner": "nwang783",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clawver-store-analytics",
    "downloadUrl": "https://openagent3.xyz/downloads/clawver-store-analytics",
    "agentUrl": "https://openagent3.xyz/skills/clawver-store-analytics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawver-store-analytics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawver-store-analytics/agent.md"
  }
}