Hermes Atlas
Automations & use cases

TikTok B2B Bot

tienan2024/tiktok-b2b-bot

Hermes-controlled lead generation pipeline for TikTok and Douyin with a FastAPI and Vue 3 console

In short

TikTok B2B Bot is an automated lead-generation system for Chinese export businesses, with Hermes Agent as its master controller. It runs a daily six-stage pipeline on TikTok and Douyin, from finding prospects to messaging them.

What TikTok B2B Bot does

The pipeline has six stages: collecting users by keyword search, recommendation feed and competitor analysis, filtering them by bio score and an LLM check, planning a strategy with persona classification and message scripts, reaching out through comments and direct messages at random intervals, summarizing the results as a daily report, and storing lessons in ChromaDB to refine the rules. Accounts log in by QR code, with up to five accounts and daily rate limits.

A FastAPI backend with 31 endpoints and JWT authentication sits under a Vue 3 and Element Plus console of 11 pages, backed by SQLite and SQLAlchemy. Playwright drives the browser, DeepSeek v4 Pro handles screening and strategy, and a Telegram bot sends the daily report. The repository includes four Hermes Skills and 36 backend tests. The README is written in Chinese and is aimed at Chinese foreign-trade B2B companies targeting markets such as Vietnam.

Key features

  • Six-stage daily pipeline from collection to iteration
  • TikTok and Douyin support with QR code login
  • Web console with dashboard, users, leads, pipeline, reports and config pages
  • FastAPI REST backend with 31 endpoints
  • Telegram daily report
  • Four bundled Hermes Skills

When to use it

  • Finding and ranking potential B2B customers in overseas markets
  • Running scheduled outreach with rate limits and random intervals
  • Reviewing conversion funnels and trends in a dashboard

Who it is for: Export-oriented businesses and developers who want a worked example of a Hermes-controlled outreach pipeline.

How it fits with Hermes Agent

Uses Hermes Agent as the main controller of the pipeline and ships four Hermes Skills in its skills folder.

How to install TikTok B2B Bot

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/tienan2024/tiktok-b2b-bot.git
cd tiktok-b2b-bot
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
playwright install chromium

Requirements: Python 3.11+, Node.js 18+, Playwright Chromium, and a DeepSeek API key set in .env

Note: It automates comments and direct messages on TikTok and Douyin, so check each platform's terms before running it.

FAQ

What is TikTok B2B Bot?

TikTok B2B Bot is a lead-generation system that finds, filters and messages potential business customers on TikTok and Douyin through a six-stage pipeline, with Hermes Agent as controller.

Does TikTok B2B Bot work with Hermes Agent?

Yes. Hermes Agent is described as the master controller, and the repository includes four Hermes Skills.

Is TikTok B2B Bot free and open source?

The repository has no license file, so default copyright applies and you should check with the author before reuse.

Similar automations for Hermes Agent

All automations

Related guides: Build agent teams with the Hermes kanban board · How to run Hermes Agent securely