carcabot/tiktok-signature - thehardwarestore.ai

── AI DEEP ANALYSIS ──

reviewed by: deepseek/deepseek-v4-flash

This repository provides a Node.js HTTP service that generates TikTok API signatures (X-Bogus and X-Gnarly) required to access TikTok's data endpoints. It uses Puppeteer to run a headless Chromium browser, injects a bundled copy of TikTok's web SDK, and computes signatures by intercepting fetch requests. The service also includes a pure Node.js implementation for X-Gnarly using ChaCha20. It exposes POST /signature and POST /fetch endpoints, manages a request queue, and automatically refreshes the browser session after 500 signatures or 30 minutes. The repository includes example scripts for fetching user videos, comments, trending content, and search results, demonstrating typical TikTok data scraping workflows. While the core functionality is well-implemented, the reliance on static SDK copies and a heavy browser dependency introduces maintenance risks as TikTok updates its anti-scraping measures.

── METRICS ──

RATING7.8/10

QUALITY7.5/10

MAINTENANCEactive

DRIFTmedium

CONTRIBUTORS17

VELOCITY0.65

OPEN ISSUES10

CLOSED ISSUES202

LAST COMMIT2 months ago

── TAGS ──

#tiktok-signature #puppeteer #api-wrapper #scraping #nodejs #signature-generation #tiktok #node #playwright

── GITHUB TOPICS ──

tiktok node puppeteer tiktok-signature playwright

── DEPENDENCY GRAPH ──

puppeteer (npm) ^24.36.0

puppeteer-extra (npm) ^3.3.6

puppeteer-extra-plugin-stealth (npm) ^2.11.2

undici (npm) ^7.25.0

@types/jest (npm) ^30.0.0

jest (npm) ^30.1.3

prettier (npm) ^3.8.1

── FILE BREAKDOWN ──

Files by Type (count)

JavaScript

12

Markdown

8

YAML

5

Other (.mjs)

4

Other (no ext)

2

JSON

2

Docker Ignore

1

Other (.example)

1

Git Ignore

1

Dockerfile

1

Shell

1

Files by Type (size)

JavaScript

1MB

JSON

369KB

Other (.mjs)

48KB

Markdown

26KB

YAML

6KB

Git Ignore

2KB

Shell

2KB

Dockerfile

1KB

Other (.example)

655B

Docker Ignore

170B

Other (no ext)

124B

── KEY FINDINGS: REUSABLE CODE ──

The LLM identified 1 files worth highlighting for reuse:

Implements X-Gnarly signature generation using ChaCha20 encryption and custom payload encoding. Self-contained module with no internal dependencies, can be extracted and reused in any Node.js project requiring TikTok X-Gnarly signatures.

file: xgnarly.mjs ↗ | tags: #chacha20 #signature-encoding #pure-nodejs

── HISTORY ──

Last analyzed: 2026-09-12 08:30:14.478768

Next check: 2026-09-19 08:30:14.474555

$ show carcabot/tiktok-signature