MCN Script Assistant

MCN 商单脚本生成助手 — 从品牌 brief 到飞书文档的 AI 全流程自动化。

适用场景：品牌方/ MCN 机构为小红书达人制作商单脚本，确保内容自然种草、合规安全、高效交付。

---

项目结构

/
├── README.md                               # 本文件
├── report.md                               # 调研与方案报告
├── prompts/                                # AI Agent Prompt
│   ├── 01-brief-deconstruct.md             # Step 1: Brief 拆解
│   ├── 02-style-analysis.md                # Step 2: 内容风格分析
│   ├── 03-script-generate.md               # Step 3: 脚本生成
│   ├── 04-compliance-check.md              # Step 4: 风险质检
│   └── 05-feishu-write.md                  # Step 5: 飞书文档写入
├── references/                             # 小红书调研资料
│   ├── blogger-profiles.md                 # 博主调研档案
│   └── content-breakdown.md                # 内容风格拆解
├── skills/mcn-script-assistant/
│   └── SKILL.md                            # 可复用 Skill
├── feishu/                                 # 飞书接入
│   ├── writer.py                           # 自动化写入脚本
│   ├── config.json                         # API 凭证（不提交）
│   └── config.example.json                 # 配置模板
└── output/                                 # 最终交付物
    ├── final-script.md                     # 完整脚本
    ├── storyboard.md                       # 分镜表
    └── compliance-report.md                # 合规质检报告

---

快速开始

1. 安装依赖

pip install requests

2. 配置飞书凭证

1. 前往 飞书开放平台 创建企业自建应用
2. 开通权限：docx:document、drive:drive
3. 发布应用上线
4. 复制 feishu/config.example.json 为 feishu/config.json，填入真实凭证：

{
  "app_id": "cli_xxxxxxxxxxxxxxx",
  "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "doc_token": "文档Token（可选，writer.py 会自动创建新文档）"
}

3. 运行完整 AI 工作流

export DEEPSEEK_API_KEY="your-api-key"
python main.py --brief brief.md --blogger references/blogger-profiles.md

Pipeline 会依次执行 5 步（Brief 拆解 → 风格分析 → 脚本生成 → 合规质检 → 飞书写入），中间产物保存在 output/ 目录。

4. 仅运行飞书文档写入

如果已有脚本文件，可单独写入飞书：

python feishu/writer.py
# 或指定文件
python feishu/writer.py --script output/final-script.md --storyboard output/storyboard.md --compliance output/compliance-report.md

---

工作流说明

本项目设计了一个 5 步 AI Agent Pipeline：

步骤	功能	输入	输出
Step 1	Brief 拆解	客户原始 brief	结构化创作简报 + 合规红线清单
Step 2	风格分析	博主内容样本	风格指纹（钩子/节奏/镜头/口播）
Step 3	脚本生成	创作简报 + 风格指纹	完整脚本 + 分镜表
Step 4	风险质检	脚本 + 合规清单	质检报告（通过/不通过）
Step 5	飞书写入	脚本 + 分镜 + 质检报告	飞书文档链接

每个步骤的详细 Prompt 见 prompts/ 目录。

---

飞书文档接入

自动化方式

feishu/writer.py 通过飞书开放平台 API 实现：

1. 使用 App ID + App Secret 获取 tenant_access_token
2. 调用 POST /open-apis/docx/v1/documents 创建文档
3. 分批写入内容 blocks（heading / paragraph / 分隔线）
4. 输出文档链接

最终飞书文档

链接：https://xcnfvm8aee87.feishu.cn/docx/Aeq7dPcDVoKgtCxwKVMcLy5vnUc

该文档由 writer.py 自动化创建并写入，非手动复制粘贴。

---

测试案例：轻醒 × 凌二七

本项目以虚拟品牌「轻醒」0蔗糖高蛋白希腊酸奶为例，完成了完整的博主调研与脚本生成：

• 品牌：轻醒（轻食酸奶）
• 产品：0蔗糖高蛋白希腊酸奶（原味/蓝莓/黄桃）
• 调研博主：3 位候选（凌二七 / Yorifufu / ssikme），经多维度对比后选择凌二七，详见 references/blogger-profiles.md
• 最终选择：凌二七（干净饮食食谱博主，2.1万粉丝）
• 平台：小红书短视频
• 脚本时长：~95s / 16镜
• 版本：v2.0（基于博主真实逐字稿校准）
• 合规结果：18/18 项检查全部通过

---

使用工具

• AI 模型：Claude Code（调研/脚本生成/飞书集成）+ Prompt 设计兼容 DeepSeek/其他 LLM
• 飞书 API：文档自动创建与写入（飞书开放平台 docx API）
• 调研工具：小红书 App + 录屏 ASR 转写（一手信源）
• 脚本语言：Python 3

问题排查记录

开发过程中遇到的权限、API 限制及解决方案，详见 report.md 第七章，包括：

问题	解决方案
小红书静态页面反爬	改用 App 录屏 + ASR 转写获取真实逐字稿
脚本 v1.0 基于推测而非真实数据	v2.0 基于三条视频完整逐字稿重写
飞书表格 API 格式复杂	改用结构化段落排版替代表格
飞书手动创建的文档 App 无写入权限	改用 API 创建新文档，App 自动获得权限
飞书批量写入上限 50 blocks	实现自动分批写入
飞书 bullet/divider block 不支持	改用段落 block + 文本前缀模拟

---

License

本项目为求职面试测试题交付物，仅供评估使用。