SuperAPI AI Directory

cultural-tourism-douyin-feed

General & other

View repository

Updated 10-16 08:43

About this skill

Douyin Cultural Tourism Viral Content Source (Dubaoya)

This duck helps you scan Douyin for viral cultural tourism content by keyword—fishing out the hottest short videos from cities, scenic areas, and travel routes, laying them out in a clickable viral table in the terminal, then clustering them into several cultural tourism topic directions to build an actionable benchmarking list of city/scenic area content.

Douyin is the main battlefield for cultural tourism communication: one viral video can make a city famous. Suitable fortourism bureaus, scenic area operations, city cultural tourism accounts, travel bloggersto find topics, see benchmarks, and pin down viral angles.

Data goes through doubaoya.com as a single line, with authentication using your own token (environment variable DOUBAOYA_API_KEY, in the form dyh_…)。

Note: the underlying layer is the Douyin content feed, which retrieves works by the keyword you give. "Cultural tourism" is used as a keyword to treat it as a cultural tourism topic lens—results depend on how well the feed matches your word; the closer the word is to cultural tourism, the more accurate it is.


Applicable scenarios

Scenario How to use What you get
City cultural tourism benchmarking Use 城市旅游、某某城市 to scan viral content See what content similar cities use to break out
Scenic area topic selection Use 景区打卡、古镇、国风 , etc. Lock onto the shooting methods and angles of viral scenic area content
Cultural tourism trend tracking Use 文旅、小众旅行 to scan today's viral content See at a glance what is hot in the cultural tourism circle right now
Viral angle benchmarking See which angles high-like videos are concentrated in Find content angles worth benchmarking in the same track
Viral angle breakdown Look at the title angles of high-like videos Extract viral writing methods for cultural tourism short videos

Workflow (4 steps)

1. Set the keyword

Extract one cultural tourism direction keyword(required) from the user's description, such as 文旅、城市旅游、景区打卡、古镇、小众旅行. Broad words get more hits, narrow words are more focused; scan only one keyword at a time.

2. Call the script

python3 "$SKILL_PATH/scripts/fetch_culture_feed.py" "城市旅游"

Pagination / adjust items per page (optional):

python3 "$SKILL_PATH/scripts/fetch_culture_feed.py" "景区打卡" --page 2 --size 30

The script outputs the data from the success envelope as JSON to stdout.Run the script only once per query, read the full stdout directly, do not use head/tail preview, and do not call repeatedly with the same parameters.

3. Render the viral table

From data.items(video array), take the fields and lay them out as a Markdown table. The core fields stably returned by this API are title(title) and likeCount(likes); read defensively—fields may be missing, leave them blank if so, do not error, and do not imagine links or authors that the API did not return. If a returned item happens to include a link, render the title as a clickable link; otherwise plain text is fine.

Title Likes
Example cultural tourism viral content 12.3w

4. Cluster into topic directions + one-sentence insight

Cluster these videos from a cultural tourism perspectiveCluster(such as city virality / scenic spot check-ins / food exploration / guofeng guochao / hidden gems), pick representative viral hits for each direction, and form a short benchmark list. At the end, add a line in this duck's tone fortopic insights: which angle of cultural tourism short videos is hottest right now, and which city/scenic spot playstyle is worth learning from. Don't pile on clichés, and don't ask the user back about their purpose.


Get the key (passphrase)

  1. Open doubaoya.com
  2. Log in
  3. Go to passphrase center
  4. Generate passphrase(in the form dyh_…)

Configure it into an environment variable (the script only recognizes this):

export DOUBAOYA_API_KEY="dyh_你的口令"

Iron rule: the passphrase must never be printed, never written to a file, and never echoed back to the user. The script itself also never outputs the passphrase. All requests are sent only to doubaoya.com。


Interface and envelope

  • POST https://doubaoya.com/api/apis/douyin/douyin-playlet-feed/call
  • Auth header:Authorization: Bearer $DOUBAOYA_API_KEY
  • Request body:{ "keyword": "城市旅游", "pageNum": 1, "pageSize": 20 }
    • keyword: string, required
    • pageNum: integer, optional (default 1, controlled by --page controlled)
    • pageSize: integer, optional (default 20, controlled by --size controlled)
  • Return envelope:
    {
      "success": true,
      "requestId": "...",
      "data": { "items": [ { "title": "...", "likeCount": 123000 } ] },
      "error": null
    }
    
  • First check success: if true then read data; otherwise read error.code / error.message。

Error handling

When the script fails, print to stderr [error] CODE: message and exit with code 1. Common cases:

HTTP code Meaning Handling
401 MISSING_API_KEY / UNAUTHORIZED No passphrase provided or passphrase invalid Check DOUBAOYA_API_KEY, go to the passphrase center to regenerate
400 VALIDATION_ERROR Invalid parameters (e.g. keyword is empty) Fix the keyword and retry
402 INSUFFICIENT_CREDITS Insufficient quota Go to doubaoya.com to top up/renew quota
502 PROVIDER_FAILED Temporary upstream failure (auto-refunded) safe to retry

502 PROVIDER_FAILED will automatically refund, retrying is safe and will not double-charge.


Directory structure

cultural-tourism-douyin-feed/
├── SKILL.md                    # 本文件
└── scripts/
    └── fetch_culture_feed.py   # 零依赖脚本(urllib),调用 doubaoya.com