TzFilm Douyin Tool: automation for Hermes Agent

Hourly Douyin creator-data export for macOS with a Hermes Agent skill and Telegram push

What TzFilm Douyin Tool does

TzFilm Douyin Tool automates the manual routine of opening the Douyin creator center, switching to the post list, clicking export and analyzing the Excel file. A Python script of about 500 lines with embedded AppleScript drives Chrome, downloads the video list, parses it with openpyxl and writes it to SQLite, keeping historical snapshots so growth can be tracked. It records plays, likes, comments, shares, favorites, completion rate and CTR for the latest 100 videos, needs no API key, and runs hourly through a launchd plist.

For Hermes Agent users, the repository includes a SKILL.md operating manual that you copy to ~/.hermes/skills/douyin/. After that you can ask Hermes to pull the Douyin data and it follows the steps in the skill. Telegram push is enabled by adding TELEGRAM_BOT_TOKEN and TELEGRAM_HOME_CHANNEL to ~/.hermes/.env. Extra scripts track a new video every 30 minutes to predict final plays and export comments so an AI tool, Hermes among those named, can draft replies that Playwright then sends.

Key features

Exports the creator center post list and parses it into SQLite
Tracks plays, likes, comments, shares, favorites, completion rate and CTR
Hourly unattended runs through launchd
SKILL.md operating manual for Hermes Agent
Optional Telegram push through settings in ~/.hermes/.env
New-video tracker that predicts final plays, plus a comment export and reply workflow

When to use it

Keep an hourly history of Douyin video performance
Ask Hermes Agent to pull the latest Douyin data on demand
Export unreplied comments and have an AI draft replies

Who it is for: Douyin creators on macOS who want automated performance tracking that Hermes Agent can run for them.

How it fits with Hermes Agent

It is built around Hermes Agent: the SKILL.md goes into ~/.hermes/skills/douyin/, the launchd label is com.hermes.douyin-tracker, and the Telegram settings are added to ~/.hermes/.env.

How to install TzFilm Douyin Tool

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pip install openpyxl
git clone https://github.com/TradingAi666/TzFilm-Douyin-Tool.git
cd TzFilm-Douyin-Tool
python3 douyin_hourly.py

Requirements: macOS, and Google Chrome logged in to creator.douyin.com with Allow JavaScript from Apple Events enabled

Note: It is macOS only, automates Chrome through AppleScript, and needs a manual Douyin login on first run.

FAQ

What is TzFilm Douyin Tool?

TzFilm Douyin Tool is a macOS script set that exports video data from the Douyin creator center every hour, stores snapshots in SQLite and can push updates to Telegram. It uses AppleScript to drive Chrome and needs no API key.

Does TzFilm Douyin Tool work with Hermes Agent?

Yes. The README tells you to copy SKILL.md into ~/.hermes/skills/douyin/ and then ask Hermes to pull the Douyin data. Telegram push uses TELEGRAM_BOT_TOKEN and TELEGRAM_HOME_CHANNEL in ~/.hermes/.env.

How do I install TzFilm Douyin Tool?

Run pip install openpyxl, clone the repository and change into it, then run python3 douyin_hourly.py once. The first run opens Chrome so you can log in to the Douyin creator center.