Toutiao Viral Content Search

What Problem It Solves

When tracking trends, competitors, or public discussion, keyword searches on Toutiao often return fragmented posts without the metrics needed to judge reach. This skill wraps the Toutiao viral-content API into a terminal workflow: provide a keyword and get a structured list of recent image-text and video posts, with CSV export or an interactive HTML report.

How It Works

• Live retrieval: queries by keyword and prioritizes newly published Toutiao posts.
• Data enrichment: follows up with detail calls to fill in viewCount, likeCount, commentCount, repostCount, publishTime, and source links.
• Sorting and filtering: supports descending order by views or time, limits results to the last N hours with --hours, and isolates confirmed videos with --video-only.
• Expanded search: when results are thin, --expand can auto-add related terms, while --also lets you append specific keywords for long-tail events or competitor tracking.
• Result capture: displays a terminal table and can generate a UTF-8 BOM CSV plus a dark-themed HTML report for analysis, sharing, or downstream processing.

Boundaries And Notes

It targets Toutiao, not web-wide monitoring. A REDFOX_API_KEY is required, and the default pagination is about 10 items per page across 3 pages; increase --pages if you need a larger sample. The video filter only retains confirmed videos, and unconfirmed post types are not misclassified as video.