tt-help-cli-ycl 1.3.6 → 1.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/README.md +17 -17
  2. package/cli.js +9 -9
  3. package/package.json +45 -45
  4. package/src/cli/auto.js +131 -121
  5. package/src/cli/explore.js +147 -138
  6. package/src/cli/progress.js +111 -111
  7. package/src/cli/scrape.js +47 -47
  8. package/src/cli/utils.js +18 -18
  9. package/src/cli/videos.js +41 -41
  10. package/src/cli/watch.js +31 -31
  11. package/src/lib/args.js +391 -391
  12. package/src/lib/browser/anti-detect.js +23 -23
  13. package/src/lib/browser/cdp.js +142 -142
  14. package/src/lib/browser/launch.js +43 -43
  15. package/src/lib/browser/page.js +87 -87
  16. package/src/lib/constants.js +109 -95
  17. package/src/lib/delay.js +54 -54
  18. package/src/lib/explore-fetch.js +118 -118
  19. package/src/lib/fetcher.js +45 -45
  20. package/src/lib/filter.js +66 -66
  21. package/src/lib/io.js +54 -54
  22. package/src/lib/mac-or-uuid.js +82 -0
  23. package/src/lib/output.js +80 -80
  24. package/src/lib/parser.js +47 -47
  25. package/src/lib/retry.js +44 -44
  26. package/src/lib/scrape.js +40 -40
  27. package/src/lib/url.js +52 -52
  28. package/src/main.mjs +221 -221
  29. package/src/scraper/auto-core.mjs +185 -185
  30. package/src/scraper/core.mjs +190 -190
  31. package/src/scraper/explore-core.mjs +162 -162
  32. package/src/scraper/modules/captcha-handler.mjs +114 -114
  33. package/src/scraper/modules/comment-extractor.mjs +69 -69
  34. package/src/scraper/modules/follow-extractor.mjs +121 -121
  35. package/src/scraper/modules/guess-extractor.mjs +51 -51
  36. package/src/scraper/modules/page-error-detector.mjs +70 -70
  37. package/src/scraper/modules/page-helpers.mjs +48 -48
  38. package/src/scraper/modules/scroll-collector.mjs +189 -189
  39. package/src/test-auto-follow.cjs +109 -0
  40. package/src/test-extractors.cjs +75 -0
  41. package/src/test-follow.cjs +41 -0
  42. package/src/videos/core.mjs +126 -126
  43. package/src/watch/data-store.mjs +258 -261
  44. package/src/watch/public/index.html +466 -465
  45. package/src/watch/server.mjs +291 -281
  46. package/src/results/user-videos-bar.lar.lar.moeta.json +0 -37
package/README.md CHANGED
@@ -1,17 +1,17 @@
1
- # tt-help
2
-
3
- TikTok user & video data scraper — extract ttSeller, verified, locationCreated from HTML source.
4
-
5
- ## Install
6
-
7
- ```bash
8
- npm i -g tt-help
9
- ```
10
-
11
- ## Usage
12
-
13
- ```bash
14
- tt-help [options] <urls...>
15
- ```
16
-
17
- 示例、代理配置、和更多用法请查看仓库或 `src/main.mjs` 中的帮助文本。
1
+ # tt-help
2
+
3
+ TikTok user & video data scraper — extract ttSeller, verified, locationCreated from HTML source.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm i -g tt-help
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```bash
14
+ tt-help [options] <urls...>
15
+ ```
16
+
17
+ 示例、代理配置、和更多用法请查看仓库或 `src/main.mjs` 中的帮助文本。
package/cli.js CHANGED
@@ -1,9 +1,9 @@
1
- #!/usr/bin/env node
2
- import { fileURLToPath } from 'url';
3
- import { dirname, resolve } from 'path';
4
-
5
- const __filename = fileURLToPath(import.meta.url);
6
- const __dirname = dirname(__filename);
7
-
8
- const mainPath = resolve(__dirname, 'src', 'main.mjs');
9
- await import(`file://${mainPath}`);
1
+ #!/usr/bin/env node
2
+ import { fileURLToPath } from 'url';
3
+ import { dirname, resolve } from 'path';
4
+
5
+ const __filename = fileURLToPath(import.meta.url);
6
+ const __dirname = dirname(__filename);
7
+
8
+ const mainPath = resolve(__dirname, 'src', 'main.mjs');
9
+ await import(`file://${mainPath}`);
package/package.json CHANGED
@@ -1,45 +1,45 @@
1
- {
2
- "name": "tt-help-cli-ycl",
3
- "version": "1.3.6",
4
- "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
5
- "type": "module",
6
- "bin": {
7
- "tt-help": "cli.js"
8
- },
9
- "main": "src/main.mjs",
10
- "files": [
11
- "cli.js",
12
- "src/"
13
- ],
14
- "scripts": {
15
- "start": "node src/main.mjs"
16
- },
17
- "keywords": [
18
- "tiktok",
19
- "scraper",
20
- "cli",
21
- "seller",
22
- "ttSeller"
23
- ],
24
- "author": "jsjhycl",
25
- "license": "ISC",
26
- "engines": {
27
- "node": ">=18"
28
- },
29
- "publishConfig": {
30
- "access": "public"
31
- },
32
- "repository": {
33
- "type": "git",
34
- "url": "git+https://github.com/jsjhycl/tt-help-cli.git"
35
- },
36
- "bugs": {
37
- "url": "https://github.com/jsjhycl/tt-help-cli/issues"
38
- },
39
- "homepage": "https://github.com/jsjhycl/tt-help-cli#readme",
40
- "dependencies": {
41
- "playwright": "^1.59.1",
42
- "tt-help-cli-ycl": "^1.3.2",
43
- "undici": "^8.1.0"
44
- }
45
- }
1
+ {
2
+ "name": "tt-help-cli-ycl",
3
+ "version": "1.3.7",
4
+ "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
5
+ "type": "module",
6
+ "bin": {
7
+ "tt-help": "cli.js"
8
+ },
9
+ "main": "src/main.mjs",
10
+ "files": [
11
+ "cli.js",
12
+ "src/"
13
+ ],
14
+ "scripts": {
15
+ "start": "node src/main.mjs"
16
+ },
17
+ "keywords": [
18
+ "tiktok",
19
+ "scraper",
20
+ "cli",
21
+ "seller",
22
+ "ttSeller"
23
+ ],
24
+ "author": "jsjhycl",
25
+ "license": "ISC",
26
+ "engines": {
27
+ "node": ">=18"
28
+ },
29
+ "publishConfig": {
30
+ "access": "public"
31
+ },
32
+ "repository": {
33
+ "type": "git",
34
+ "url": "git+https://github.com/jsjhycl/tt-help-cli.git"
35
+ },
36
+ "bugs": {
37
+ "url": "https://github.com/jsjhycl/tt-help-cli/issues"
38
+ },
39
+ "homepage": "https://github.com/jsjhycl/tt-help-cli#readme",
40
+ "dependencies": {
41
+ "playwright": "^1.59.1",
42
+ "tt-help-cli-ycl": "^1.3.2",
43
+ "undici": "^8.1.0"
44
+ }
45
+ }
package/src/cli/auto.js CHANGED
@@ -1,121 +1,131 @@
1
- import { getOrCreatePage } from '../lib/browser/page.js';
2
-
3
- const MAX_RETRY_WAIT = 5 * 60 * 1000;
4
-
5
- async function withRetry(label, fn) {
6
- let backoff = 1000;
7
- while (true) {
8
- try {
9
- return await fn();
10
- } catch (err) {
11
- console.error(`[连接] ${label} 失败: ${err.message},${backoff / 1000}秒后重试...`);
12
- await new Promise(r => setTimeout(r, backoff));
13
- if (backoff < MAX_RETRY_WAIT) backoff *= 2;
14
- }
15
- }
16
- }
17
-
18
- async function apiPost(url, body) {
19
- return withRetry(`POST ${url}`, async () => {
20
- const res = await fetch(url, {
21
- method: 'POST',
22
- headers: { 'Content-Type': 'application/json' },
23
- body: JSON.stringify(body),
24
- });
25
- return res.json();
26
- });
27
- }
28
-
29
- async function apiGet(url) {
30
- return withRetry(`GET ${url}`, async () => {
31
- const res = await fetch(url);
32
- return res.json();
33
- });
34
- }
35
-
36
- export async function handleAuto(options) {
37
- const { autoUsernames, autoCollectMax, autoScrapeDepth, autoMaxComments, autoMaxGuess,
38
- autoPreset, autoSwitchDelay, autoCommentDelay, serverUrl,
39
- autoEnableFollow, autoMaxFollowing, autoMaxFollowers } = options;
40
-
41
- const runOptions = {
42
- collectMax: autoCollectMax,
43
- scrapeDepth: autoScrapeDepth,
44
- maxComments: autoMaxComments,
45
- maxGuess: autoMaxGuess,
46
- preset: autoPreset,
47
- switchMax: autoSwitchDelay,
48
- commentMax: autoCommentDelay,
49
- enableFollow: autoEnableFollow,
50
- maxFollowing: autoMaxFollowing,
51
- maxFollowers: autoMaxFollowers,
52
- };
53
-
54
- await apiGet(`${serverUrl}/api/stats`);
55
-
56
- if (autoUsernames.length > 0) {
57
- const { added, skipped } = await apiPost(`${serverUrl}/api/users`, { usernames: autoUsernames });
58
- console.error(`种子用户: ${added} 个新增, ${skipped} 个已存在`);
59
- }
60
-
61
- console.error(`服务器: ${serverUrl}(断开会自动重连)`);
62
-
63
- const { ensureBrowserReady, processUser } = await import('../scraper/auto-core.mjs');
64
- const browser = await ensureBrowserReady();
65
-
66
- const page = await getOrCreatePage(browser);
67
-
68
- let processedCount = 0;
69
- let errorCount = 0;
70
-
71
- while (true) {
72
- const job = await apiGet(`${serverUrl}/api/job`);
73
- if (!job.hasJob) break;
74
-
75
- const username = job.user.uniqueId;
76
- processedCount++;
77
- let proxyRetry = 0;
78
-
79
- while (true) {
80
- console.error(`\n[${processedCount}] 处理 @${username}...${proxyRetry > 0 ? ` (代理重试 ${proxyRetry})` : ''}`);
81
-
82
- const result = await processUser(page, username, { ...runOptions, browser }, console.error);
83
-
84
- if (result.restricted) {
85
- await apiPost(`${serverUrl}/api/job/${username}`, result);
86
- break;
87
- }
88
-
89
- if (result.error && result.error.includes('代理错误')) {
90
- proxyRetry++;
91
- console.error(` [代理错误] ${result.error},等待 10s 后重试...`);
92
- await new Promise(r => setTimeout(r, 10000));
93
- continue;
94
- }
95
-
96
- if (result.error) {
97
- errorCount++;
98
- await apiPost(`${serverUrl}/api/job/${username}`, result);
99
- break;
100
- }
101
-
102
- const payload = {
103
- userInfo: result.userInfo || {},
104
- discoveredVideoAuthors: result.discoveredVideoAuthors || [],
105
- discoveredCommentAuthors: result.discoveredCommentAuthors || [],
106
- discoveredGuessAuthors: result.discoveredGuessAuthors || [],
107
- discoveredFollowing: result.discoveredFollowing || [],
108
- discoveredFollowers: result.discoveredFollowers || [],
109
- };
110
- await apiPost(`${serverUrl}/api/job/${username}`, payload);
111
- console.error(' 已提交');
112
- break;
113
- }
114
- }
115
-
116
- const stats = await apiGet(`${serverUrl}/api/stats`);
117
- console.error(`\n完成: ${processedCount} 个用户处理, ${errorCount} 个出错`);
118
- console.error(` 总用户: ${stats.totalUsers}, 已完成: ${stats.processedUsers}, 待处理: ${stats.pendingUsers}, 错误: ${stats.errorUsers}`);
119
-
120
- await browser.close().catch(() => {});
121
- }
1
+ import { getOrCreatePage } from '../lib/browser/page.js';
2
+ import { userId as configuredUserId, saveUserId } from '../lib/constants.js';
3
+ import { getMacOrUuid } from '../lib/mac-or-uuid.js';
4
+
5
+ const MAX_RETRY_WAIT = 5 * 60 * 1000;
6
+
7
+ async function withRetry(label, fn) {
8
+ let backoff = 1000;
9
+ while (true) {
10
+ try {
11
+ return await fn();
12
+ } catch (err) {
13
+ console.error(`[连接] ${label} 失败: ${err.message},${backoff / 1000}秒后重试...`);
14
+ await new Promise(r => setTimeout(r, backoff));
15
+ if (backoff < MAX_RETRY_WAIT) backoff *= 2;
16
+ }
17
+ }
18
+ }
19
+
20
+ async function apiPost(url, body) {
21
+ return withRetry(`POST ${url}`, async () => {
22
+ const res = await fetch(url, {
23
+ method: 'POST',
24
+ headers: { 'Content-Type': 'application/json' },
25
+ body: JSON.stringify(body),
26
+ });
27
+ return res.json();
28
+ });
29
+ }
30
+
31
+ async function apiGet(url) {
32
+ return withRetry(`GET ${url}`, async () => {
33
+ const res = await fetch(url);
34
+ return res.json();
35
+ });
36
+ }
37
+
38
+ export async function handleAuto(options) {
39
+ const { autoUsernames, autoCollectMax, autoScrapeDepth, autoMaxComments, autoMaxGuess,
40
+ autoPreset, autoSwitchDelay, autoCommentDelay, serverUrl,
41
+ autoEnableFollow, autoMaxFollowing, autoMaxFollowers } = options;
42
+
43
+ let userId = configuredUserId;
44
+ if (!userId) {
45
+ userId = await getMacOrUuid();
46
+ saveUserId(userId);
47
+ console.error(`[初始化] 未检测到本地用户编号,已生成并使用: ${userId}`);
48
+ }
49
+
50
+ const runOptions = {
51
+ collectMax: autoCollectMax,
52
+ scrapeDepth: autoScrapeDepth,
53
+ maxComments: autoMaxComments,
54
+ maxGuess: autoMaxGuess,
55
+ preset: autoPreset,
56
+ switchMax: autoSwitchDelay,
57
+ commentMax: autoCommentDelay,
58
+ enableFollow: autoEnableFollow,
59
+ maxFollowing: autoMaxFollowing,
60
+ maxFollowers: autoMaxFollowers,
61
+ userId,
62
+ };
63
+
64
+ await apiGet(`${serverUrl}/api/stats`);
65
+
66
+ if (autoUsernames.length > 0) {
67
+ const { added, skipped } = await apiPost(`${serverUrl}/api/users`, { usernames: autoUsernames });
68
+ console.error(`种子用户: ${added} 个新增, ${skipped} 个已存在`);
69
+ }
70
+
71
+ console.error(`服务器: ${serverUrl}(断开会自动重连)`);
72
+
73
+ const { ensureBrowserReady, processUser } = await import('../scraper/auto-core.mjs');
74
+ const browser = await ensureBrowserReady();
75
+
76
+ const page = await getOrCreatePage(browser);
77
+
78
+ let processedCount = 0;
79
+ let errorCount = 0;
80
+
81
+ while (true) {
82
+ const job = await apiGet(`${serverUrl}/api/job?userId=${encodeURIComponent(userId)}`);
83
+ if (!job.hasJob) break;
84
+
85
+ const username = job.user.uniqueId;
86
+ processedCount++;
87
+ let proxyRetry = 0;
88
+
89
+ while (true) {
90
+ console.error(`\n[${processedCount}] 处理 @${username}...${proxyRetry > 0 ? ` (代理重试 ${proxyRetry})` : ''}`);
91
+
92
+ const result = await processUser(page, username, { ...runOptions, browser }, console.error);
93
+
94
+ if (result.restricted) {
95
+ await apiPost(`${serverUrl}/api/job/${username}`, result);
96
+ break;
97
+ }
98
+
99
+ if (result.error && result.error.includes('代理错误')) {
100
+ proxyRetry++;
101
+ console.error(` [代理错误] ${result.error},等待 10s 后重试...`);
102
+ await new Promise(r => setTimeout(r, 10000));
103
+ continue;
104
+ }
105
+
106
+ if (result.error) {
107
+ errorCount++;
108
+ await apiPost(`${serverUrl}/api/job/${username}`, result);
109
+ break;
110
+ }
111
+
112
+ const payload = {
113
+ userInfo: result.userInfo || {},
114
+ discoveredVideoAuthors: result.discoveredVideoAuthors || [],
115
+ discoveredCommentAuthors: result.discoveredCommentAuthors || [],
116
+ discoveredGuessAuthors: result.discoveredGuessAuthors || [],
117
+ discoveredFollowing: result.discoveredFollowing || [],
118
+ discoveredFollowers: result.discoveredFollowers || [],
119
+ };
120
+ await apiPost(`${serverUrl}/api/job/${username}`, payload);
121
+ console.error(' 已提交');
122
+ break;
123
+ }
124
+ }
125
+
126
+ const stats = await apiGet(`${serverUrl}/api/stats`);
127
+ console.error(`\n完成: ${processedCount} 个用户处理, ${errorCount} 个出错`);
128
+ console.error(` 总用户: ${stats.totalUsers}, 已完成: ${stats.processedUsers}, 待处理: ${stats.pendingUsers}, 错误: ${stats.errorUsers}`);
129
+
130
+ await browser.close().catch(() => {});
131
+ }