📦 GOG Sales Analytics — GOG 销售分析

GOG 销售分析自动化工作流：抓取 GOG 折扣 → Gemini 分析 → Feishu Drive 报告。 它的作用是： 抓取 —— 从 GOG 目录 API（分页，无需认证）获取所有当前折扣游戏 分析 —— 将完整的折扣数据集发送到 Google Gemini 进行交易分析、趋势比较和预算推荐 上传 —— 将 Markdown 报告同步到 Feishu Drive 文件夹，使用正确的多部分上传

先决条件： Python 3.10+ 环境变量（在 .env 或环境中设置）： GEMINI_API_KEY —— Google Gemini API 密钥 FEISHU_APP_ID —— Feishu 应用 ID FEISHU_APP_SECRET —— Feishu 应用密钥 FEISHU_DRIVE_FOLDER_ID —— 目标 Feishu Drive 文件夹令牌

使用方法： pip install -r requirements.txt python main.py 或导入单个模块： from scraper.gog_api_scraper import scrape_and_save from analysis.gemini_analyzer import analyze_sales_data from sync.feishu_upload import upload_file_to_feishu sales_file = scrape_and_save() report_file = analyze_sales_data(sales_file) url = upload_file_to_feishu(report_file, folder_id)

文件结构： ├── main.py # 工作流协调器 ├── scraper/ │ └── gog_api_scraper.py # GOG 目录 API 抓取器 ├── analysis/ │ └── gemini_analyzer.py # Gemini 分析器 ├── sync/ │ └── feishu_upload.py # Feishu Drive 上传器 ├── requirements.txt ├── .env.example └── SKILL.md

注意： GOG 目录 API 无需认证 Gemini 分析处理完整的折扣数据集（无截断） Feishu 上传使用 upload_all 多部分端点 抓取有速率限制（0.5s 之间的页面）