1. 什么是 siseo MCP Server
MCP（Model Context Protocol）是一种让大模型应用以标准方式调用外部工具与数据源的开放协议。siseo MCP Server 将平台的核心数据能力封装为一组 MCP 工具，任何支持 MCP 的客户端都可以在对话中直接调用，例如“帮我分析 `portable power station` 的扇出子查询，并检查我的集合页覆盖了哪些”。
MCP Server 支持两种传输方式：本地 `stdio` 模式（通过 npx 启动，适合 Claude Desktop、Cursor 等桌面客户端）与远程 Streamable HTTP 模式（适合 Dify、Coze、飞书智能体等云端平台）。两种模式共用同一个 API Key 与计费额度。
- 1登录业务控制台，进入「开放平台 → API 密钥」创建一个 MCP 专用密钥，并按需勾选工具权限范围。
- 2确认本地已安装 Node.js 20 或更高版本（仅 stdio 模式需要）。
- 3按下文对应客户端的配置示例写入 MCP 配置并重启客户端。
- 4在对话中输入“列出 siseo 可用工具”，确认工具列表加载成功。
2. 客户端配置示例
Claude Desktop 的配置文件位于 `claude_desktop_config.json`（可在客户端「设置 → 开发者 → 编辑配置」中打开）；Cursor 可在项目根目录的 `.cursor/mcp.json` 或全局设置中配置。两者均使用相同的 `mcpServers` 结构。
Dify、Coze 等云端平台请选择“添加 MCP 服务（HTTP）”，填写远程端点 `https://mcp.siseo.cn/v1/mcp`，并在请求头中加入 `Authorization: Bearer <SISEO_API_KEY>`。请勿把 API Key 写入公开仓库或前端代码。
{
"mcpServers": {
"siseo": {
"command": "npx",
"args": ["-y", "@siseo/mcp-server@latest"],
"env": {
"SISEO_API_KEY": "sk_live_xxxxxxxxxxxxxxxx",
"SISEO_DEFAULT_MARKET": "zh-CN",
"SISEO_LOG_LEVEL": "info"
}
},
"siseo-remote": {
"type": "http",
"url": "https://mcp.siseo.cn/v1/mcp",
"headers": {
"Authorization": "Bearer sk_live_xxxxxxxxxxxxxxxx"
}
}
}
}3. 工具清单与核心参数
当前版本提供以下工具。所有工具均返回结构化 JSON，并附带 `credits_used` 字段便于核算额度。带“写操作”标记的工具默认关闭，需要在控制台显式授权。
| 工具名 | 用途 | 核心参数 | 返回要点 |
|---|---|---|---|
| keyword_fanout | 推导主词在 AI 搜索中的 6-12 个扇出子查询并完成意图聚类 | keyword（必填）、market（如 en-US / zh-CN）、depth（1-2） | 子查询列表、维度、同页 / 独立页意图、搜索量估算 |
| domain_si_index | 查询域名的 siseo 双擎指数（SI-Index） | domain（必填）、engines（baidu / bing / google 等） | SERP 权重（0-10）、GEO Visibility Score（0-100）、收录与排名词趋势 |
| geo_visibility | 在主流大模型中并发采样品牌可见度 | brand（必填）、competitors[]、prompts[]、models[]、rounds（默认 5） | 纳入率、平均推荐顺位、情感倾向、引文域名分布与置信区间 |
| serp_snapshot | 抓取实时 SERP 全要素快照 | query（必填）、engine、market、device（desktop / mobile） | 自然结果 Top100、AI Overviews 文本与引文、PAA、相关搜索 |
| fact_coverage_audit | 审计页面事实覆盖率与可验证事实数量 | url 或 content（二选一）、threshold（默认 0.35） | 事实覆盖率、事实句列表、空洞段落定位与改写建议 |
4. 典型对话用法与最佳实践
MCP 工具最适合被组合调用。例如在 Cursor 中编写博客时，可以让智能体先调用 `keyword_fanout` 获取子查询，再调用 `fact_coverage_audit` 检查草稿，最后根据缺口补写段落；在 Dify 工作流中，可以每周定时调用 `geo_visibility` 并把结果推送到飞书群。
为控制额度消耗，建议在提示词中明确市场与模型范围，对 `geo_visibility` 设置合理的 `rounds`，并开启控制台的“单日额度上限”。所有调用记录可在控制台「开放平台 → 调用日志」中按工具与密钥维度查询。
- 1示例指令 1：“用 keyword_fanout 分析 `螺杆空压机选型`，按意图聚类后给出支柱页大纲。”
- 2示例指令 2：“对比我和两家竞品在 DeepSeek、豆包、ChatGPT 中的 geo_visibility，列出竞品独有的引文域名。”
- 3示例指令 3：“对这篇草稿执行 fact_coverage_audit，把覆盖率低于 35% 的段落标出来并给出补充事实建议。”
- 4为不同团队成员分配独立 API Key，便于审计与额度管理。