内容
# 标签页连接器
一个MCP（模型上下文协议）工具，用于连接Taboola广告API与AI助手，如Claude（在Cursor、Claude Desktop等），允许您通过自然语言对话分析您的活动数据。
## 功能
- **自然语言查询**：用简单的中文提问关于您的Taboola活动的问题
- **活动绩效分析**：获取关于您的广告绩效的总结、趋势和洞察
- **账户管理**：在一个地方查看所有您的账户和活动
- **数据可视化**：在聊天界面中用简单的ASCII图表查看绩效趋势
- **全面洞察**：根据您的活动数据获取可行的建议
## 设置
### 先决条件
- 安装Python 3.8+
- 一个具有API访问权限的Taboola账户
- 有效的Taboola API凭证（客户端ID和客户端密钥）
### 安装
1. **克隆或下载此仓库并安装依赖项**
2. **安装依赖项**
```bash
pip install -r requirements.txt
```
3. **设置环境变量**
在根目录中创建一个`.env`文件，并添加您的Taboola API凭证：
```
TABOOLA_CLIENT_ID=您的客户端ID
TABOOLA_CLIENT_SECRET=您的客户端密钥
```
4. **测试连接器**
运行脚本以验证它是否正确连接到Taboola：
```bash
python taboola_connector.py
```
您应该会看到日志指示身份验证和账户加载成功。
## 与Cursor一起使用
1. **将连接器添加到Cursor的MCP配置中**
打开或创建用户目录中的`.cursor/mcp.json`，并添加以下条目：
```json
{
"mcpServers": {
"Taboola_Connector": {
"command": "FULL/PATH/TO/YOUR/DIRECTORY/taboola_mcp/.venv/Scripts/python",
"args": [
"FULL/PATH/TO/YOUR/DIRECTORY/taboola_mcp/taboola_connector.py"
]
}
}
}
```
2. **重启Cursor**
关闭并重新打开Cursor以加载更新的MCP配置。
3. **验证连接**
在Cursor的聊天中，询问一个简单的问题，如“列出我的Taboola账户”，以验证连接是否正常。
## 可用工具
连接器提供了以下工具来与Taboola交互：
| 工具名称 | 描述 | 示例查询 |
|-----------|-------------|---------------|
| `list_taboola_accounts` | 列出所有可访问的Taboola账户 | "显示我所有的Taboola账户" |
| `taboola_account_overview` | 提供账户的综合概述 | "给我一个wattfoxgmbh-network账户的概述" |
| `get_taboola_account_currency` | 获取账户的货币代码 | "我的Taboola账户使用什么货币？" |
| `list_taboola_campaigns` | 列出账户中的所有活动 | "列出wattfoxgmbh-network账户中的所有活动" |
| `get_taboola_campaign_summary` | 获取活动的绩效总结 | "总结四月份的活动绩效" |
| `get_taboola_campaign_details` | 获取特定活动的详细信息 | "显示活动44471496的详细信息" |
| `analyze_taboola_performance` | 分析活动绩效并提供详细指标 | "分析4月1日至4月23日的活动绩效" |
| `get_taboola_creatives` | 列出账户中的所有创意资产 | "显示我的Taboola账户中的所有创意资产" |
| `get_taboola_creative_details` | 获取特定创意资产的详细信息 | "显示创意资产123456的详细信息" |
| `analyze_taboola_creative_performance` | 分析创意资产绩效并提供指标 | "哪些创意资产在上个月表现最佳？" |
| `get_taboola_ads` | 列出所有广告或特定活动的广告 | "显示活动44471496中的所有广告" |
| `download_taboola_creative` | 从URL下载创意资产 | "下载https://example.com/image.jpg处的创意资产" |
## 示例查询
您可以以自然语言提问，如：
- "显示我过去30天的Taboola活动绩效。"
- "上个月哪些活动表现最佳？"
- "列出所有正在进行的Taboola活动。"
- "给我一个账户绩效总结，并附图表。"
- "分析6月1日至6月30日的活动数据。"
- "哪些活动的点击率在上周最高？"
## 故障排除
### 连接问题
- **"TaboolaConnector不可用"**：检查您的`.env`文件是否存在正确的凭证。
- **找不到Python命令**：确保`.cursor/mcp.json`中的Python路径正确指定。
- **无可用工具**：通过检查`taboola_mcp.log`中的日志，确保MCP服务器正确运行。
### 身份验证错误
- **客户端凭证错误**：验证您的`TABOOLA_CLIENT_ID`和`TABOOLA_CLIENT_SECRET`是否正确。
- **未找到账户**：检查您的API凭证是否具有访问您正在查询的账户的权限。
### 路径问题
- 如果您看到找不到文件的错误，请确保您的配置中的所有路径都是绝对路径（不是相对路径）。
## 技术细节
连接器与Taboola API通信以检索活动数据，并通过MCP工具公开这些数据。这允许AI助手查询和分析您的广告数据。
连接器遵循以下步骤：
1. 与Taboola API进行身份验证
2. 获取可用账户
3. 提供查询活动数据的工具
4. 处理和格式化数据，以便AI助手轻松使用
## 贡献
如果您想为此项目做出贡献，发现了错误或问题，请打开一个问题或提交拉取请求 :)
## 许可证
MIT 许可证
