hotjar

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Hotjar Skill

Understand user behavior with Hotjar's heatmaps, recordings, and feedback tools.

借助Hotjar的热力图、会话录制和反馈工具了解用户行为。

Quick Install

快速安装

bash

curl -sSL https://canifi.com/skills/hotjar/install.sh | bash

Or manually:

bash

cp -r skills/hotjar ~/.canifi/skills/

bash

curl -sSL https://canifi.com/skills/hotjar/install.sh | bash

或手动安装：

bash

cp -r skills/hotjar ~/.canifi/skills/

Setup

配置步骤

Configure via canifi-env:

bash

undefined

通过canifi-env进行配置：

bash

undefined

First, ensure canifi-env is installed:

curl -sSL https://canifi.com/install.sh | bash

canifi-env set HOTJAR_API_KEY "your_api_key" canifi-env set HOTJAR_SITE_ID "your_site_id"

undefined

canifi-env set HOTJAR_API_KEY "your_api_key" canifi-env set HOTJAR_SITE_ID "your_site_id"

undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.

您的凭证，由您掌控。 Canifi LifeOS 尊重您的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:

Complete the Browser Automation Setup using CDP mode
Login to the service manually in the Playwright-controlled Chrome window
Claude will use your authenticated session without ever seeing your password

如果您不想与Claude Code共享凭证：

使用CDP模式完成浏览器自动化设置
在Playwright控制的Chrome窗口中手动登录该服务
Claude将使用您的已认证会话，全程不会获取您的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:

bash

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

如果您愿意共享凭证，可以将其存储在本地：

bash

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

注意：存储在canifi-env中的凭证仅能在您的本地设备访问，绝不会被传输。

Capabilities

功能特性

Heatmaps: View click, scroll, and move heatmaps
Session Recordings: Watch user session recordings
Surveys: Create and manage on-site surveys
Feedback Widgets: Collect visual feedback from users
Funnels: Analyze conversion funnels

热力图：查看点击、滚动和移动热力图
会话录制：查看用户会话录制内容
问卷调查：创建和管理站内问卷
反馈组件：收集用户的可视化反馈
转化漏斗：分析转化漏斗

Usage Examples

使用示例

View Heatmap

查看热力图

User: "Show me the heatmap for the homepage"
Assistant: Returns heatmap data for specified page

User: "Show me the heatmap for the homepage"
Assistant: Returns heatmap data for specified page

Get Recordings

获取录制内容

User: "Show me recent session recordings"
Assistant: Returns list of user session recordings

User: "Show me recent session recordings"
Assistant: Returns list of user session recordings

Survey Results

问卷结果

User: "What are the survey results from this week?"
Assistant: Returns survey responses and analytics

User: "What are the survey results from this week?"
Assistant: Returns survey responses and analytics

Feedback Analysis

反馈分析

User: "Show me recent user feedback"
Assistant: Returns feedback widget submissions

User: "Show me recent user feedback"
Assistant: Returns feedback widget submissions

Authentication Flow

认证流程

Get API key from Hotjar account settings
Note your site ID from settings
Use API key for authentication
Site ID scopes data access

从Hotjar账户设置中获取API密钥
从设置中记录您的站点ID
使用API密钥进行认证
站点ID用于限定数据访问范围

Error Handling

错误处理

Error	Cause	Solution
401 Unauthorized	Invalid API key	Verify API key
403 Forbidden	Feature not available	Check plan
404 Not Found	Site not found	Verify site ID
429 Rate Limited	Too many requests	Wait and retry

错误	原因	解决方法
401 未授权	API密钥无效	验证API密钥
403 禁止访问	功能不可用	检查您的套餐
404 未找到	站点不存在	验证站点ID
429 请求受限	请求次数过多	等待后重试

Notes

注意事项

Heatmaps and recordings core features
GDPR compliant with consent tools
Free tier available
Real-time data collection
Integration with many tools
Mobile app recordings available

热力图和录制是核心功能
符合GDPR规范，包含同意工具
提供免费版
实时数据收集
支持与多种工具集成
支持移动应用录制