mixpanel-headless — плагин для Codex: что делает и как установить
Плагин даёт агенту доступ к Mixpanel через Python SDK для расчёта воронок, когортного удержания и визуализации данных.
Открыть на GitHubЧто делает mixpanel-headless
В отличие от plugins/mixpanel, работающего через готовый коннектор сервиса, mixpanel-headless рассчитан на сценарии написания кода. Codex устанавливает локальный SDK mixpanel_headless, пишет скрипты на Python с использованием pandas и библиотек построения графиков, а также объединяет события аналитики с локальными файлами.
В плагин входят четыре скилла. mixpanel-headless-setup разворачивает библиотеку с аналитическими зависимостями, а mixpanel-auth управляет сессиями и переключением проектов. Анализ данных выполняет mixpanelyst: он читает схемы событий, строит сегментацию, воронки, retention и пути пользователей. Для управления отчётами предназначен скилл dashboard-expert.
Для неинтерактивного режима нужны переменные MP_OAUTH_TOKEN, MP_PROJECT_ID и MP_REGION. Секреты нельзя отправлять в чат — задавайте их в локальном шелле или хранилище учётных данных.
Какие задачи решает
- построить воронку конверсий по событиям Mixpanel в Python
- рассчитать сегментацию и удержание пользователей в скрипте с pandas
- создать или изменить дашборд Mixpanel через агента
- объединить аналитику Mixpanel с локальными файлами данных
Примеры запросов агенту
- Установи mixpanel_headless и проверь авторизацию через
mixpanel-headless-setup. - Проанализируй отток на шаге регистрации в Mixpanel с помощью Python.
- Покажи схему событий и рассчитай воронку оформления заказа.
Вопросы о mixpanel-headless
Как установить mixpanel-headless в Codex?
Для подготовки окружения запустите скилл mixpanel-headless-setup, который установит библиотеку mixpanel_headless и зависимости. Авторизацию в терминале выполняет команда mp login.
Чем mixpanel-headless отличается от плагина mixpanel?
Стандартный plugins/mixpanel использует размещённый коннектор сервиса. Плагин mixpanel-headless даёт агенту локальный Python SDK, позволяя писать скрипты с pandas и совмещать метрики с локальными файлами.
Как настроить авторизацию без браузера?
Экспортируйте переменные MP_OAUTH_TOKEN, MP_PROJECT_ID и MP_REGION="us" в терминале. Передавать токены текстом в чат нельзя.
Исходный текст
mixpanel-headless · MIT
# Mixpanel Headless Analyze Mixpanel data from Codex with the `mixpanel_headless` Python SDK. This plugin is intentionally separate from `plugins/mixpanel`, which wraps the hosted Mixpanel connector. `mixpanel-headless` is for coding-agent workflows where Codex installs a local SDK, writes Python, uses pandas and plotting libraries, and can compose Mixpanel analysis with local files or other data sources. ## Skills | Skill | Purpose | | --- | --- | | `mixpanel-headless-setup` | Install `mixpanel_headless` and common analysis dependencies, then verify credentials. | | `mixpanel-auth` | Check sessions, list/use accounts, run OAuth login, switch projects or workspaces, and manage targets. | | `mixpanelyst` | Discover event schemas and run segmentation, funnel, retention, flow, and user-profile analyses. | | `dashboard-expert` | Analyze, create, modify, and explain Mixpanel dashboards. | ## Quick Start 1. Use `mixpanel-headless-setup` to install dependencies and verify auth. 2. Use `mixpanel-auth` if account, project, workspace, or target selection needs setup. 3. Ask an analytics question, such as "Analyze signup dropoff in Mixpanel with Python." ## Authentication The SDK supports service accounts, browser OAuth, and bearer-token based OAuth. The recommended first setup command is: ```bash mp login ``` For non-interactive contexts, configure: ```bash export MP_OAUTH_TOKEN="<bearer-token>" export MP_PROJECT_ID="<project-id>" export MP_REGION="us" ``` Do not paste secrets into chat. Set them in the local shell or credential store. ## Source The skills are adapted from Mixpanel's public headless SDK plugin: https://github.com/mixpanel/mixpanel-headless/tree/main/mixpanel-plugin SDK documentation: https://mixpanel.github.io/mixpanel-headless/
© Mixpanel · MIT · openai/plugins
