mixpanel-headless

1. 基本信息

项目	内容
名称	mixpanel-headless
作者/维护者	Mixpanel, Inc.（官方 GitHub 组织 `mixpanel`；插件与 SDK 具名作者 Jared McFarland，另有 4 位具名工程师参与提交，含 `dependabot` 自动化依赖更新）
来源链接	https://github.com/mixpanel/mixpanel-headless/tree/main/mixpanel-plugin
许可证	MIT（来自 GitHub API 与仓库根 `LICENSE` 文件、`.claude-plugin/plugin.json` 均声明）
GitHub Stars / Forks	13 / 4（来自 GitHub API，仓库级数字）
最新版本	0.2.0（`plugin.json`；README 标注“Pre-release Software：API 可能在 1.0 前变动”）
安装方式	Claude Code 插件市场：`/plugin marketplace add mixpanel/mixpanel-headless` 后 `/plugin install`；或 `pip install mixpanel-headless` 使用底层 Python SDK

2. 功能介绍与亮点

mixpanel-headless 是 Mixpanel 官方发布的 Agent 技能，让 Claude/Codex 用 Python 代码直接调用 mixpanel_headless SDK 完成 Mixpanel 产品分析，而不是依赖对话式工具调用：

五大查询引擎：query()（趋势/总量）、query_funnel()（漏斗转化）、query_retention()（留存曲线）、query_flow()（路径分析，返回 NetworkX 图与 ASCII 树可视化）、query_user()（用户画像筛选），结果统一为 pandas DataFrame
看板全生命周期管理：dashboard-expert 技能覆盖分析、新建、修改、注解四种模式，内置 9 套设计模板与图表选型指南
模式发现与自助排障：schema_graph() 一次性拉取事件↔属性关系图与字段覆盖率，避免凭猜测写查询；配套 help.py 提供方法签名、类型定义与模糊搜索的实时 API 文档
认证体系完整：支持 Service Account、浏览器 OAuth（PKCE）、静态 Bearer Token 三种模式，mp login 一条命令自动探测环境选择合适路径，并在 Claude Cowork 场景下提供专门的凭据桥接方案

主要亮点：官方出品且完全开源可审计；README 附带完整目录结构、9 类使用场景与逐步安装说明；近 3 天（截至 2026-08-05）仍有代码提交，5 位具名/自动化贡献者持续维护。

3. 适用场景

固定分类：数据分析与可视化。适用于已在使用 Mixpanel 的团队中，需要用 Agent 完成自定义多步骤分析、批量数据处理、看板搭建与用户行为深度探查的数据分析师与工程背景的产品经理——尤其是简单对话式取数无法满足、需要将中间结果留在 Python 变量中做二次加工（如自定义漏斗、跨报表联合分析）的场景。

4. 跨 Agent 兼容性

Agent	结论	依据
Claude Code	✅ 原生支持	README 给出明确的 `/plugin marketplace add` + `/plugin install` 命令，并说明 Claude Cowork 场景下的专用凭据桥接流程
Codex	✅ 原生支持	官方在 `openai/plugins` 仓库同步发布了适配 Codex 的插件版本（`.codex-plugin` 清单），技能内容与本仓库一致
OpenClaw	❓ 未验证	抓取材料未提及
Hermes Agent	❓ 未验证	抓取材料未提及

5. 推荐理由

它把 Mixpanel 的完整查询与实体管理能力封装成可编程的 Python 接口，让 Agent 能像数据分析师一样自己写代码探索数据、做多步骤归因分析，而不是被限制在预设的对话式指令里；官方博客称其可将分析师生产力提升数倍，核心价值在于把资深分析师的方法论（如客户流失分析的多维下钻套路）编码进脚本，供不熟悉 Mixpanel 高级功能的用户复用。

6. 评分

维度	分数	说明
受欢迎程度	7	Mixpanel, Inc. 官方 GitHub 组织发布并在公司博客发文两篇介绍，是官方第一方出品；GitHub 仓库本身 13 stars，未检索到独立于 Mixpanel 官方渠道的第三方评测或社区讨论
可用性	8	文档详尽（README 含目录结构、认证矩阵、9 类调用示例），提供实时 API 文档工具 `help.py`；一条命令通过插件市场安装，需自行准备 Mixpanel 账号凭据；近 3 天仍有提交，维护活跃；README 自述为“Pre-release”，API 在 1.0 版本前可能变动
安全性	9	见下方安全检查清单

安全检查清单：

Shell 命令执行：setup 技能仅执行 setup.sh 安装 pandas、numpy、scipy、networkx 等公认科学计算库，范围明确
联网外发：仅调用 Mixpanel 官方 API（用户自有账号数据），目标透明、属预期内的产品数据访问
凭据：支持 Service Account / OAuth 浏览器 / 静态 Bearer Token 三种路径，setup 技能明确提示“不要把密钥粘贴进对话，写入本地 shell 或凭据存储”，处理方式清晰
可疑指令：逐份审阅 setup、dashboard-expert、mixpanelyst 三份 SKILL.md 正文，未发现隐藏指令、混淆代码或数据外发迹象
作者信誉：GitHub 官方组织 mixpanel，5 位具名/自动化贡献者持续提交，公司博客公开背书
License：MIT，仓库根 LICENSE、pyproject.toml、plugin.json 三处一致声明，明确无歧义
维护时间：最近一次提交 2026-08-04，持续活跃

综合评分：(7+8+9)/3 = 8.0

7. 跟同类 Skills 相比的优势

Skill	定位	与本技能的差异
mixpanel-mcp-mixpanel-ai-plugins（mixpanel/ai-plugins）	Mixpanel 官方出品，通过远程 MCP 端点提供 11 个对话式技能，覆盖看板搭建、A/B 实验统计、Feature Flag 灰度发布、埋点治理全链路	走工具调用（MCP）路线，面向对话式一问一答操作；本技能走代码执行（Python SDK）路线，面向需要自定义多步骤分析、批量处理与会话回放（session replay）解析的场景，官方将两者定位为互补的两种交互模式而非互相替代
hex-openai-plugins（openai/plugins）	面向 Hex.tech 工作区的项目/看板检索技能，通过 App 连接器搜索已有 Hex 项目和 Threads 并转述结果	覆盖的是 Hex 平台自身已保存资产的检索与转述，不直接查询原始事件数据；本技能直接对接 Mixpanel API 做原始事件级别的漏斗、留存、路径分析与自定义计算

8. 用户评价

该技能目前在第三方平台尚无独立于 Mixpanel 官方渠道的具名用户评价。Mixpanel 官方博客一篇署名文章（作者为公司 Principal Solution Engineer）分享了其个人使用体会，属官方渠道内容，不构成独立第三方评价。

9. 其他补充

除核心查询能力外，该技能还提供会话回放解析（发现、抓取、分析 rrweb 格式的用户操作录屏）与“Business Context”读写能力（面向 AI 助手的组织级 Markdown 说明文档，最多 5 万字符），后者用于让 Agent 长期记住团队的业务背景与指标口径。

10. 安装使用方式

Claude Code：

/plugin marketplace add mixpanel/mixpanel-headless
/plugin install mixpanel-headless@mixpanel-headless-marketplace

安装后运行 /mixpanel-headless:setup 完成依赖安装与凭据配置，推荐执行 mp login 自动识别环境完成鉴权；配置完成后可直接用自然语言提问（如“分析上周的注册流失情况”），技能会自动触发并生成 Python 分析代码。

本地开发调试：

claude --plugin-dir /path/to/mixpanel_headless/mixpanel-plugin

独立使用 Python SDK（不依赖插件市场）：

pip install mixpanel-headless
mp login

11. 注意事项

README 明确标注为 Pre-release（1.0 之前）软件，后续版本可能出现 API 变动
需要一个有效的 Mixpanel 账号并完成鉴权后才能实际调用数据类技能；无 Mixpanel 账号的用户无法使用
Codex 生态官方同步提供了适配版本，但 OpenClaw、Hermes Agent 两个生态的兼容性未见官方材料确认，如需在这些平台使用建议先自行验证