Superlines AI Search Optimization MCP

Superlines MCP Server

用于 Superlines AI 可见度分析的 Model Context Protocol (MCP) 服务。

将 Claude Desktop、Cursor 或任何兼容 MCP 的客户端连接到您的 Superlines 数据。

快速开始 • 可用工具 • 故障排除

---

这是什么？

Superlines 会追踪您的品牌在 ChatGPT、Perplexity、Gemini 和 Claude 等 AI 搜索引擎中的展示情况。借助此 MCP 服务，您可以直接通过 AI 助手查询 Superlines 分析数据。

可以这样提问： -“我的品牌本月的可见度与上月相比如何？” -“哪些域名在 AI 回复中被引用得最多？” -“显示按声量份额排名的顶级竞争对手” -“审查我的网站是否适合大模型”

功能

• 📊 品牌分析 — 可见度指标、引用次数、声量份额
• 🏆 竞争对手分析 — 与竞争对手进行基准比较，并开展情感分析
• 🔗 引用追踪 — 查看 AI 回复中引用了哪些 URL
• 📈 趋势分析 — 每周和每月的表现趋势
• 🔍 网页审查 — 分析任意 URL 对大模型的适用性
• 🛠️ Schema 优化 — 生成经过优化的 Schema.org 标记

前提条件

• 已安装 Node.js 18+（下载）
• Superlines 账户，并拥有 Enterprise 计划（MCP 仅限 Enterprise 用户使用）
• 从您的 Superlines 控制面板获取的 API 密钥

---

快速开始

第 1 步：获取 API 密钥

1. 登录 analytics.superlines.io
2. 前往 Organization Settings → API Keys
3. 点击 "Create New API Key"
4. 复制密钥（以 sl_live_ 开头）——该密钥只会显示一次！

第 2 步：配置 Claude Desktop

编辑 Claude Desktop 配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

重要： 将 sl_live_YOUR_API_KEY 替换为您的实际 API 密钥。

第 3 步：重启 Claude Desktop

1. 完全退出： 在 Mac 上按 ⌘+Q，或在 Windows 上右键点击任务栏图标 → 退出
2. 重新打开 Claude Desktop
3. 验证： 查看是否出现锤子图标（🔨），表示 MCP 工具已就绪

第 4 步：开始提问！

What brands do I have access to in Superlines?

Show me my brand visibility for the last 30 days

Audit https://example.com for LLM-friendliness

---

备选方案：本地代理脚本

如果您不想使用 npx，可以下载并在本地运行代理脚本。

下载代理脚本

macOS / Linux：

mkdir -p ~/superlines-mcp
curl -o ~/superlines-mcp/mcp-proxy.js https://raw.githubusercontent.com/Superlines/mcp-server/main/mcp-proxy.js
chmod +x ~/superlines-mcp/mcp-proxy.js

Windows (PowerShell)：

mkdir $env:USERPROFILE\superlines-mcp
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Superlines/mcp-server/main/mcp-proxy.js" -OutFile "$env:USERPROFILE\superlines-mcp\mcp-proxy.js"

配置 Claude Desktop（本地代理）

macOS：

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/superlines-mcp/mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

Windows：

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["C:\\Users\\YOUR_USERNAME\\superlines-mcp\\mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

将 YOUR_USERNAME 替换为您的实际用户名。运行 echo $USER（macOS）或 echo %USERNAME%（Windows）即可查找用户名。

---

其他 MCP 客户端的配置

Cursor

将以下内容添加到项目或全局的 .cursor/mcp.json 中：

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

使用 Continue 的 VS Code

将以下内容添加到您的 Continue 配置中：

{
  "mcpServers": [
    {
      "name": "superlines",
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  ]
}

全局安装（备选方案）

如果您更愿意全局安装而不是使用 npx：

npm install -g @superlines/mcp-server

然后使用以下配置：

{
  "mcpServers": {
    "superlines": {
      "command": "superlines-mcp",
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

---

可用工具

品牌分析

工具	描述
list_brands	列出你有权访问的所有品牌
get_brand_details	获取品牌配置、竞争对手和行业信息
analyze_metrics	品牌可见度、引用率、提及次数、声量份额
get_weekly_performance	每周表现趋势
get_period_comparison	比较当前时段与上一时段
get_analytics_summary	高层级分析概览

引用

工具	描述
get_citation_data	域名和 URL 引用分析
get_top_cited_url_per_prompt	每个查询中被引用次数最多的 URL

竞争对手分析

工具	描述
analyze_brand_mentions	竞争对手提及情况及情感评分
get_competitive_gap	寻找竞争机会
get_competitor_insights	全面的竞争对手概览
get_best_performing_prompt	表现最佳的提示词

内容策略

工具	描述
get_query_data	查询分析及搜索量
find_content_opportunities	找出有改进潜力的主题
get_fanout_query_insights	大模型来源查询分析
analyze_sentiment	分析 AI 响应的情感倾向

网页分析

工具	描述
webpage_crawl	获取并解析网页内容
webpage_audit	全面的面向大模型友好度审计
webpage_analyze_technical	技术 SEO 分析
webpage_analyze_content	内容质量分析
schema_optimizer	优化 Schema.org 标记
analyze_competitor_url	深入分析竞争对手 URL

---

环境变量

变量	必填	描述
SUPERLINES_API_KEY	是	你的 Superlines API 密钥（以 sl_live_ 开头）
MCP_SERVER_URL	否	覆盖默认服务 URL
DEBUG	否	设置为 true 以启用调试日志

---

示例查询

性能分析

Show me brand visibility and citations for the last 30 days, grouped by LLM service

竞争对手情报

Who are my top 10 competitors by mentions? Show sentiment breakdown.

引用分析

Which domains are cited most in AI responses about my industry?

每周趋势

Show me weekly performance for the last 8 weeks

网页审计

Audit https://competitor.com for LLM-friendliness and show me what schemas they use

内容机会

What content should I create to improve my AI search visibility?

---

故障排除

“未设置 SUPERLINES_API_KEY 环境变量”

确保你的配置包含带有 API 密钥的 env 部分：

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["/path/to/mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

“401 未授权”

• 你的 API 密钥无效或已过期
• 在组织设置 → API 密钥中生成新密钥

“403 禁止访问”

• API 访问需要 Enterprise 计划
• 请联系 [email protected] 升级

Claude 提示“我无法访问任何工具”

1. 完全重启 Claude Desktop（在 Mac 上按 ⌘+Q，不要只关闭窗口）
2. 检查脚本路径——使用完整绝对路径，而非 ~
3. 验证配置是否为有效 JSON：

   cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool
   

4. 手动测试代理：

   export SUPERLINES_API_KEY="sl_live_your_key"
   echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node ~/superlines-mcp/mcp-proxy.js
   

   你应该会看到一个列出可用工具的 JSON 响应。

找不到脚本

• 在配置中使用完整绝对路径
• ✅ 正确：/Users/john/superlines-mcp/mcp-proxy.js
• ❌ 错误：~/superlines-mcp/mcp-proxy.js
• **Windows：**使用双反斜杠：C:\\Users\\john\\...

---

安全

• 🔒 切勿公开分享你的 API 密钥
• 🔒 不要将 claude_desktop_config.json 提交到版本控制中
• 🔒 定期在组织设置中轮换密钥
• 🔒 如果密钥泄露，请立即撤销

保护你的配置文件：

chmod 600 ~/Library/Application\ Support/Claude/claude_desktop_config.json

---

Beta 版说明

⚠️ Superlines MCP 服务目前处于 beta 阶段，可能不稳定或存在错误。请在 github.com/Superlines/mcp-server/issues 报告问题。

---

Resources

• Superlines Dashboard
• API Documentation
• MCP Protocol Specification
• Claude Desktop

Support

• Email: [email protected]
• Issues: github.com/Superlines/mcp-server/issues

---

License

MIT © Superlines