Mimetic — Website Growth and Analytics

mim：Mimetic 命令行工具

将网站的增长背景带入终端以及你日常使用的 AI 工具中。

将 AI 助手连接到网站审计、分析、广告和实验结果，以发现营收机会并实施可审查的改进。

• MCP 连接指南和使用场景
• 实时工具目录和输入架构
• 远程 MCP：https://mcp.trymimetic.com/mcp（通过 OAuth 登录的 Streamable HTTP）

公开目录包含工具定义。MCP 请求需要身份验证，并会限制对你自己的项目和已连接账户的访问。

快速开始

安装后运行设置。设置会处理登录、项目检测以及为这台机器上的各类 Agent 注册 MCP，并逐项实际验证，而不是假定设置已生效。

npm install -g @mimeticinc/mim-cli
mim setup

设置会为检测到的 Claude Code、Codex、Cursor、Windsurf 和 Claude Desktop 注册服务。写入前会备份每个配置文件，并且不会影响你已有的其他 MCP 服务。之后可运行 mim mcp install cursor 添加一个，或重新运行 mim mcp install all。

请全局安装，而不要通过 npx 安装。你的 Agent 会将 mim 作为 MCP 服务启动，因此需要在 PATH 中保留一个可用的 mim；本文档中的示例也都使用 mim <command>。需要 Node.js 20 或更高版本。

重新运行设置是安全的：它会沿用现有登录和注册信息，而不是创建新凭证。

如果安装后 mim 提示“command not found”，说明 npm 的全局 bin 目录不在 shell PATH 中。运行以下命令，查看适用于你所用 shell 的具体修复方法：

npx -y @mimeticinc/mim-cli setup

该命令会输出要添加到 shell 配置文件中的 export PATH= 行。临时运行命令时也可以使用 npx 形式，但在配置 MCP 客户端前，请先全局安装。

Mimetic 将审计、实时分析、广告效果、生命周期营销和会话行为数据整合起来，让你无需在不同仪表盘之间切换，就能找出阻碍增长的因素、决定下一步行动，并着手开展可审查的修复工作流。你可以直接在 shell 中使用 mim，也可以让 Claude Code、Codex 和其他 MCP 客户端获取相同的背景信息并执行相同的操作。

Mimetic 是 CLI 背后的托管服务。详情请访问 trymimetic.com。

你可以完成的工作

• 找出影响最大的​​问题。 将网站审计、优先级调查结果以及经过脱敏的会话回放洞察纳入同一项目背景。
• 根据实时数据回答增长问题。 查询获客、转化、营收、搜索、广告、产品分析和生命周期表现，无需导出 CSV 文件。
• 修复衡量和获客配置。 配置托管的 GA4 和 Search Console，通过 PR、Shopify pixel 或由 Agent 应用的代码片段安装跟踪，并创建或连接 Google Ads 资源。
• 将调查结果转化为可审查的工作。 启动代码修复工作流，然后打开拟议的 PR、差异、预览或 Mimetic 审查页面。
• 为编码 Agent 提供业务背景。 让 MCP 客户端在提出建议或开始执行操作前，检查相同的调查结果和已连接数据。

集成

集成	可实现的功能
Google Analytics 4	查询会话、用户、渠道、着陆页、互动、转化和收入。如果缺少衡量配置，可设置托管属性和代码标记。
Google Search Console	分析查询、页面、国家/地区、设备、点击、展示、点击率和排名。托管设置还可处理验证和站点地图提交。
Google Ads	检查广告系列、支出、点击、转化、搜索字词和其他 GAQL 数据。创建或关联账号，将其连接到 GA4，并启用自动标记。
PostHog	对事件和属性运行只读 HogQL，以调查产品使用情况、漏斗和行为。
Klaviyo	查看广告系列和流程的表现、列表、细分和指标。检查弃购流程是否已上线，并查找广告系列模板中的失效链接。
GitHub	通过可供审查的拉取请求、差异和预览，接收分析安装和代码修复。
Shopify	当项目可使用此交付方式时，通过 Mimetic 应用像素安装托管分析。
Claude Code、Codex 和 MCP 客户端	将项目上下文、连接数据查询、审计以及明确说明的操作工具引入 AI 辅助工作流。

可以解答的问题

连接相关账号后，你可以使用 CLI，或向 MCP 客户端提问，例如：

• 哪些着陆页的自然点击量下降了，但在 GA4 中仍有不错的转化效果？
• 哪些地方的广告支出在增加，但转化量没有相应增长？
• 用户在最近的高优先级会话中遇到了哪些困难？
• 弃购流程是否已上线？哪些广告系列模板包含失效链接？
• 当前已准备启动的最高优先级修复是什么？我可以在哪里查看提议的更改？

从上下文到操作

# Build a project brief from audits, findings, and connected signals
mim context --project yourstore.com

# Investigate acquisition and conversion performance
mim query-ga4 --project yourstore.com \
  --metrics sessions,conversions,totalRevenue \
  --dimensions sessionDefaultChannelGroup
mim query-gsc --project yourstore.com --dimensions query,page
mim query-bq --project yourstore.com --describe
mim query-bq --project yourstore.com --sql \
  "SELECT event_name, COUNT(*) AS n FROM \`events_*\` WHERE _TABLE_SUFFIX >= '20260901' GROUP BY 1 ORDER BY n DESC"
mim ads query --project yourstore.com

# Check lifecycle marketing and recent customer friction
mim klaviyo query --project yourstore.com --resource abandoned_cart_status
mim recordings --project yourstore.com

# Move a prioritized finding into a reviewable fix workflow
mim fixes list --project yourstore.com
mim fixes start 1 --project yourstore.com

运行命令

全局安装后，运行 mim <command>。如果未全局安装，也可以通过 npx 运行所有命令：

npx -y @mimeticinc/mim-cli <command>

身份验证和本地凭据

mim auth login 会打开基于浏览器的设备流程。服务器颁发的令牌会在配置的有效期后过期（默认为 90 天）。

登录操作具有幂等性：如果这台计算机上已有可用令牌，mim auth login 会向服务器验证该令牌并继续使用，而不是签发新令牌。使用 mim auth login --force 可切换到其他账号登录。

每次登录后，CLI 都会进行一次真实的 API 调用，以确认令牌有效并列出你的项目。项目归属于接收 Mimetic 审计或报告的邮箱。如果你使用其他邮箱登录（例如个人邮箱而非工作邮箱），项目列表将为空，CLI 会告知你应使用哪个邮箱。mim auth status 会执行相同的服务器端验证，并准确显示这台计算机正在使用的账号和项目。

无头服务器和 SSH

浏览器无需与 CLI 运行在同一台机器上。在没有桌面环境的服务器上，启动设备授权流程时不要尝试打开本地浏览器：

mim auth login --no-open

让该进程保持运行，然后在笔记本电脑或手机上打开打印出的验证 URL，并在那里批准登录。服务器会通过轮询 Mimetic 完成登录，并将自己的令牌存储在 ~/.mim/config.json 中。

对于无人值守部署，请通过服务器的密钥管理器或环境提供 MIM_API_TOKEN，而不要依赖交互式登录。不要将令牌直接放在命令参数中。

默认情况下，CLI 会将该 bearer 令牌以明文 JSON 格式存储在 ~/.mim/config.json 中。在受支持的 POSIX 系统上，每当保存凭据时，它都会将目录权限设为 0700，并将文件权限设为 0600。令牌不会在本地加密，也不会存储在操作系统的钥匙串中。

mim auth status
mim auth logout

mim auth logout 会先在 Mimetic 服务器上撤销已存储的托管令牌，然后再删除本地文件。如果无法确认撤销成功，CLI 会保留本地凭据并报告错误。mim auth logout --local-only 仅删除本地副本；该令牌仍可使用，直到过期或通过其他方式撤销。

对于 CI 或密钥管理器，请改为设置 MIM_API_TOKEN。环境令牌会覆盖本地存储的凭据，且不会被 mim auth logout 更改。我们有意不接受通过命令行参数传入令牌，以免令牌通过 shell 历史记录或进程列表泄露。

命令

命令	功能
mim setup	一键完成入门设置：检查安装、登录、检测项目、为发现的每个 Agent 注册 MCP，并验证每个步骤。
mim auth login [--no-open] [--force]	通过设备授权流程进行身份验证；除非使用强制选项，否则会复用可用令牌。
mim auth status	显示并通过服务端验证当前账号、项目和默认项目。
mim auth logout [--local-only]	撤销并删除已存储的凭据，或仅删除本地副本。
mim projects	列出已通过身份验证的账号可用的项目／网站。
mim projects use <key>	保存默认项目，这样后续命令就不必再指定 --project。
mim properties	列出项目的 Google 连接可访问的 GA4 媒体资源，并显示 28 天会话数和当前选项。
mim properties use <id>	将项目指向特定的 GA4 媒体资源（根据连接可访问的资源进行验证）。
mim context	输出项目的增长背景信息包。
mim recordings	列出近期的会话回放摘要。
mim replay [session_id]	输出一条已保存的回放洞察；默认使用最新记录。
mim findings	列出按优先级排序的审计发现。
mim query-ga4 --metrics sessions	运行仅从提供商读取数据的 GA4 报告。
mim query-gsc	运行仅从提供商读取数据的 Search Console 查询。
mim query-bq --sql <q>	对项目自己的 GA4 BigQuery 导出数据运行只读 SELECT 查询（使用 --describe 查看数据集和表日期）。
mim setup-analytics [--wait]	启动托管式 GA4 和 Search Console 设置。
mim setup-analytics --status	检查托管设置进度。
mim setup-analytics --channel agent	配置服务端，并返回供 Agent 应用的代码片段。
mim ads setup	创建托管式 Google Ads 资源，并邀请网站所有者担任管理员。
mim ads status	显示已关联的 Ads 账号和设置状态。
mim ads query [--gaql <q>]	运行仅从提供商读取数据的 GAQL 报告。
mim posthog connect / query	授权 PostHog 并运行仅从提供商读取数据的 HogQL。
mim klaviyo connect / query	授权 Klaviyo 并运行仅从提供商读取数据的报告和检查。
mim audit start <url> [--wait]	启动审计，可选择轮询直至完成。
mim audit rerun <url>	强制重新运行审计。
mim audit status <id> / wait <id>	检查或轮询审计。
mim fixes list	列出可修复的发现以及 PR／审核状态。
mim fixes start <rank>	将代码修复工作流加入队列。
mim fixes open <rank>	打开 PR、预览、差异、审核或工作流。
mim billing status / checkout / portal	管理项目账单。
mim mcp install claude	将 mim MCP 服务注册到 Claude Code（用户范围）并进行验证；若失败，则改用 Claude Desktop。
mim mcp install codex / cursor / windsurf / desktop	写入该 Agent 的配置文件，并备份原有内容。添加 --print 可改为输出配置块。
mim mcp install all	为这台机器上发现的每个 Agent 注册服务。

运行 mim --help 查看所有选项。

MCP

mim-mcp 二进制程序会将 MCP stdio 消息代理到 Mimetic 托管的 Streamable HTTP 端点。mim setup 会为你完成注册。若只需注册 MCP 部分：

mim mcp install all       # every agent found on this machine
mim mcp install claude    # registers with Claude Code at user scope, then verifies
mim mcp install codex     # writes ~/.codex/config.toml
mim mcp install cursor    # writes ~/.cursor/mcp.json
mim mcp install windsurf  # writes ~/.codeium/windsurf/mcp_config.json
mim mcp install desktop   # writes Claude Desktop's config file

每次写入文件前都会先备份，写入后也会读取验证，并保留文件中已有的其他 MCP 服务。Codex 配置采用 TOML 格式，因此会追加条目，而不是重新解析并改写整个文件。重复运行其中任何命令都不会创建重复条目。添加 --print 可查看配置块，但不会写入任何内容。

mim mcp install claude 会有意在用户级别注册：Claude Code 的默认设置（本地级别）仅适用于运行命令的目录，这是“安装成功”却未在会话中显示的最常见原因。注册后，CLI 会通过 claude mcp get mim 读取该条目，并对托管端点进行实时调用，因此成功意味着服务可访问，而不只是命令以状态码 0 退出。

MCP 提供面向调查结果、脱敏回放洞察和仅向提供商读取的分析查询的读取工具。其中还包含说明明确的操作工具，可启动审计、创建或配置分析／广告资源，或发起可审核的修复工作流。授权操作前，请仔细查看工具说明和客户端的审批提示。

有关客户端配置、数据流、远程 HTTP 设置和注册表发布说明，请参阅 docs/MCP.md。

连接数据访问

CLI 和 MCP 封装器是 Mimetic 托管 API 的客户端；它们不会从你的计算机直接查询 Google、PostHog 或 Klaviyo。凭据、工具参数和请求的提供商结果都会经过 Mimetic 的系统。因此，Mimetic 在提供请求服务时，具备对已连接凭据和数据的技术访问权限。连接器标注的“只读”描述的是其在第三方提供商处的权限；这并不意味着 Mimetic 无法查看数据。

PostHog 查询可能返回已连接项目中可用的不同标识符以及事件或用户属性。当前 Klaviyo 连接器不会请求个人资料或写入权限。如果你通过 AI 客户端调用工具，返回的数据也会提供给你配置的 AI 客户端及其账户。

连接生产数据前，请阅读隐私政策和服务条款。

传输安全

默认情况下，仅向 HTTPS URL 发送 Bearer 令牌。允许对 localhost、127.0.0.1 和 ::1 等环回主机使用纯 HTTP。对于特殊的本地开发环境，可通过 MIM_ALLOW_INSECURE_HTTP=1 显式关闭此保护；请勿将其用于生产凭据。

环境变量

变量	用途
MIM_API_TOKEN	Bearer 令牌；优先于已保存的凭据。
MIM_API_BASE_URL	API 源；默认为 https://trymimetic.com。
MIM_MCP_URL	完整 MCP URL；默认为 <API origin>/api/mim/mcp。
MIM_PROJECT	默认项目／站点密钥。
MIM_CONFIG_DIR	凭据目录；默认为 ~/.mim。
MIM_MCP_TIMEOUT_MS	MCP 请求超时时间；默认为 30000。
MIM_TELEMETRY=0	禁用仅收集元数据的 CLI／MCP 使用事件。
MIM_DISABLE_TELEMETRY=1	另一种退出遥测的方式。
MIM_ALLOW_INSECURE_HTTP=1	仅在开发环境中允许对非环回地址使用明文 HTTP。

元数据遥测包含客户端版本、项目、命令或工具名称、状态、耗时、跟踪 ID、HTTP 状态和有限诊断信息。其设计旨在不包含访问令牌、查询文本、MCP 参数、回放叙述或提供商结果。即使禁用遥测，托管请求和结果仍会传送至 Mimetic。

开发

npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run

依据 MIT License 授权。版权所有 © 2026 Mimetic Inc.