shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

千川抖店日报一键生成

自动抓取巨量千川、抖店等经营数据，写入飞书表格，并生成每日经营日报。

personAuthor: zhitaog500-proghubclawhub
open_in_newRepositorydownloadDownload package

千川抖店日报一键生成

每天还在手动打开千川后台、复制消耗、GMV、成交、退款、ROI，再一项项粘到飞书表格里？

这个 Skill 可以自动读取巨量千川、抖店相关经营页面的数据，匹配到飞书表格字段，并辅助生成每日经营日报。适合店铺运营、投放优化、直播电商团队做日报、复盘和数据归档。

一次配置后，每天运行一次命令，就能完成数据抓取、表格填写和日报整理。

你能省下什么

| 工作 | 手动整理 | 使用 Skill | | --- | --- | --- | | 打开后台查数据 | 5-10 分钟 | 自动完成 | | 复制千川消耗、GMV、退款、ROI | 10-20 分钟 | 自动写入 | | 检查分页和总计是否漏数 | 5-10 分钟 | 自动识别总计行 | | 填写飞书日报表格 | 10-20 分钟 | 自动匹配字段 | | 生成日报留档 | 10 分钟 | 可选自动生成 |

如果你每天都要整理投放和店铺日报，它可以把半小时左右的重复工作压缩到几十秒。

核心功能

  • 自动打开指定的巨量千川经营数据页面。
  • 复用用户已经授权的登录态读取页面数据。
  • 自动读取账户数据、页面总计数据和关键经营指标。
  • 优先识别 共N个账户 这类总计行，避免只抓第一页导致漏数。
  • 自动整理千川消耗、GMV、成交金额、退款、ROI 等指标。
  • 自动写入飞书表格对应字段。
  • 支持按日期更新每日数据，适合固定时间做经营日报。
  • 可选生成 CSV 和 Markdown 报表，方便核对和归档。

适合谁用

  • 每天要填千川、抖店、商城或直播经营日报的运营同学。
  • 需要把后台数据同步到飞书表格的投放同学。
  • 需要定期复盘 GMV、消耗、退款、ROI 的店铺负责人。
  • 想减少手动复制、分页漏数、公式错填的团队。

可采集的数据示例

根据页面实际字段，可采集并整理：

  • 千川消耗
  • GMV
  • GSV
  • 用户实际支付金额
  • 智能优惠券金额
  • 平台补贴金额
  • 成交订单数
  • 成交金额
  • 净成交金额
  • 退款金额
  • 退款率
  • ROI
  • 店铺日报需要的其他经营指标

使用效果

这个 Skill 的重点不是“抓网页”，而是把经营日报里最容易出错的部分自动化：

  • 不再逐个复制后台字段。
  • 不再因为分页只看第一页而漏数。
  • 不再手动找飞书表格对应单元格。
  • 不再每天重复做同一份日报。

安全边界

  • 默认只允许抓取 https://business.oceanengine.com/... 下的页面。
  • 只读取配置选择器命中的表格内容，不读取整个网页正文。
  • 飞书凭证只能通过环境变量提供，不能写入 config.json。
  • 写入飞书会修改目标表格，运行前必须设置 CONFIRM_WRITE_FEISHU=1 作为显式确认。
  • 默认不生成本地 CSV 或 Markdown 文件。确需本地留档时，需在 config.json 中设置 generateReports=true。
  • STORAGE_STATE_BASE64 只在内存中解析，不会写入磁盘。
  • 如果要读取本地 storage_state.json，必须在 config.json 中设置 allowLocalStorageState=true。

配置要求

运行前需要准备：

  • Node.js 运行环境。
  • Playwright 浏览器依赖。
  • 用户本人已授权的巨量千川登录态。
  • 飞书开放平台应用的 FEISHU_APP_ID 和 FEISHU_APP_SECRET。
  • 目标飞书表格的 spreadsheetToken 和对应工作表 ID。

安装依赖

npm install
npx playwright install chromium
cp config.example.json config.json

环境变量

Linux 或 macOS：

FEISHU_APP_ID=your_feishu_app_id
FEISHU_APP_SECRET=your_feishu_app_secret
CONFIRM_WRITE_FEISHU=1
STORAGE_STATE_BASE64=base64_encoded_playwright_storage_state

Windows PowerShell：

$env:FEISHU_APP_ID="your_feishu_app_id"
$env:FEISHU_APP_SECRET="your_feishu_app_secret"
$env:CONFIRM_WRITE_FEISHU="1"
$env:STORAGE_STATE_BASE64="base64_encoded_playwright_storage_state"

配置文件

复制 config.example.json 为 config.json，然后填写：

  • targetUrl：要抓取的数据页面，必须是 https://business.oceanengine.com/...。
  • feishu.spreadsheetToken：飞书表格 token。
  • feishu.sourceSheetId：数据源工作表 ID。
  • feishu.summarySheetId：汇总工作表 ID。
  • feishu.reportSheetId：日报工作表 ID。
  • feishu.summarySpendRange：需要写入消耗数据的单元格范围。
  • feishu.reportDateCell：日报日期单元格。
  • generateReports：是否生成本地 CSV 和 Markdown 报表，默认 false。
  • allowLocalStorageState：是否允许读取本地 storage_state.json，默认 false。

运行方式

node index.js

运行完成后会输出：

  • 抓取到的数据条数。
  • 是否生成本地报表。
  • 飞书表格写入结果。

注意事项

  • 不同后台页面的字段名称可能不同，需要根据目标表格字段做映射。
  • 如果网页改版，需要重新核对选择器和字段。
  • 如果日报模板公式发生变化，需要同步更新配置中的单元格范围。
  • 如果登录态过期，需要由用户重新生成 Playwright storage state。
  • 不要发布或提交 storage_state.json、config.json、生成的报表或任何密钥。