内容
# 本地SEO数据MCP服务器
[模型上下文协议](https://modelcontextprotocol.io) 服务器，用于 [本地SEO数据](https://localseodata.com)。为AI助手提供42种本地SEO工具的访问权限 - 搜索结果跟踪、评论监控、关键词研究、AI可见性评分、地理网格扫描等。
一次性设置，然后用纯中文提问，您的助手将自动调用正确的端点。
## 前置条件
1. 在 [localseodata.com/signup](https://localseodata.com/signup) 注册
2. 在 [API密钥仪表盘](https://localseodata.com/dashboard/keys) 中创建API密钥
3. 将下面的 `YOUR_API_KEY` 替换为您的密钥（以 `sk_live_` 开头）
## 设置
### 克劳德代码
```bash
claude mcp add localseodata --transport http "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY" --scope user
```
`--scope user` 标志使其在所有项目中可用。添加后重启克劳德代码。
### 克劳德桌面版
将以下内容添加到您的配置文件中：
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"localseodata": {
"url": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
}
}
}
```
保存后重启克劳德桌面版。
### 光标
将以下内容添加到 `.cursor/mcp.json` 中，位于您的项目根目录，或 `~/.cursor/mcp.json` 以实现全局访问：
```json
{
"mcpServers": {
"localseodata": {
"url": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
}
}
}
```
### VS 代码（GitHub Copilot）
将以下内容添加到 `.vscode/mcp.json` 中，位于您的项目中：
```json
{
"servers": {
"localseodata": {
"type": "streamable-http",
"url": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
}
}
}
```
### 克莱恩
打开克莱恩设置 > MCP 服务器 > 添加远程服务器：
- **名称：** localseodata
- **网址：** `https://mcp.localseodata.com/mcp?key=YOUR_API_KEY`
### 温德塞夫
将以下内容添加到 `~/.codeium/windsurf/mcp_config.json` 中：
```json
{
"mcpServers": {
"localseodata": {
"serverUrl": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
}
}
}
```
## 可用工具
| 类别 | 工具 |
|----------|-------|
| 搜索结果数据 | `local_pack`, `organic_serp`, `local_finder`, `maps`, `local_services_ads` |
| AI/LLM 优化 | `ai_overview`, `ai_mode`, `ai_mentions`, `ai_visibility`, `ai_compare`, `ai_keyword_data`, `ai_top_sources`, `ai_top_pages` |
| 企业数据 | `business_profile`, `google_reviews`, `qa`, `business_listings`, `multi_platform_reviews` |
| 关键词研究 | `search_volume`, `keyword_suggestions`, `keywords_for_site`, `related_keywords`, `keyword_trends` |
| 审计 | `local_audit`, `citation_audit`, `reputation_audit`, `page_audit`, `profile_health` |
| 竞争情报 | `competitor_gap`, `competitor_ads`, `brand_mentions`, `backlink_gap`, `backlink_summary` |
| 报告 | `review_velocity`, `local_authority`, `keyword_opportunities` |
| 地理网格 | `geogrid_scan` |
| 位置 | `location_search` |
| 实用工具 | `ping`, `get_balance` |
## 示例提示
连接后，直接用中文提问：
- "谁在丹佛的本地搜索结果中排名第一，关键词是'水管工'？"
- "为奥斯汀TX的迈克的水管公司进行完整的本地SEO审计"
- "比较我的谷歌评论与我的前3名竞争对手"
- "牙医在波特兰应该关注哪些关键词？"
- "检查我的企业名录信息在各个目录中是否一致"
- "在布鲁克林以'面包店'为关键词，绘制我的排名在5x5的地理网格上"
- "我的'芝加哥最好的披萨'的AI可见性评分是多少？"
## 身份验证
您的API密钥作为URL查询参数传递（`?key=YOUR_API_KEY`）。这适用于每个MCP客户端，无需自定义头部配置。密钥可以随时在 [API密钥仪表盘](https://localseodata.com/dashboard/keys) 中创建或撤销。
## 定价
MCP调用消耗您本地SEO数据账户的积分，与REST API调用相同。大多数端点消耗1个积分（$0.005）。在您的 [仪表盘](https://localseodata.com/dashboard) 中监控使用情况。
参见 [localseodata.com/pricing](https://localseodata.com/pricing) 获取计划详情。
## 自主托管
如果您想自己运行MCP服务器：
```bash
git clone https://github.com/localseodata/mcp-server.git
cd mcp-server
npm install
npm run build
```
设置所需环境变量并启动：
```bash
export API_BASE_URL=https://api.localseodata.com
npm start
```
服务器默认运行在3003端口（可通过设置`PORT`更改）。包含用于容器部署的Dockerfile。
## 开发
```bash
npm run dev # 监视模式，热重载
npm run build # 编译TypeScript
npm run typecheck # 类型检查，不生成输出
npm start # 运行编译后的输出
```
## 许可证
MIT
