内容
# 内容差距分析 MCP
在没有数据的情况下制定内容策略是一种猜测行为。在投入数月的内容创作和数千美元之前，您需要了解在您的领域中什么已经在发挥作用。
- 竞争对手正在发布什么？
- 存在哪些空白？
- 他们优先考虑哪些类型的内容？
但是，要获得这些答案，就需要花费数小时手动爬取网站，将网址复制到电子表格中，并尝试在数千个页面中找到规律。
这个MCP服务器为您完成研究和分析：
- 确定商业模式、目标受众和主要竞争对手，以便您知道谁是分析对象
- 获取网站地图，将网址分类为内容类型（博客、文档、登陆页面、案例研究），并为每家公司生成战略性见解
- 揭示竞争对手之间的内容空白和机会，以展示他们正在做而您没有做的事情
## 安装
首先，克隆存储库：
```bash
git clone https://github.com/vibe-marketer-sandbox/content-gap-analysis-mcp.git
cd content-gap-analysis-mcp
```
然后选择您喜欢的安装方式：
<table>
<tr>
<td width="50%" valign="top">
### 选项 1：使用 pip
适用于您已经拥有的 Python 3.10+：
```bash
# 创建虚拟环境（macOS 上需要）
python3 -m venv venv
source venv/bin/activate
# 安装软件包
pip install -e .
```
</td>
<td width="50%" valign="top">
### 选项 2：使用 uv（更快）
[uv](https://docs.astral.sh/uv/) 是一个快速的 Python 包管理器：
```bash
# 安装 uv（macOS/Linux）
curl -LsSf https://astral.sh/uv/install.sh | sh
# 或使用 Homebrew
brew install uv
```
然后安装：
```bash
# 安装 uv（自动创建虚拟环境）
uv sync
```
</td>
</tr>
</table>
## 配置
<table>
<tr>
<td width="50%" valign="top">
### Cursor
1. 打开 Cursor 设置（Cmd+Shift+P > "Cursor 设置"）
2. 进入 "MCP" 部分
3. 添加服务器配置：
**如果使用 uv：**
```json
{
"mcpServers": {
"content-gap-analysis": {
"command": "uv",
"args": ["--directory", "/FULL/PATH/TO/content-gap-analysis-mcp", "run", "content-gap-analysis"]
}
}
}
```
**如果使用 pip（venv）：**
```json
{
"mcpServers": {
"content-gap-analysis": {
"command": "/FULL/PATH/TO/content-gap-analysis-mcp/venv/bin/python",
"args": ["-m", "content_gap_analysis.server"]
}
}
}
```
</td>
<td width="50%" valign="top">
### Claude Desktop
添加到您的配置文件中：
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"content-gap-analysis": {
"command": "uv",
"args": ["--directory", "/FULL/PATH/TO/content-gap-analysis-mcp", "run", "content-gap-analysis"]
}
}
}
```
对于 pip 安装，请使用：
```json
{
"mcpServers": {
"content-gap-analysis": {
"command": "/FULL/PATH/TO/content-gap-analysis-mcp/venv/bin/python",
"args": ["-m", "content_gap_analysis.server"]
}
}
}
```
</td>
</tr>
</table>
> **重要：** 将 `/FULL/PATH/TO/` 替换为您的实际路径。在 content-gap-analysis-mcp 文件夹中运行 `pwd` 以获取它。
## 工作原理
### 工作流程架构
```
╔═══════════════════════════════════════╗
║ 主要公司分析 ║
╚═══════════════════════════════════════╝
│
▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 步骤 1 │ │ 步骤 2 │ │ 步骤 3 │ │ 步骤 4 │
│ │ │ │ │ │ │ │
│ 研究_公司 │──▶│ 获取_网站地图 │──▶│ 分析_内容_ │──▶│ 分析_内容_ │
│ │ │ │ │ 架构 │ │ 策略 │
│ ┄┄┄┄┄┄┄┄┄┄┄┄ │ │ ┄┄┄┄┄┄┄┄┄┄┄┄ │ │ ┄┄┄┄┄┄┄┄┄┄┄┄ │ │ ┄┄┄┄┄┄┄┄┄┄┄┄ │
│ 确定竞争对手 │ │ 从网站地图获取网址 │ │ 按类型分类 │ │ 深入分析 │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
│
│ 确定竞争对手
▼
╔═══════════════════════════════════════╗
║ 针对每个竞争对手（重复） ║
╚═══════════════════════════════════════╝
│
▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 获取_网站地图 │──▶│ 分析_内容_ │──▶│ 分析_内容_ │
│ │ │ 架构 │ │ 策略 │
└──────────────┘ └──────────────┘ └──────────────┘
│
┌─────────────────────────────────────────────────────────┘
│ 分析所有公司后
▼
╔═══════════════════════════════════════╗
║ 最终比较 ║
╚═══════════════════════════════════════╝
│
▼
┌──────────────┐
│ 比较_策略 │
│ ┄┄┄┄┄┄┄┄┄┄┄┄ │
│ 跨公司分析 │
└──────────────┘
```
每个工具都会暂停并在继续之前请求您的批准，以便您始终保持控制。
## 使用方法
您可以通过两种方式与此MCP交互：
### 方法 1：一次性提示
给出一个全面性的提示，让AI完成整个工作流程：
```
分析 Clay（clay.com）的内容策略，并将其与排名前 3 的竞争对手进行比较。我想了解他们的内容架构，找出空白并获得战略建议。
```
AI将按顺序执行每个步骤，在每个检查点暂停以供您批准。
### 方法 2：逐步提示
按照上述工作流程架构，单独提示每个步骤：
```
步骤 1：研究 clay.com 的公司并确定其排名前 3 的竞争对手。
[批准并完成]
步骤 2：获取 clay.com 的网站地图
[批准并完成]
步骤 3：分析 Clay 的内容架构
[批准并完成]
步骤 4：现在对 Clay 进行战略深入分析
[批准并完成]
步骤 5：获取[竞争对手域名]的网站地图
[重复步骤以分析每个竞争对手...]
最终：比较所有分析的公司的内容策略
```
## 故障排除
### "spawn python ENOENT" 错误
Cursor 找不到 Python。使用虚拟环境中 Python 的完整路径：
```json
"command": "/Users/yourname/content-gap-analysis-mcp/venv/bin/python"
```
### "externally-managed-environment" 错误
macOS 阻止系统范围内的 pip 安装。首先创建虚拟环境：
```bash
python3 -m venv venv
source venv/bin/activate
pip install -e .
```
### Cursor 中未显示 MCP
1. 确保配置文件中的路径正确（不使用 `~`，使用完整路径）
2. 完全重启 Cursor（Cmd+Q，然后重新打开）
3. 检查 MCP 日志：Cursor 设置 > MCP > 查看日志
### 未找到网站地图
如果 `fetch_sitemap` 无法在标准位置（/sitemap.xml，/sitemap_index.xml，robots.txt）找到网站地图，它将要求您帮助找到它。搜索 `site:domain.com sitemap.xml` 并使用 `sitemap_url` 参数将网址提供给工具。
### 工具无法正常工作
如果您看到类似 `'Server' object has no attribute...` 的错误：
- 确保您拥有最新的代码（`git pull`）
- 重新安装：`uv sync` 或 `pip install -e .`
## 许可证
本软件为专有软件。有关条款，请参见 [LICENSE](LICENSE)。
您仅可将此软件用于个人或内部商业用途。严禁重新分发、转售和 sublicense。
