跳转到主要内容
mint analytics 命令让你可以从终端访问文档分析。这对于通过脚本生成分析报告、将数据导入其他工具以及在不打开仪表板的情况下进行快速检查非常有用。

​
前提条件

你必须登录才能使用分析命令。运行 mint login 来使用你的 Mintlify 账户进行身份验证。 有关身份验证的详细信息，请参阅本地预览。

​
查看关键指标

显示浏览量、访客数、搜索量、反馈和助手使用情况的摘要： 
mint analytics stats
使用选项按日期范围、页面或流量来源进行筛选：
  • --from：开始日期，格式为 YYYY-MM-DD。默认为 7 天前。
  • --to：结束日期，格式为 YYYY-MM-DD。默认为今天。
  • --page：筛选特定页面路径。
  • --humans：仅显示人类流量。
  • --agents：仅显示 AI 流量。
Example analytics stats flags
mint analytics stats --from 2025-01-01 --to 2025-01-31
mint analytics stats --page /quickstart
mint analytics stats --humans
mint analytics stats --agents

​
查看搜索分析

查看用户的搜索内容，包括命中次数和点击率： 
mint analytics search
使用选项按查询字符串或页面筛选：
  • --query：按搜索查询子字符串筛选。
  • --page：筛选特定页面路径。
Example analytics search flags
mint analytics search --query "authentication"

mint analytics search --page /api-reference

​
查看反馈

查看用户在文档页面上提交的反馈： 
mint analytics feedback
使用选项按页面汇总反馈，或筛选代码片段反馈：
  • --type：按页面或代码片段汇总反馈。默认为页面。
  • --page：筛选特定页面路径。
Example analytics feedback flags
mint analytics feedback --type page
mint analytics feedback --type code

​
查看助手对话

列出 AI 助手的最近对话和对话分类： 
mint analytics conversation list
mint analytics conversation buckets list
每个列表输出都包含每个条目的 ID。将该 ID 传递给相应的 view 命令以查看完整详情： 
mint analytics conversation view <conversation-id>
mint analytics conversation buckets view <bucket-id>

​
选择输出格式

所有分析命令默认使用 plain 输出，即制表符分隔，适合导入其他工具。使用 --format 更改输出： 
mint analytics stats --format table    # 带颜色的格式化表格
mint analytics stats --format json     # 原始 JSON
mint analytics stats --format graph    # 水平条形图
使用 --agent 选项获取 JSON 输出。当环境变量 CLAUDECODE 为 1 时，CLI 会自动检测代理环境。

​
使用 config 设置默认值

为避免重复输入常用选项，可以使用 mint config 设置默认值。配置保存在 ~/.config/mintlify/config.json 中。 可用的配置键：
键描述
subdomain分析命令的默认子域名。
dateFrom分析查询的默认开始日期（YYYY-MM-DD）。
dateTo分析查询的默认结束日期（YYYY-MM-DD）。
Example configs
mint config set subdomain my-docs
mint config set dateFrom 2025-01-01
设置后，分析命令会自动使用这些值： 
# 使用已配置的子域名和 dateFrom，无需选项
mint analytics stats
要查看或清除某个值，请运行： 
mint config get subdomain
mint config clear subdomain

相关主题

文件文本格式搜索文档