SearchAtlas MCP Server 是一个面向营销场景的 MCP（Model Context Protocol）服务器桥接工具，用于将兼容 MCP 的 AI 客户端连接到 SearchAtlas v2 托管 MCP 服务器。
用途： 通过该工具，用户可以在 AI 客户端中直接调用 SearchAtlas 的营销能力，涵盖 SEO、内容生成、PPC、关键词研究、站点审计、权威建设以及 LLM 品牌可见性监控等。
主要能力： 该包本身是一个轻量级 stdio 桥接，连接到位于 https://mcp.searchatlas.com/mcp/ 的托管 v2 MCP 服务器。工具从托管服务器动态发现，客户端可看到实时目录（当前约 587 个工具），无需在新增工具时更新包。主要工具组包括：OTTO SEO、PPC、Content Genius、Site Explorer、Google Business Profile、本地 SEO、Link Laboratory、数字公关、LLM 可见性、关键词研究等。
使用方式：
- 安装与登录：可通过 npx 免安装运行，命令会打开浏览器。登录后按 F12（Mac 为 Cmd+Option+I）打开开发者工具，在 Console 标签运行 localStorage.getItem("token")，复制结果粘贴到终端。CLI 会验证令牌、保存并打印可直接粘贴的配置，路径自动检测。
- 添加到 MCP 客户端：支持 Claude Code、Cursor、Claude Desktop、VS Code、Windsurf 和 Zed。Windows 需使用 npx.cmd 而非 npx。各客户端配置位置不同，例如 Cursor 为项目根目录 .cursor/mcp.json 或全局 ~/.cursor/mcp.json；Claude Desktop 为 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json；Windsurf 为 ~/.codeium/windsurf/mcp_config.json；VS Code 为项目内 .vscode/mcp.json；Zed 为 settings.json。保存后重启客户端。
- 使用：直接用自然语言对话，AI 会选择合适的工具。所有命令也可通过 npx searchatlas-mcp-server <command> 运行。
令牌优先级（首个匹配生效）：SEARCHATLAS_TOKEN 环境变量、SEARCHATLAS_API_KEY 环境变量、~/.searchatlasrc 文件（由 searchatlas login 创建）。
原生 Streamable-HTTP 客户端： 如果 MCP 客户端直接支持 Streamable HTTP，可跳过 npm 包，一步连接远程服务器：URL 为 https://mcp.searchatlas.com/mcp/，传输方式为 Streamable HTTP（JSON-RPC + SSE），请求头为 Authorization: Bearer <SEARCHATLAS_TOKEN>。
适用场景： 适用于需要在 AI 客户端中集成 SearchAtlas 营销工具的用户，尤其是使用 Claude Code、Cursor、Claude Desktop、VS Code、Windsurf 或 Zed 进行 SEO、内容营销、PPC 管理、关键词研究、本地 SEO、链接建设、数字公关和 LLM 品牌可见性监控的场景。
限制与注意事项： 需要 SearchAtlas 账户。需要 Node.js >= 18。macOS GUI 应用不继承 shell 的 PATH，因此需使用 node 的完整路径并直接指向已安装包，以避免 spawn npx ENOENT 和 env: node: No such file 错误；searchatlas login 会自动检测路径并打印可复制粘贴的配置。故障排查可运行 searchatlas check，或使用 MCP Inspector 测试。
