{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mixpanel",
    "name": "Mixpanel",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/mixpanel",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/mixpanel",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/mixpanel",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mixpanel",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "memory-template.md",
      "setup.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-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/mixpanel"
    },
    "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/mixpanel",
    "agentPageUrl": "https://openagent3.xyz/skills/mixpanel/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mixpanel/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mixpanel/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": "Setup",
        "body": "On first use, read setup.md for integration guidelines."
      },
      {
        "title": "When to Use",
        "body": "User needs product analytics from Mixpanel. Agent handles event queries, funnel analysis, retention cohorts, user segmentation, and profile lookups."
      },
      {
        "title": "Architecture",
        "body": "Memory lives in ~/mixpanel/. See memory-template.md for structure.\n\n~/mixpanel/\n├── memory.md        # Projects, saved queries, insights\n└── queries/         # Saved JQL queries"
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileSetup processsetup.mdMemory templatememory-template.md"
      },
      {
        "title": "1. Authentication",
        "body": "Requires a Mixpanel Service Account:\n\nexport MP_SERVICE_ACCOUNT=\"your-service-account\"\nexport MP_SERVICE_SECRET=\"your-service-secret\"\nexport MP_PROJECT_ID=\"123456\"\n\nCreate a service account in Mixpanel → Organization Settings → Service Accounts."
      },
      {
        "title": "2. Query API for Analysis",
        "body": "Use the Query API for insights, funnels, retention:\n\nBASE=\"https://mixpanel.com/api/query\"\nAUTH=$(echo -n \"$MP_SERVICE_ACCOUNT:$MP_SERVICE_SECRET\" | base64)\n\n# Insights query (event counts)\ncurl -s \"$BASE/insights?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"params\": {\n      \"event\": [\"Sign Up\", \"Purchase\"],\n      \"type\": \"general\",\n      \"unit\": \"day\",\n      \"from_date\": \"2024-01-01\",\n      \"to_date\": \"2024-01-31\"\n    }\n  }' | jq"
      },
      {
        "title": "3. Funnel Analysis",
        "body": "curl -s \"$BASE/funnels?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"params\": {\n      \"events\": [\n        {\"event\": \"Sign Up\"},\n        {\"event\": \"Complete Onboarding\"},\n        {\"event\": \"First Purchase\"}\n      ],\n      \"from_date\": \"2024-01-01\",\n      \"to_date\": \"2024-01-31\",\n      \"unit\": \"day\"\n    }\n  }' | jq '.data.meta.overall'"
      },
      {
        "title": "4. Retention Cohorts",
        "body": "curl -s \"$BASE/retention?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"params\": {\n      \"born_event\": \"Sign Up\",\n      \"event\": \"App Open\",\n      \"from_date\": \"2024-01-01\",\n      \"to_date\": \"2024-01-31\",\n      \"unit\": \"week\",\n      \"retention_type\": \"birth\"\n    }\n  }' | jq"
      },
      {
        "title": "5. User Profiles",
        "body": "curl -s \"https://mixpanel.com/api/query/engage?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filter_by_cohort\": {\"id\": 12345},\n    \"output_properties\": [\"$email\", \"$name\", \"plan\"]\n  }' | jq"
      },
      {
        "title": "6. Export Raw Events",
        "body": "curl -s \"https://data.mixpanel.com/api/2.0/export?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -d \"from_date=2024-01-01\" \\\n  -d \"to_date=2024-01-07\" \\\n  -d \"event=[\\\"Purchase\\\"]\""
      },
      {
        "title": "7. JQL for Complex Queries",
        "body": "// Mixpanel JQL (JavaScript Query Language)\nfunction main() {\n  return Events({\n    from_date: \"2024-01-01\",\n    to_date: \"2024-01-31\",\n    event_selectors: [{event: \"Purchase\"}]\n  })\n  .groupByUser([\"properties.$city\"], mixpanel.reducer.sum(\"properties.amount\"))\n  .groupBy([\"key.$city\"], mixpanel.reducer.avg(\"value\"))\n  .sortDesc(\"value\")\n  .take(10);\n}"
      },
      {
        "title": "Common Queries",
        "body": "GoalEndpointKey ParamsEvent counts/insightsevent, type, unit, datesConversion funnel/funnelsevents array, datesUser retention/retentionborn_event, event, unitUser segments/engagefilter_by_cohort, propertiesRaw event export/exportdates, event filter"
      },
      {
        "title": "Mixpanel Traps",
        "body": "Wrong date format → use YYYY-MM-DD, not timestamps\nMissing project_id → every Query API call needs it\nRate limits → 60 requests/hour for free tier, batch queries when possible\nJQL timeouts → queries over 60s fail, add .take(N) to limit results"
      },
      {
        "title": "External Endpoints",
        "body": "EndpointData SentPurposemixpanel.com/api/query/*Credentials, project ID, query paramsAnalytics queriesdata.mixpanel.com/api/2.0/*Credentials, project ID, date rangeRaw data export\n\nNo other data is sent externally."
      },
      {
        "title": "Security & Privacy",
        "body": "Data sent to Mixpanel (over HTTPS):\n\nService account credentials for authentication\nQuery parameters (event names, date ranges, filters)\nProject ID\n\nData that stays local:\n\nCredentials stored ONLY in environment variables\nQuery results cached in ~/mixpanel/\n\nThis skill does NOT:\n\nStore credentials in memory.md or any file\nSend data to services other than mixpanel.com\nModify your Mixpanel tracking code or SDK"
      },
      {
        "title": "Trust",
        "body": "By using this skill, analytics data is queried from Mixpanel.\nOnly install if you trust Mixpanel with your product data."
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\nanalytics — multi-platform analytics\ndata-analysis — data processing patterns\napi — REST API best practices"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star mixpanel\nStay updated: clawhub sync"
      }
    ],
    "body": "Setup\n\nOn first use, read setup.md for integration guidelines.\n\nWhen to Use\n\nUser needs product analytics from Mixpanel. Agent handles event queries, funnel analysis, retention cohorts, user segmentation, and profile lookups.\n\nArchitecture\n\nMemory lives in ~/mixpanel/. See memory-template.md for structure.\n\n~/mixpanel/\n├── memory.md        # Projects, saved queries, insights\n└── queries/         # Saved JQL queries\n\nQuick Reference\nTopic\tFile\nSetup process\tsetup.md\nMemory template\tmemory-template.md\nCore Rules\n1. Authentication\n\nRequires a Mixpanel Service Account:\n\nexport MP_SERVICE_ACCOUNT=\"your-service-account\"\nexport MP_SERVICE_SECRET=\"your-service-secret\"\nexport MP_PROJECT_ID=\"123456\"\n\n\nCreate a service account in Mixpanel → Organization Settings → Service Accounts.\n\n2. Query API for Analysis\n\nUse the Query API for insights, funnels, retention:\n\nBASE=\"https://mixpanel.com/api/query\"\nAUTH=$(echo -n \"$MP_SERVICE_ACCOUNT:$MP_SERVICE_SECRET\" | base64)\n\n# Insights query (event counts)\ncurl -s \"$BASE/insights?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"params\": {\n      \"event\": [\"Sign Up\", \"Purchase\"],\n      \"type\": \"general\",\n      \"unit\": \"day\",\n      \"from_date\": \"2024-01-01\",\n      \"to_date\": \"2024-01-31\"\n    }\n  }' | jq\n\n3. Funnel Analysis\ncurl -s \"$BASE/funnels?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"params\": {\n      \"events\": [\n        {\"event\": \"Sign Up\"},\n        {\"event\": \"Complete Onboarding\"},\n        {\"event\": \"First Purchase\"}\n      ],\n      \"from_date\": \"2024-01-01\",\n      \"to_date\": \"2024-01-31\",\n      \"unit\": \"day\"\n    }\n  }' | jq '.data.meta.overall'\n\n4. Retention Cohorts\ncurl -s \"$BASE/retention?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"params\": {\n      \"born_event\": \"Sign Up\",\n      \"event\": \"App Open\",\n      \"from_date\": \"2024-01-01\",\n      \"to_date\": \"2024-01-31\",\n      \"unit\": \"week\",\n      \"retention_type\": \"birth\"\n    }\n  }' | jq\n\n5. User Profiles\ncurl -s \"https://mixpanel.com/api/query/engage?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filter_by_cohort\": {\"id\": 12345},\n    \"output_properties\": [\"$email\", \"$name\", \"plan\"]\n  }' | jq\n\n6. Export Raw Events\ncurl -s \"https://data.mixpanel.com/api/2.0/export?project_id=$MP_PROJECT_ID\" \\\n  -H \"Authorization: Basic $AUTH\" \\\n  -d \"from_date=2024-01-01\" \\\n  -d \"to_date=2024-01-07\" \\\n  -d \"event=[\\\"Purchase\\\"]\"\n\n7. JQL for Complex Queries\n// Mixpanel JQL (JavaScript Query Language)\nfunction main() {\n  return Events({\n    from_date: \"2024-01-01\",\n    to_date: \"2024-01-31\",\n    event_selectors: [{event: \"Purchase\"}]\n  })\n  .groupByUser([\"properties.$city\"], mixpanel.reducer.sum(\"properties.amount\"))\n  .groupBy([\"key.$city\"], mixpanel.reducer.avg(\"value\"))\n  .sortDesc(\"value\")\n  .take(10);\n}\n\nCommon Queries\nGoal\tEndpoint\tKey Params\nEvent counts\t/insights\tevent, type, unit, dates\nConversion funnel\t/funnels\tevents array, dates\nUser retention\t/retention\tborn_event, event, unit\nUser segments\t/engage\tfilter_by_cohort, properties\nRaw event export\t/export\tdates, event filter\nMixpanel Traps\nWrong date format → use YYYY-MM-DD, not timestamps\nMissing project_id → every Query API call needs it\nRate limits → 60 requests/hour for free tier, batch queries when possible\nJQL timeouts → queries over 60s fail, add .take(N) to limit results\nExternal Endpoints\nEndpoint\tData Sent\tPurpose\nmixpanel.com/api/query/*\tCredentials, project ID, query params\tAnalytics queries\ndata.mixpanel.com/api/2.0/*\tCredentials, project ID, date range\tRaw data export\n\nNo other data is sent externally.\n\nSecurity & Privacy\n\nData sent to Mixpanel (over HTTPS):\n\nService account credentials for authentication\nQuery parameters (event names, date ranges, filters)\nProject ID\n\nData that stays local:\n\nCredentials stored ONLY in environment variables\nQuery results cached in ~/mixpanel/\n\nThis skill does NOT:\n\nStore credentials in memory.md or any file\nSend data to services other than mixpanel.com\nModify your Mixpanel tracking code or SDK\nTrust\n\nBy using this skill, analytics data is queried from Mixpanel. Only install if you trust Mixpanel with your product data.\n\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\nanalytics — multi-platform analytics\ndata-analysis — data processing patterns\napi — REST API best practices\nFeedback\nIf useful: clawhub star mixpanel\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/mixpanel",
    "publisherUrl": "https://clawhub.ai/ivangdavila/mixpanel",
    "owner": "ivangdavila",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mixpanel",
    "downloadUrl": "https://openagent3.xyz/downloads/mixpanel",
    "agentUrl": "https://openagent3.xyz/skills/mixpanel/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mixpanel/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mixpanel/agent.md"
  }
}