一个专业的微信公众号运营数据分析系统，支持多账号数据管理、深度分析和飞书同步。
- 多维度指标: 阅读量、分享量、完成率、转化率等20+运营指标
- 高级分析: 病毒传播系数、内容质量评分、用户留存分析
- 趋势洞察: 数据变化趋势、异常检测、预测分析
- 统一平台: 单一界面管理多个微信公众号数据
- 账号对比: 横向对比不同账号的运营表现
- 数据隔离: 按账号独立存储和分析数据
- Excel导入: 支持微信公众号后台导出的.xls/.xlsx文件
- 智能识别: 自动识别账号名称和数据结构
- 批量处理: 支持大批量数据导入和更新
- 实时同步: 自动将分析结果同步到飞书多维表格
- 动态字段: 包含账号标识，支持多账号数据区分
- 在线分析: 在飞书中进行进一步的数据透视和分析
- 统一仪表板: 集数据上传、分析、对比于一体的现代化界面
- 响应式设计: 支持桌面端和移动端访问
- 实时更新: 数据变化实时反映在界面上
# 克隆项目
git clone https://github.com/your-username/WeChatOfficialAccount.git
cd WeChatOfficialAccount
# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate # Linux/Mac
# 或
venv\Scripts\activate # Windows
# 安装依赖
pip install -r requirements.txt- 前往飞书开放平台创建应用
- 获取
App ID和App Secret - 添加多维表格权限
- 在
.env文件中配置:
# 复制环境变量模板
cp .env.example .env
# 编辑配置文件，填入飞书应用信息
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_FOLDER_TOKEN=your_folder_token # 可选# 启动统一仪表板
export PYTHONPATH=. && python src/unified_dashboard.py
# 访问 http://localhost:8888WeChatOfficialAccount/
├── src/ # 源代码目录
│ ├── unified_dashboard.py # 🎯 统一Web仪表板
│ ├── import_wechat_articles.py # 📤 数据导入模块
│ ├── feishu_client.py # 📋 飞书API客户端
│ ├── data_sync.py # 🔄 数据同步逻辑
│ ├── wechat_analytics.py # 📊 数据分析引擎
│ └── utils.py # 🛠️ 工具函数
├── config/ # 配置文件
│ └── settings.py # 系统配置
├── scripts/ # 脚本文件
│ ├── deploy.sh # 部署脚本
│ └── start.sh # 启动脚本
├── tests/ # 测试文件
├── data/ # 数据存储目录（空）
├── sync_multi_account.py # 🚀 多账号飞书同步脚本
├── config.yaml # 应用配置
├── docker-compose.yml # Docker配置
└── README.md # 项目文档
- 获取数据: 从微信公众号后台导出文章数据Excel文件
- 上传数据: 在Web界面的"📤 数据管理"标签页上传文件
- 自动处理: 系统自动解析数据并存储到数据库
- 查看结果: 在各个分析标签页查看处理结果
- 添加账号: 为不同的公众号上传对应的Excel文件
- 账号标识: 系统自动根据文件名识别账号名称，或手动输入
- 横向对比: 在"🔄 多账号对比"标签页查看账号间的对比分析
- 独立分析: 每个账号都有独立的详细分析页面
上传数据后，系统会提示是否同步到飞书
# 同步所有账号数据到飞书
export PYTHONPATH=. && python sync_multi_account.py同步完成后，访问飞书链接查看在线数据表格，支持：
- 按账号筛选数据
- 创建数据透视表
- 生成图表报告
- 团队协作分析
# 导入单个账号数据
export PYTHONPATH=. && python src/import_wechat_articles.py \
--file xiaoshi_sample.xlsx \
--account "小石的AI智能体工坊"
# 查看导入帮助
python src/import_wechat_articles.py --help# 多账号分析
export PYTHONPATH=. && python src/analyze_multi_accounts.py
# 单账号分析
python src/analyze_multi_accounts.py --account "账号名称"- 内容标题
- 发表时间
- 总阅读人数
- 总阅读次数
- 总分享人数
- 总分享次数
- 阅读后关注人数
- 送达人数
- 效率指标: 送达率、阅读完成率、首次分享率
- 用户行为: 重复阅读率、分享转化率、关注转化率
- 内容质量: 内容质量评分、标题吸引力评分
- 传播效率: 病毒传播系数、分享效率、传播深度
- 标题长度和词汇分析
- 情感词汇检测
- 数字和特殊符号统计
- 内容类型自动分类
# 构建并启动
docker-compose up -d
# 查看日志
docker-compose logs -f
# 停止服务
docker-compose down# 运行所有测试
pytest tests/ -v
# 运行特定测试
pytest tests/test_wechat_mp_scraper.py -v
# 运行集成测试
pytest tests/test_integration_e2e.py -v无法访问Web界面:
# 检查端口是否被占用
lsof -i :8888
# 更换端口启动
python src/unified_dashboard.py --port 8080飞书同步失败:
# 验证配置
python -c "
from src.feishu_client import FeishuClient
client = FeishuClient()
print('认证结果:', client.authenticate())
"Excel文件导入错误:
- 确保Excel文件包含必需的字段
- 检查文件编码是否正确
- 验证数据格式是否符合要求
# 启用详细日志
export LOG_LEVEL=DEBUG
# 非后台运行查看详细输出
python src/unified_dashboard.py- 支持批量导入（每批5条记录）
- 异步处理避免界面阻塞
- 数据库索引优化查询性能
- SQLite轻量级数据库
- 分页加载大量数据
- 及时释放临时文件
- 本地SQLite数据库存储
- 飞书API安全认证
- 环境变量管理敏感信息
- 上传文件安全验证
- Web界面本地访问
- 文件上传类型限制
- SQL注入防护
欢迎提交Issue和Pull Request来改进这个项目！
- Fork 项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交改动 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
如果你觉得这个项目有用，请给它一个 ⭐️！
如有问题或建议，请通过以下方式联系：
- 提交 Issue
- 发送邮件到 [your-email@example.com]
- DEPLOYMENT.md: 详细部署指南
- CLAUDE.md: 开发配置和规范
Ultrathink AI视频号运营分析系统 - 让数据驱动你的内容运营决策！
- 📤 数据管理: 拖拽上传Excel文件，自动识别账号
- 📊 运营总览: 多账号汇总数据和核心指标对比
- 🔄 多账号对比: 详细的账号间横向对比分析
- 📱 单账号分析: 每个账号的深度运营分析
- 🎯 核心指标卡片显示
- 📈 数据表格排序和筛选
- 🏆 最佳表现指标标识
- 💡 运营洞察和建议
- 🔗 一键同步到飞书多维表格
- 📋 支持账号字段区分
- 📊 在线数据透视分析
- 👥 团队协作和共享