SuperAPI AI Directory

douyin-subscribe

General & other

View repository

Updated 10-16 08:41

About this skill

Douyin subscription follow-up · Pull works by Douyin account (DouBaoYa)

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 form dyh_…)。


Get the key (token)

  1. Open doubaoya.com
  2. Log in
  3. go to Token Center
  4. 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-id If 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)

  1. Set the Douyin account + time window: by default pull the whole day today; for daily update monitoring, run the default window once every day.
  2. Call the script to get data: works are in data.items, each item contains title(title),accountName(account name),workUrl(work link).
  3. 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 is true then read data; otherwise read error.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.