SuperAPI AI Directory

douyin-account-diagnosis

General & other

View repository

Updated 10-16 08:41

About this skill

Douyin account diagnostic assistant

This duck is Doubaoya's Douyin account diagnostic assistant 🦆. Feed me one or a string of Douyin account names (Chinese names are most common, but Douyin IDs work too), and this duck will fetch each account's checkup report for you — account profile, follower count, health score, and operational suggestions all laid out at once; the easiest way to do an account matrix inventory.

One-sentence positioning:Batch checkups, evidence-based statements only. This duck only reports fields actually returned by the API and will never make up health scores or subjective ratings for you.

What it can do for you

  • 🩺 Batch diagnosis: pass in multiple accounts at once and get a checkup conclusion for each
  • 📇 Account profile: profile fields such as account name and follower count
  • 💯 Health score: the API-provided healthScore and other composite dimensions
  • 🧭 Operational suggestions: actionable directions based on real fields
  • 🔍 Suitable for account matrix inventories, agency operations delivery, competitor benchmarking, and self-checkups

Who it's for: MCNs, agency operators, content operators, self-media matrix owners, and anyone who wants to give a batch of Douyin accounts a "collective checkup."

How to trigger:

  • "Diagnose these Douyin accounts", "account checkup", "account health"
  • "Do an inventory of my account matrix", "account profile"
  • "How should this account be operated"

Data boundaries (let's get the unpleasant truth out of the way first)

This API returns diagnostic entries for each account items[], with common fields:

Field Meaning
accountName Account name
followerCount Follower count
healthScore Health / composite index (provided by the API side)

The diagnostic fields returned for different accounts may vary slightly. Therefore this duck will not:

  • ❌ Fabricate health scores or ratings not returned by the API
  • ❌ Make up missing follower count / profile fields out of thin air
  • ❌ Treat "popularity index / composite index" as metrics this API cannot obtain, such as play rate or completion rate

Iron rule: only report real API fields; do not fabricate data that isn't there. Any field not returned by the API will never appear in the conclusions. When this duck says "composite index / popularity index," it refers to composite dimensions such as healthScore returned by the API, not a rating this duck invented.


Step 1: Get the key (API Key)

Calling the API requires a Doubaoya passcode (API Key):

  1. Open doubaoya.com
  2. Log in to your account
  3. Go to Passcode Center
  4. Click Generate Passcode, and get a key in the form dyh_… key

Once you have it, set it as an environment variable (The Key only goes into environment variables; never print it, never write it into code, never echo it back to users):

export DOUBAOYA_API_KEY="dyh_你的口令"
Variable name Required Description
DOUBAOYA_API_KEY Yes Doubaoya access passcode, in the form dyh_…

Step 2: Call the script

# 批量诊断:账号名(中文名)或抖音号皆可,可混传,一次多个
python3 scripts/diagnose_account.py "本鸭の小厨房" "隔壁老王Vlog" "douyinhao123"

# 首次诊断、数据稀疏时:先同步作品再诊断
python3 scripts/diagnose_account.py "本鸭の小厨房" --sync

The script will read DOUBAOYA_API_KEY, initiate diagnostics with DouBaoYa, and on success print data(including items[]) as JSON to standard output.

⚠️ Here you must passactually existingaccount name or Douyin ID—don't make one up to "try it out"; an account that can't be found will only return empty results. When you don't have a confirmed account, ask the user for a real account first.

Account name or Douyin ID?

  • The interface requires accountNames[](array,required, at least one).
  • This fieldaccepts both account names (Chinese names) and Douyin IDs, and the backend identifies them automatically—so names and IDs can all be passed directly as positional arguments, and can be mixed.

About --sync(optional, used only once for the first sync)

The upstream will provide a more complete diagnosis after "sync user works into the database". So this duck supports a --sync flag:

  1. When --sync is included, the script will first call the works sync interface (douyin-sync-notes), and print the sync receipt.
  2. Sync is ack-only asynchronous task: it takes about 30 minutes to enter the database,not billed, and the receipt looks like {"status":"syncing","accepted":true,"retryAfterMinutes":30}。
  3. The script does not block, does not poll, does not sleep—after initiating, it immediately continues to initiate diagnostics.
  4. Before sync is complete, diagnostic data may be sparse; this duck will prompt the user to rerun the diagnostic once after about 30 minutes (remove --sync), to get the complete checkup results.

Rule of thumb:If data is sparse on the first diagnostic of an account, first use --sync once to sync works into the database, wait about 30 minutes, then rerun the diagnostic without --sync . For accounts that have already been synced, subsequent diagnostics do not need --sync。

Interface contract

Configuration item Value
Diagnostic interface POST https://doubaoya.com/api/apis/douyin/douyin-account-diagnosis/call
Diagnostic request body { "accountNames": ["账号名或抖音号", ...] }(array, required, at least one; this field accepts both names and IDs)
Sync interface (only --sync) POST https://doubaoya.com/api/apis/douyin/douyin-sync-notes/call
Sync request body { "accountId": "<抖音号>" }
Authentication method Request header Authorization: Bearer $DOUBAOYA_API_KEY

Return envelope structure:

{
  "success": true,
  "requestId": "...",
  "data": {
    "items": [
      {
        "accountName": "本鸭の小厨房",
        "followerCount": 128000,
        "healthScore": 82
      }
    ]
  },
  "error": null
}

When reading, be sure to:

  1. First check success:success !== true : if it is not true, treat it as failure, read error.code / error.message and handle it.
  2. Defensive field access:items[] Fields inside may be missing; mark missing ones as "not available" truthfully, and do not fill in values.

Error code reference

HTTP code Meaning / Handling
401 MISSING_API_KEY / UNAUTHORIZED No Key set or Key invalid—check DOUBAOYA_API_KEY
400 VALIDATION_ERROR Invalid input parameters—accountNames[] must have at least one account
402 INSUFFICIENT_CREDITS Insufficient quota—go to doubaoya.com to top up and retry
502 PROVIDER_FAILED Upstream temporary failure,already automatically refunded, safe to retry

The script will also give at the network/parsing layer NETWORK_ERROR(cannot connect) and BAD_RESPONSE(returned non-JSON).


Step 3: Present the diagnostic results

Successfully obtained items[] After that, report to the user account by account (thousands separator for numbers, mark missing fields as "暂无"):

🦆 账号体检 · {accountName}
————————————————————————
粉丝量      {followerCount}
综合指数    {healthScore}

🧭 运营建议
{基于真实字段的、有据可依的方向性建议,1–3 条}

These suggestions are all derived directly from the diagnostic fields.Do notintroduce metrics that this API cannot obtain, such as play rate, completion rate, and engagement rate.


Special Cases

  • Sparse data / fields are almost all empty: This is very likely a first diagnosis and the work has not yet been ingested. It is recommended to first --sync sync the work, wait about 30 minutes, and then rerun the diagnosis (remove --sync)。
  • success !== true: Handle according to the error code reference table;PROVIDER_FAILED can be retried directly (already automatically refunded).
  • Some accounts have no results: Truthfully explain that this account currently has no diagnostic data,do notfabricate a profile or health score.
  • Data looks incorrect: Just truthfully present the API return values; do not "correct" them on behalf of the API.

Use Cases

Scenario 1: Collective health check for an account matrix

Agency operators / matrix managers pass in a list of account names under their name all at once, retrieve follower counts and composite indices one by one, quickly rank who is healthy and who is falling behind, and set this week's operational priorities.

Scenario 2: Agency delivery review

Service providers batch-diagnose client accounts during monthly reviews, produce a health check list using real fields, and use it as the basis for delivery communication.

Scenario 3: Competitor benchmarking

Operators pass in their own and competitor account names together, compare composite indices and follower counts, establish a scale coordinate, and identify directions for catching up or differentiation.


Project Structure

douyin-account-diagnosis/
├── SKILL.md                    # 技能定义(本文件)
└── scripts/
    └── diagnose_account.py     # 都爆鸭账号诊断脚本(零依赖,含可选 --sync)

FAQ

Q1: How do I get an API Key? Go to doubaoya.com log in → Token Center → Generate Token, obtain a key in the form dyh_… and set it in the environment variable DOUBAOYA_API_KEY. This duck will not echo your Key.

Q2: Should I pass an account name or a Douyin ID? Either is fine.accountNames[] accepts both account names (Chinese names) and Douyin IDs, and the backend automatically identifies them; you can pass multiple at once, or mix them, for batch diagnosis. Note that you must pass accounts that actually exist; do not make them up.

Q3: The diagnostic result is almost empty. What should I do? It is most likely a first diagnosis and the work has not yet been ingested. First --sync sync once (about 30 minutes, no charge), and after it is ready remove --sync and rerun the diagnosis.

Q4:--sync Will it hang for 30 minutes? No.--sync only initiates the sync task and immediately returns a receipt,without blocking. The 30 minutes is the ingestion time; during that period you can do other things, and then rerun the diagnosis later.

Q5: Prompt INSUFFICIENT_CREDITS What should I do? Insufficient quota. Go to doubaoya.com to top up and retry. Note:--sync sync tasks are not charged; what is charged is the diagnostic call itself.

Q6: Prompt PROVIDER_FAILED What should I do? Temporary upstream failure. The system has already automatically refunded; just retry directly (retrying is safe).