winner12-copywriter-mcp/README.md

MCP tool for generating social media content for winner12 AI football prediction website

# Winner12 Copywriter MCP

一个专为 Winner12 AI 足球预测网站设计的 MCP (Model Context Protocol) 工具，用于生成针对不同社交媒体平台的专业文案内容。

## 🚀 功能特点

- **5 个平台支持**: TikTok、YouTube、Facebook、Instagram、Twitter
- **AI 驱动**: 基于足球预测数据智能生成内容
- **平台优化**: 每个平台的内容都按照其特点和限制进行优化
- **中文友好**: 专为中文社交媒体内容设计
- **置信度感知**: 根据预测置信度调整内容风格
- **完整显示**: 生成的文案内容直接在 Claude Desktop 主回答中显示，包含详细信息和统计数据

## 📦 安装

### 通过 npm 安装

```bash
npm install -g winner12-copywriter-mcp
```

### 本地开发安装

```bash
git clone <this-repo>
cd winner12-copywriter-mcp
npm install
npm run build
```

## ⚙️ Claude Desktop 配置

在你的 Claude Desktop 配置文件中添加：

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "winner12-copywriter": {
      "command": "npx",
      "args": ["winner12-copywriter-mcp"]
    }
  }
}
```

配置完成后重启 Claude Desktop。

## 🛠️ 可用工具

### 1. `generate_tiktok_copy`
生成 TikTok 短视频文案
- **特点**: 简短有力、表情符号丰富、热门标签
- **长度限制**: 150 字符
- **风格**: 激动人心、吸引眼球

### 2. `generate_youtube_copy` 
生成 YouTube 视频标题和描述
- **特点**: 标题 + 详细描述格式
- **长度限制**: 标题 100 字符，描述 5000 字符
- **风格**: 专业详细、SEO 友好

### 3. `generate_twitter_copy`
生成 Twitter 推文串
- **特点**: 推文串格式、话题标签
- **长度限制**: 每条推文 280 字符
- **风格**: 简洁自信、数据驱动

### 4. `generate_instagram_copy`
生成 Instagram 帖子内容
- **特点**: 视觉导向、丰富标签、互动性强
- **长度限制**: 2200 字符
- **风格**: 轻松友好、视觉化描述

### 5. `generate_facebook_copy`
生成 Facebook 帖子内容
- **特点**: 互动性强、详细分析、行动号召
- **长度限制**: 2000 字符
- **风格**: 友好随和、社区感强

## 📊 输入参数

每个工具都接受相同的输入参数：

```typescript
{
  homeTeam: "主队名称",           // 必填
  awayTeam: "客队名称",           // 必填
  prediction: "预测结果",         // 必填：如 "主胜"、"客胜"、"平局"
  confidence: 85,                // 必填：置信度 0-100
  matchDate: "2024-01-15",       // 必填：比赛日期 YYYY-MM-DD
  league: "英超",                // 必填：联赛名称
  odds: {                        // 可选：赔率信息
    home: 2.1,
    away: 3.2,
    draw: 3.0
  }
}
```

## 💡 使用示例

在 Claude Desktop 中，你可以这样使用：

```
请帮我生成一个 TikTok 文案，参数如下：
- 主队：曼城
- 客队：利物浦
- 预测：主胜
- 置信度：78
- 比赛日期：2024-02-15
- 联赛：英超
```

或者生成多个平台的内容：

```
请为曼城 vs 利物浦的比赛生成所有平台的文案，预测主胜，置信度 85%
```

## 🎯 内容特色

### 智能内容适配
- **高置信度** (>80%): 强调推荐、突出数据支撑
- **中等置信度** (60-80%): 平衡分析、谨慎推荐  
- **低置信度** (<60%): 仅供参考、提醒风险

### 平台特色优化
- **TikTok**: 短小精悍、视觉冲击
- **YouTube**: 专业详细、教育性强
- **Twitter**: 数据导向、讨论性强
- **Instagram**: 视觉友好、社区互动
- **Facebook**: 详细分析、用户友好

### 品牌一致性
- 统一的 Winner12 品牌标识
- 一致的 AI 预测主题
- 专业的足球术语使用

## 🔧 开发

### 本地运行
```bash
npm run dev          # 开发模式运行
npm run build        # 编译 TypeScript
npm start            # 运行编译后的服务器
```

### 项目结构
```
src/
├── server.ts                    # MCP 服务器主文件
├── types/
│   └── prediction.ts           # 类型定义
├── tools/
│   ├── tiktok-generator.ts     # TikTok 工具
│   ├── youtube-generator.ts    # YouTube 工具
│   ├── twitter-generator.ts    # Twitter 工具
│   ├── instagram-generator.ts  # Instagram 工具
│   └── facebook-generator.ts   # Facebook 工具
└── templates/
    └── content-templates.ts    # 内容模板
```

## 📝 许可证

ISC

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📞 支持

如果你在使用过程中遇到问题，请：

1. 检查 Claude Desktop 配置是否正确
2. 确认 MCP 服务器已正确启动
3. 验证输入参数格式是否正确
4. 查看错误日志获取详细信息

---

**Winner12 Copywriter MCP** - 让 AI 为你的足球预测内容增色添彩！