Rybbit MCP服务器
一个MCP（模型上下文协议）服务器，用于与 Rybbit分析 API此服务器提供用于查询分析数据、管理站点、跟踪事件等的工具。
安装
无需安装！使用 npx 直接跑步。
或全局安装：
npm install -g rybbit-mcp-server配置
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
RYBBIT_API_KEY | 是 | - | 您的Rybbit API密钥 |
RYBBIT_URL | 没有 | https://app.rybbit.io | Rybbit API的基本URL（用于自托管实例） |
获取API密钥
- 导航到“设置”→ Rybbit仪表板中的帐户
- 转到API密钥部分
- 使用自定义名称创建密钥
- 立即复制（不再显示）
用法
使用克劳德桌面
添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"rybbit": {
"command": "npx",
"args": ["rybbit-mcp-server"],
"env": {
"RYBBIT_API_KEY": "your_api_key_here"
}
}
}
}对于自托管Rybbit实例，添加 RYBBIT_URL 环境变量：
{
"mcpServers": {
"rybbit": {
"command": "npx",
"args": ["rybbit-mcp-server"],
"env": {
"RYBBIT_API_KEY": "your_api_key_here",
"RYBBIT_URL": "https://your-rybbit-instance.com"
}
}
}
}使用克劳德代码
添加到您的Claude Code MCP设置中(~/.claude/settings.json):
{
"mcpServers": {
"rybbit": {
"command": "npx",
"args": ["rybbit-mcp-server"],
"env": {
"RYBBIT_API_KEY": "your_api_key_here",
"RYBBIT_URL": "https://your-rybbit-instance.com"
}
}
}
}独立
npx rybbit-mcp-server
# Or if installed globally:
rybbit-mcp-server可用工具
概述和指标
rybbit_get_overview-获取高级分析（会话、页面浏览量、用户、跳出率）rybbit_get_overview_timeseries-获取时间序列分析数据rybbit_get_metric-按参数（浏览器、国家等）获取尺寸细分rybbit_get_live_visitors-获取当前活跃访客的计数
会话
rybbit_get_sessions-获取会话的分页列表rybbit_get_session_details-获取活动的详细会话信息rybbit_get_session_locations-获取用于地图可视化的会话位置
事件
rybbit_get_events-获取事件的分页列表rybbit_get_event_names-获取具有计数的唯一事件名称rybbit_get_event_properties-获取特定事件的属性rybbit_get_outbound_links-获取出站链接点击
用户
rybbit_get_users-获取分页用户列表rybbit_get_user_sessions-获取特定用户的会话rybbit_get_user_session_count-获取用户的每日会话计数rybbit_get_user_info-获取详细的用户资料
目标
rybbit_get_goals-通过转化指标实现目标rybbit_get_goal_sessions-获取完成目标的会话rybbit_create_goal-创建新目标（基于路径或事件）rybbit_update_goal-更新目标配置rybbit_delete_goal-删除目标
漏斗
rybbit_get_funnels-获得保存的漏斗rybbit_analyze_funnel-分析逐步转换rybbit_get_funnel_step_sessions-以漏斗步骤获取会话rybbit_create_funnel-创建新漏斗rybbit_delete_funnel-删除漏斗
性能（核心网络关键）
rybbit_get_performance_overview-获取LCP、CLS、INP、FCP、TTFB指标rybbit_get_performance_timeseries-了解随时间变化的性能趋势rybbit_get_performance_by_dimension-按路径名、国家等获取性能。
错误跟踪
rybbit_get_error_names-获取计数的唯一错误rybbit_get_error_events-使用堆栈跟踪获取错误事件rybbit_get_error_timeseries-获取随时间变化的错误趋势
保留和旅程
rybbit_get_retention-获取基于队列的留存分析rybbit_get_journeys-获取常用用户导航路径
组织和网站
rybbit_get_organizations-获取您的组织rybbit_get_organization_members-获取组织成员rybbit_add_organization_member-向组织添加成员rybbit_create_site-创建新网站rybbit_get_site-获取网站详细信息rybbit_update_site-更新站点配置rybbit_delete_site-删除网站
事件跟踪
rybbit_track_event-发送跟踪事件（页面浏览量、自定义、性能、错误、出站）
公共参数
时间参数
大多数分析工具都接受时间参数：
startDate/endDate-YYYY-MM-DD格式的日期范围timeZone-IANA时区（例如，“美洲/纽约”）pastMinutesStart/pastMinutesEnd-相对时间范围（分钟）
过滤器
使用JSON数组格式过滤数据：
[
{
"parameter": "country",
"type": "equals",
"value": ["US"]
}
]过滤器类型： equals, not_equals, contains, not_contains, regex, not_regex, greater_than, less_than
可用参数： browser, operating_system, device_type, country, region, city, pathname, page_title, hostname, querystring, referrer, utm_source, utm_medium, utm_campaign, user_id, event_name
速率限制
Rybbit API的速率限制为每个API密钥每10分钟500个请求。
许可证
麻省理工学院