This duck helps you byDouyin account + publish time windowpull the work list — keep an eye on the benchmark accounts you subscribe to every day, discover what new works they posted as soon as possible, and do follow-up reviews.
Data goes through doubaoya.com one line, authentication uses your own token (environment variable
DOUBAOYA_API_KEY, in the formdyh_…)。
Get the key (token)
- Open doubaoya.com
- Log in
- go to Token Center
- Generate token(in the form
dyh_…)
export DOUBAOYA_API_KEY="dyh_你的口令"
Iron rule: the token must never be printed, never written to a file, never echoed back to the user. The script itself also never outputs the token. All requests are sent only to doubaoya.com。
Run the script
Zero dependencies, the standard library is enough (Python 3).
# 默认:拉今天 00:00:00 ~ 23:59:59 该抖音号的新作品
python3 "$SKILL_PATH/scripts/fetch_work_list.py" --account-id 样例抖音号
# 指定发布时间窗口
python3 "$SKILL_PATH/scripts/fetch_work_list.py" --account-id 样例抖音号 --start "2026-06-23 00:00:00" --end "2026-06-23 23:59:59"
| Parameter | Description | Default |
|---|---|---|
--account-id |
Douyin account (required) | — |
--start |
Publish time window start "YYYY-MM-DD HH:MM:SS" |
Today 00:00:00 |
--end |
Publish time window end "YYYY-MM-DD HH:MM:SS" |
Today 23:59:59 |
The script prints the data from the success envelope as JSON to stdout.Run the script only once each time, and read the entire stdout.
⚠️
--account-idIf it isa realDouyin account, the time window must also bea real date(the default is the whole day today) — do not make up a Douyin account or invent a date to "try it out". When you do not have an exact Douyin account on hand, first ask the user for a real Douyin account.
Workflow (3 steps)
- Set the Douyin account + time window: by default pull the whole day today; for daily update monitoring, run the default window once every day.
- Call the script to get data: works are in
data.items, each item containstitle(title),accountName(account name),workUrl(work link). - Lay out the new works table + give a follow-up reminder: lay it out as a Markdown table, and after the table add a sentence in this duck's tone — what this account updated today, whether it hit a new hot topic, and whether it is worth following up with one right away.
| Title | Account | Link |
|---|---|---|
| … | … | … |
Read fields defensively (leave blank if missing). If there are no new works within the window, truthfully state "no update today".
API contract
POST https://doubaoya.com/api/apis/douyin/douyin-work-list/call- Auth header:
Authorization: Bearer $DOUBAOYA_API_KEY - Request body:
{ "accountId": "样例抖音号", "publishTimeStart": "2026-06-23 00:00:00", "publishTimeEnd": "2026-06-23 23:59:59" } - Return envelope:
{ "success": true, "requestId": "...", "data": { "items": [ { "title": "...", "accountName": "...", "workUrl": "..." } ] }, "error": null } - First check
success: if it istruethen readdata; otherwise readerror.code/error.message。
Error code
When the script fails, it prints [error] CODE: message to stderr and exits with exit code 1.
| HTTP | code | Meaning | Handling |
|---|---|---|---|
| 401 | MISSING_API_KEY / UNAUTHORIZED |
No token provided or the token is invalid | Check DOUBAOYA_API_KEY, go to the token center to regenerate |
| 400 | VALIDATION_ERROR |
Invalid parameters (e.g., Douyin ID is empty) | Fix --account-id / retry with a different time window |
| 402 | INSUFFICIENT_CREDITS |
Insufficient quota | Go to doubaoya.com to top up/renew |
| 502 | PROVIDER_FAILED |
Temporary upstream failure (automatic refund issued) | safe to retry |
Directory structure
douyin-subscribe/
├── SKILL.md # 本文件
└── scripts/
└── fetch_work_list.py # 零依赖脚本(urllib),调用 doubaoya.com
FAQ
Q: How do I do daily updates?
A: Just run the default window (the whole day today) once a day; to backfill history, change --start / --end。
Q: No works within the window? A: This means that account had no updates that day; just report it truthfully.
Q: It reports 502 PROVIDER_FAILED?
A: Temporary upstream flakiness; the system has already issued an automatic refund, so just rerun it directly.