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 formdyh_…)。
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)
- Open doubaoya.com
- Log in
- Go to passphrase center
- 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, requiredpageNum: integer, optional (default 1, controlled by--pagecontrolled)pageSize: integer, optional (default 20, controlled by--sizecontrolled)
- Return envelope:
{ "success": true, "requestId": "...", "data": { "items": [ { "title": "...", "likeCount": 123000 } ] }, "error": null } - First check
success: iftruethen readdata; otherwise readerror.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_FAILEDwill 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