正文共： 3344字 7图

预计阅读时间： 9分钟

这两天研究了一个好玩儿的东西，就是下面这个流量主收益播报助手。

它可以实现以下功能：

1. 无需来回切换，一个站点查看所有账户（公众号和小程序）的收益情况

2. 定时推送收益数据（日报、周报、月报）到指定邮箱

3. 支持自定义时间周期查看账户收益数据

4. 可视化看板，数据、趋势一目了然

---

公众号流量主和小程序流量主，一般情况下，每天上午会更新前一天的收益情况，并推送到绑定的管理员或者运营者的微信账户。

但是有一个比较尴尬的情况，每天推送的时间并不固定，并且当账号比较多的时候，一个个查看非常麻烦。

如果点进去一看收益再是几毛几分的，更是糟心。

收益还抵不上点进去浪费的那几十秒钟时间。

---

看到MiniApp俱乐部群里的大佬一会儿就鼓捣出来这个定时播报的程序，有点心痒痒。

空下来和AI唠了两天，终于搞定了现在的版本。

使用的IDE是Trae，模型是Gemini3.1，初版连开发带部署差不多2个小时搞定了。

后面陆续调试优化，获取秘钥的时候顺便统计了账号的信息，用了两个晚上的时间。

现在已经能够实现按照指定要求拉取公众号和小程序的数据。

所需要做的事情，就是把代码部署好，完事儿维护下公众号和小程序的AppID、AppSecret。

另外再配置好接收信息的邮箱、定时发送的时间点

现在测试下来，数据都没啥问题，加载速度也很快。

最开始的版本应该是我提示词给的有问题，代码逻辑冗余，导致获取速度一度需要几十秒甚至一分钟。

现在获取任意区间的数据，只需要一眨眼也就两秒钟的功夫。

并且定时任务也能够正常生效，每天也不用等待刮彩票了，到点儿去邮箱里看看数据就完事儿。

除了概览数据，也会推送每个账户的详细数据。

对于号比较多的人来说，这个功能确实挺有用的，省心省事儿。

后续研究研究如果需要新功能也随时能加上去。

---

原本计划是再部署一个SaaS平台，搞个中心化的多用户系统。如果有想要使用这个功能的朋友，只需要注册账号，绑定自己的小程序/公众号，可以直接查看数据、接收系统定时发送的邮件。

但是因为这个功能需要比较敏感的信息（AppSecret），大多数人可能还是会有顾虑。

并且如果万一真的很多非技术背景的朋友有需求，服务器IP可能也会存在一定的风险。

索性放弃。

不过花了几分钟搞成了私有化部署的版本，可以将程序直接部署到自己的服务器上。

数据和AppSecret这些敏感信息都在用户自己手里，不存在数据泄露和信任问题。

不懂代码怎么放到GitHub上面，也不知道上面是不是已经有类似的资源。

我把源码打包好放到WaytoOPC星球上去了，感兴趣并且有条件的朋友可以去试一试。

我是数字游民9527，一个沉迷于AI世界的普通人。

我在努力践行「把自己产品化」的理念，通过「Build in public & Learn in Public」的方式尝试建立个人品牌。

我希望通过直接下场行动的方式，验证普通人如何通过AI实现商业化实践，追求个体的财富与幸福。

我的互联网简历：🔍数字游民9527

期待与更多同频伙伴一同前行。

---

以下是完整的项目说明文档

微信流量主合并播报助手 (WeChat Ads Publisher Dashboard)

📖 项目简介

“微信流量主合并播报助手”是一款专为拥有多个微信小程序和公众号的开发者/运营者打造的聚合数据看板和自动化报表工具。
它旨在解决多账号运营中数据查看繁琐、收益统计耗时的问题，通过统一的 Web 界面和自动化的邮件播报功能，极大提升数据分析和监控的效率。

✨ 核心功能

1. 1. 多账号聚合管理：

   • • 支持同时绑定多个微信小程序和公众号。

   • • 自动隐藏 AppSecret，提供高安全性的本地数据存储。

2. 2. 可视化数据看板：

   • • 支持查看昨日、过去7天、过去30天、历史总收入及自定义日期区间的数据。

   • • 包含收益趋势折线图（支持按“仅小程序”、“仅公众号”或“全部”筛选）。

   • • 详细数据卡片化展示：预估收入、曝光量、点击量、点击率、eCPM 核心指标一目了然。

   • • 核心指标自动计算“同比上期”增长率。

3. 3. 自动化定时播报：

   • • 支持配置灵活的日报、周报、月报自动发送时间。

   • • 邮件采用响应式 HTML 设计（Bauhaus 风格），支持移动端和 PC 端完美阅读。

4. 4. 隐私与安全：

   • • 提供管理员账号体系，限制未授权访问。

   • • 提供“小眼睛”隐私开关，可一键隐藏所有账号名称，方便随时截图分享数据。

5. 5. 极简 UI 与夜间模式：

   • • 采用具有艺术感的 Bauhaus 风格，结合流畅的 CSS 动画。

   • • 前端采用 AJAX 异步加载，并带有骨架屏提示，告别页面白屏等待。

   • • 完美支持系统的深色/浅色模式自动切换。

🛠️ 技术栈

• • 后端：Python 3.8+, Flask, Flask-SQLAlchemy, Flask-Login

• • 异步处理：concurrent.futures.ThreadPoolExecutor (多线程 API 加速), threading

• • 定时任务：APScheduler (后台定时执行调度)

• • 数据存储：SQLite (轻量级本地数据库)

• • 前端：HTML5, TailwindCSS, Chart.js, FontAwesome, 原生 Fetch API

🚀 部署要求

• • 推荐使用 宝塔面板 (BT Panel) 进行一键式 Python 项目部署。

• • 服务器需要能够正常访问外网，并且配置 Asia/Shanghai 时区。

• • 重要提醒：公众号必须在微信公众平台后台将服务器 IP 加入“IP白名单”才能拉取数据。

� 核心 API 接口说明

本项目依赖微信官方提供的接口获取 Access Token 及流量主数据。

1. 获取 Access Token

• • 接口地址：GET https://api.weixin.qq.com/cgi-bin/token

• • 用途：换取调用业务接口所需的全局唯一接口调用凭据。

• • 参数：

  • • grant_type: 固定填 client_credential

  • • appid: 小程序或公众号的 AppID

  • • secret: 小程序或公众号的 AppSecret

• • 返回示例：

  {
    "access_token": "ACCESS_TOKEN",
    "expires_in": 7200
  }

2. 获取流量主数据 (Publisher Adpos General)

• • 接口地址：GET https://api.weixin.qq.com/publisher/stat?action=publisher_adpos_general

• • 用途：获取指定日期范围内的流量主广告收益明细。

• • 参数：

  • • access_token: 接口调用凭证

  • • page: 分页页码，从 1 开始

  • • page_size: 每页数量，建议填 100

  • • start_date: 开始日期，格式如 2023-01-01

  • • end_date: 结束日期，格式如 2023-01-07

  • • ad_slot: (可选) 广告位ID，不传则拉取该账号所有广告位的汇总数据。

• • 代码调用示例 (Python)：

  import requests
  
  url = "https://api.weixin.qq.com/publisher/stat"
  params = {
      "action": "publisher_adpos_general",
      "access_token": "YOUR_ACCESS_TOKEN",
      "page": 1,
      "page_size": 100,
      "start_date": "2023-10-01",
      "end_date": "2023-10-07"
  }
  
  response = requests.get(url, params=params)
  data = response.json()

• • 降级回退接口：
  由于微信针对不同账号（部分历史公众号）可能未开通新版接口，如果上述接口返回失败，本项目会自动降级请求旧版接口：action=publisher_biz_adpos_general，参数完全相同。

�📂 核心文件结构

• • app.py: 应用入口，包含路由逻辑、API 接口和数据计算逻辑。

• • models.py: 数据库 ORM 模型定义（管理员、账号、数据缓存、系统设置）。

• • wechat.py: 封装的微信官方 API 请求模块（包含多重回退和重试机制）。

• • tasks.py: 定时任务核心，多线程拉取数据并发送邮件。

• • mailer.py: 负责生成并发送精美的 Bauhaus 风格 HTML 邮件。

• • templates/: 前端 HTML 模板文件目录。