# 📦 用户安装使用指南
> 本指南适用于想要使用 douyin-mcp-server 的最终用户
---
## ⚡ 快速安装（仅需 3 步）
### 第 1 步：安装包
打开命令提示符（cmd），运行：
```bash
pip install douyin-mcp-server
```
**就这么简单！** 无需下载代码，无需配置复杂环境。
---
### 第 2 步：获取豆包 API Key
1. 访问：https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey
2. 登录并创建 API Key
3. 复制生成的 API Key
---
### 第 3 步：配置 Cursor
1. 打开 Cursor
2. 进入设置（Ctrl + ,）
3. 搜索 "MCP"
4. 添加以下配置：
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "douyin-mcp-server",
"env": {
"DOUBAO_API_KEY": "你的豆包API密钥"
}
}
}
}
```
**⚠️ 重要说明：**
- 从 PyPI 安装后，使用命令 `douyin-mcp-server`（无需 `args`）
- 记得替换 `你的豆包API密钥` 为第 2 步获取的真实 API Key
5. 保存配置
6. 重启 Cursor
---
## 🎉 开始使用
在 Cursor 的聊天框中输入：
```
分析这个抖音视频：https://v.douyin.com/DGHl69ciWp4/
```
或者使用完整口令：
```
分析这个抖音：0.05 09/23 今年农户都不易啊 https://v.douyin.com/DGHl69ciWp4/ 复制此链接
```
AI 会自动：
1. ✅ 提取视频链接
2. ✅ 获取视频信息
3. ✅ 分析视频内容
4. ✅ 返回结构化结果
---
## 📖 使用场景
### 场景 1：分析烹饪教程
**输入：**
```
这是一个做菜视频，帮我整理食材和步骤：https://v.douyin.com/xxx/
```
**输出示例：**
```
✓ 成功提取链接
✓ 成功获取视频 URL
✓ 视频分析完成
【视频描述】
展示家常红烧肉的制作过程
【视频类型】
烹饪教程
【视频大纲与内容】
- 所需食材：
五花肉500g、冰糖30g、生抽2勺...
- 操作步骤：
1. 五花肉切块焯水去腥
2. 锅中炒糖色...
- 重点提示：
炒糖色时火候要掌握好...
```
---
### 场景 2：分析普通视频
**输入：**
```
这个抖音视频讲了什么：https://v.douyin.com/xxx/
```
**输出示例：**
```
【视频描述】
展示城市夜景和街头文化
【视频类型】
Vlog
【视频大纲与内容】
- 主要内容：博主在城市夜晚探索街头美食和文化
- 关键场景：夜市、街头艺人表演、特色小吃店
- 核心信息：展现城市多元文化和人文气息
```
---
## 🔄 更新
当有新版本发布时，更新很简单：
```bash
pip install --upgrade douyin-mcp-server
```
---
## 🗑️ 卸载
如果不再需要：
```bash
pip uninstall douyin-mcp-server
```
---
## ⚙️ 高级配置（可选）
### 自定义模型
如果想使用其他豆包模型，可以在配置中添加：
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "python",
"args": ["-m", "src"],
"env": {
"DOUBAO_API_KEY": "你的API密钥",
"DOUBAO_MODEL": "doubao-1.5-vision-pro-32k"
}
}
}
}
```
### 自定义 API 端点
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "python",
"args": ["-m", "src"],
"env": {
"DOUBAO_API_KEY": "你的API密钥",
"DOUBAO_API_ENDPOINT": "https://ark.cn-beijing.volces.com/api/v3/chat/completions"
}
}
}
}
```
---
## ❌ 常见问题
### 问题 1：安装失败
**错误：** `Could not find a version that satisfies the requirement`
**解决：**
```bash
# 升级 pip
python -m pip install --upgrade pip
# 重新安装
pip install douyin-mcp-server
```
---
### 问题 2：找不到 Python
**错误：** `'python' is not recognized`
**解决：**
1. 确保安装了 Python 3.10+
2. 安装时勾选 "Add Python to PATH"
3. 或使用 `python3` 替代 `python`
---
### 问题 3：Cursor 中无法使用
**检查清单：**
- [ ] 是否重启了 Cursor？
- [ ] API Key 是否正确填写？
- [ ] 配置 JSON 格式是否正确？
- [ ] 是否激活了虚拟环境？
**解决步骤：**
1. 检查 MCP 配置
2. 确认 API Key 有效
3. 完全关闭并重启 Cursor
4. 测试简单命令
---
### 问题 4：API Key 错误
**错误：** `未设置豆包 API Key`
**解决：**
- 确认在 MCP 配置的 `env` 中设置了 `DOUBAO_API_KEY`
- 确认 API Key 前后没有空格或引号
- 确认 API Key 有效且有余额
---
## 📊 版本信息
### 查看当前版本
```bash
pip show douyin-mcp-server
```
### 版本历史
- v1.0.0 - 初始发布
- 基础视频分析功能
- 支持 Cursor/VSCode
---
## 🆚 VSCode 用户
如果使用 VSCode with MCP，配置类似：
**配置文件位置：**
- Windows: `%APPDATA%\Code\User\settings.json`
- macOS: `~/Library/Application Support/Code/User/settings.json`
- Linux: `~/.config/Code/User/settings.json`
**配置内容（PyPI 安装）：**
```json
{
"mcp.servers": {
"douyin-analyzer": {
"command": "douyin-mcp-server",
"env": {
"DOUBAO_API_KEY": "你的API密钥"
}
}
}
}
```
---
## 💡 使用技巧
### 技巧 1：直接粘贴口令
不需要手动提取链接，直接粘贴完整的抖音口令即可。
### 技巧 2：批量分析
可以依次提供多个链接，AI 会逐个分析。
### 技巧 3：自定义需求
可以在提问时添加具体要求，如：
```
分析这个视频，重点关注食材用量和烹饪技巧：https://v.douyin.com/xxx/
```
---
## 🔗 相关链接
- **PyPI 项目页**：https://pypi.org/project/douyin-mcp-server/
- **GitHub 仓库**：https://github.com/yourusername/douyin-mcp-server
- **问题反馈**：https://github.com/yourusername/douyin-mcp-server/issues
- **豆包控制台**：https://console.volcengine.com/ark/
---
## 📞 获取帮助
### 方式 1：查看文档
- 本指南（用户安装使用指南.md）
- README.md
### 方式 2：提交 Issue
访问 GitHub Issues 页面，提供：
- 问题描述
- 错误信息（截图或文本）
- 系统信息（Python 版本、操作系统）
### 方式 3：社区讨论
- GitHub Discussions
- 相关社区论坛
---
## ⭐ 支持项目
如果觉得有用，请：
- ⭐ 在 GitHub 上给项目点星
- 📢 分享给朋友
- 🐛 报告 Bug
- 💡 提出建议
---
**感谢使用 douyin-mcp-server！** 🎉
如有问题，随时查阅文档或提交 Issue。祝使用愉快！
