Hermes Atlas
Skills & skill packs · works with Hermes Agent

Douyin KOL Discovery

why20261/douyin-kol-discovery

Node.js skill that searches Douyin videos, creator posts, comments and the hot list and returns JSON

In short

Douyin KOL Discovery is a Node.js agent skill for finding and assessing creators on Douyin, using public data from keyword searches, creator profiles, video comments and the live hot list. The repository lists hermes-skill among many agent-skill topics.

What Douyin KOL Discovery does

The skill is run through four small commands from the skill root: search-cli.js for keyword search, post-cli.js for a creator's posts, comment-cli.js for a video's comments and hot-cli.js for the live hot list. Search can sort by likes or by newest and filter by time window, duration and content type. Creators and videos can be given as a link, an app share text, a sec_uid or an aweme_id. Results are printed as structured JSON with title, author, like, comment, favorite and share counts, tags and video links, and are also saved to a logs folder.

It needs no Douyin login and reads only public data. A single call can return up to 10,000 items, and it usually takes 10 to 60 seconds because a task is created and polled. The README sets rules for agents: stop and report on an authentication error, do not retry after an explicit error code, and never present an empty result as a success. The current version is 1.3.0, and the README is written in Chinese.

Key features

  • Keyword search sorted by likes or recency, with time and duration filters
  • Creator post retrieval from a profile link or sec_uid
  • Comment retrieval for a video, up to 10,000 items per call
  • Live Douyin hot list
  • Pure JSON on stdout with logs saved to a logs folder
  • Defined exit codes and retry rules for AI agents

When to use it

  • Finding creators and high-like videos on a topic for a campaign
  • Reviewing a creator's recent posts and engagement before approaching them
  • Reading a video's comment section to gauge sentiment

Who it is for: Marketers and short-video operators who want an agent to research Douyin creators and content.

How it fits with Hermes Agent

Tagged as a hermes-skill alongside many other agent platforms. The README gives no Hermes-specific install steps.

Requirements: Node.js 16.14.0 or newer and a GUAIKEI_API_TOKEN environment variable from www.guaikei.com

Note: It needs a token for the third-party guaikei.com service, and keywords and links are sent to that API.

FAQ

What is Douyin KOL Discovery?

Douyin KOL Discovery is a Node.js skill that retrieves public Douyin data, including keyword search results, creator posts, comments and the hot list, as structured JSON for creator research.

Does Douyin KOL Discovery work with Hermes Agent?

The repository is tagged hermes-skill, and it follows a skill layout used by several agent platforms. The README does not describe Hermes-specific setup.

What do I need to run Douyin KOL Discovery?

You need Node.js 16.14.0 or newer and a GUAIKEI_API_TOKEN from www.guaikei.com. Without the token the commands stop with an authentication error.

Similar skills for Hermes Agent

All skills

Related guides: What is Hermes Agent? · SOUL.md for Hermes Agent: what it is and how to write one