@fastmoss/cli 0.1.5 → 0.1.13
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.
- package/README.md +39 -186
- package/README.zh-CN.md +39 -178
- package/bin/fastmoss.js +12 -7
- package/lib/runtime.js +56 -461
- package/lib/targets.js +65 -0
- package/package.json +10 -9
- package/bin/install-skill.js +0 -34
- package/bin/postinstall.js +0 -12
- package/skills/fastmoss-cli/SKILL.md +0 -70
- package/skills/fastmoss-cli/agents/openai.yaml +0 -3
- package/skills/fastmoss-cli/data/tools.json +0 -3490
- package/skills/fastmoss-cli/references/cli.md +0 -70
- package/skills/fastmoss-cli/references/tool-call.md +0 -102
- package/skills/fastmoss-cli/references/tools-advertising.md +0 -48
- package/skills/fastmoss-cli/references/tools-auxiliary-knowledge.md +0 -200
- package/skills/fastmoss-cli/references/tools-creator.md +0 -197
- package/skills/fastmoss-cli/references/tools-market.md +0 -69
- package/skills/fastmoss-cli/references/tools-product.md +0 -230
- package/skills/fastmoss-cli/references/tools-shop.md +0 -200
- package/skills/fastmoss-cli/references/tools.md +0 -25
|
@@ -1,3490 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"jsonrpc": "2.0",
|
|
3
|
-
"id": 2,
|
|
4
|
-
"result": {
|
|
5
|
-
"tools": [
|
|
6
|
-
{
|
|
7
|
-
"annotations": {
|
|
8
|
-
"title": "Ad data overview",
|
|
9
|
-
"readOnlyHint": true,
|
|
10
|
-
"destructiveHint": false,
|
|
11
|
-
"idempotentHint": false,
|
|
12
|
-
"openWorldHint": true
|
|
13
|
-
},
|
|
14
|
-
"description": "Use when the user has a video_id and wants ad spend, ROAS, play, engagement, follower, and commerce performance over a date range.",
|
|
15
|
-
"inputSchema": {
|
|
16
|
-
"properties": {
|
|
17
|
-
"filter": {
|
|
18
|
-
"description": "Filter parameters.",
|
|
19
|
-
"properties": {
|
|
20
|
-
"end_date": {
|
|
21
|
-
"description": "End date, YYYY-MM-DD.",
|
|
22
|
-
"type": "string"
|
|
23
|
-
},
|
|
24
|
-
"start_date": {
|
|
25
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
26
|
-
"type": "string"
|
|
27
|
-
},
|
|
28
|
-
"time_range_days": {
|
|
29
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
30
|
-
"enum": [
|
|
31
|
-
7,
|
|
32
|
-
14,
|
|
33
|
-
28,
|
|
34
|
-
60,
|
|
35
|
-
90,
|
|
36
|
-
180
|
|
37
|
-
],
|
|
38
|
-
"type": "integer"
|
|
39
|
-
},
|
|
40
|
-
"video_id": {
|
|
41
|
-
"description": "Video ID; use video_search first if only a title/creator is known.",
|
|
42
|
-
"type": "string"
|
|
43
|
-
}
|
|
44
|
-
},
|
|
45
|
-
"required": [
|
|
46
|
-
"video_id"
|
|
47
|
-
],
|
|
48
|
-
"type": "object"
|
|
49
|
-
}
|
|
50
|
-
},
|
|
51
|
-
"required": [
|
|
52
|
-
"filter"
|
|
53
|
-
],
|
|
54
|
-
"type": "object"
|
|
55
|
-
},
|
|
56
|
-
"name": "ad_data_overview"
|
|
57
|
-
},
|
|
58
|
-
{
|
|
59
|
-
"annotations": {
|
|
60
|
-
"title": "Ad search",
|
|
61
|
-
"readOnlyHint": true,
|
|
62
|
-
"destructiveHint": false,
|
|
63
|
-
"idempotentHint": false,
|
|
64
|
-
"openWorldHint": true
|
|
65
|
-
},
|
|
66
|
-
"description": "Use when the user wants active ad creatives or needs to filter ads by country, category, landing page, spend, ROAS, plays, or run days. Returns ad, creator, shop, products, and performance sections.",
|
|
67
|
-
"inputSchema": {
|
|
68
|
-
"properties": {
|
|
69
|
-
"filter": {
|
|
70
|
-
"description": "Filter parameters.",
|
|
71
|
-
"properties": {
|
|
72
|
-
"ad_type": {
|
|
73
|
-
"description": "Ad type: 1 TikTok Shop commerce ad, 2 non-commerce/planting ad.",
|
|
74
|
-
"type": "integer"
|
|
75
|
-
},
|
|
76
|
-
"category_l1_id": {
|
|
77
|
-
"description": "Level-1 product category ID.",
|
|
78
|
-
"type": "integer"
|
|
79
|
-
},
|
|
80
|
-
"category_l2_id": {
|
|
81
|
-
"description": "Level-2 product category ID.",
|
|
82
|
-
"type": "integer"
|
|
83
|
-
},
|
|
84
|
-
"category_l3_id": {
|
|
85
|
-
"description": "Level-3 product category ID.",
|
|
86
|
-
"type": "integer"
|
|
87
|
-
},
|
|
88
|
-
"estimated_ad_spend_range": {
|
|
89
|
-
"description": "Estimated ad spend range in the form {\"min\": number, \"max\": number}.",
|
|
90
|
-
"properties": {
|
|
91
|
-
"max": {
|
|
92
|
-
"description": "Maximum value.",
|
|
93
|
-
"type": "number"
|
|
94
|
-
},
|
|
95
|
-
"min": {
|
|
96
|
-
"description": "Minimum value.",
|
|
97
|
-
"type": "number"
|
|
98
|
-
}
|
|
99
|
-
},
|
|
100
|
-
"type": "object"
|
|
101
|
-
},
|
|
102
|
-
"keywords": {
|
|
103
|
-
"description": "Search keywords for ad caption, product, creator, or shop clues.",
|
|
104
|
-
"type": "string"
|
|
105
|
-
},
|
|
106
|
-
"last_seen_ad_date_range": {
|
|
107
|
-
"description": "Last-seen ad date range in the form {\"start_date\": \"YYYY-MM-DD\", \"end_date\": \"YYYY-MM-DD\"}.",
|
|
108
|
-
"properties": {
|
|
109
|
-
"end_date": {
|
|
110
|
-
"description": "End date, YYYY-MM-DD.",
|
|
111
|
-
"type": "string"
|
|
112
|
-
},
|
|
113
|
-
"start_date": {
|
|
114
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
115
|
-
"type": "string"
|
|
116
|
-
}
|
|
117
|
-
},
|
|
118
|
-
"type": "object"
|
|
119
|
-
},
|
|
120
|
-
"observed_active_days_range": {
|
|
121
|
-
"description": "Range for the number of days the ad was observed as active, in the form {\"min\": number, \"max\": number}.",
|
|
122
|
-
"properties": {
|
|
123
|
-
"max": {
|
|
124
|
-
"description": "Maximum value.",
|
|
125
|
-
"type": "number"
|
|
126
|
-
},
|
|
127
|
-
"min": {
|
|
128
|
-
"description": "Minimum value.",
|
|
129
|
-
"type": "number"
|
|
130
|
-
}
|
|
131
|
-
},
|
|
132
|
-
"type": "object"
|
|
133
|
-
},
|
|
134
|
-
"play_count_range": {
|
|
135
|
-
"description": "Video play-count range in the form {\"min\": number, \"max\": number}.",
|
|
136
|
-
"properties": {
|
|
137
|
-
"max": {
|
|
138
|
-
"description": "Maximum value.",
|
|
139
|
-
"type": "number"
|
|
140
|
-
},
|
|
141
|
-
"min": {
|
|
142
|
-
"description": "Minimum value.",
|
|
143
|
-
"type": "number"
|
|
144
|
-
}
|
|
145
|
-
},
|
|
146
|
-
"type": "object"
|
|
147
|
-
},
|
|
148
|
-
"region": {
|
|
149
|
-
"description": "Country or region code where the ad is detected, e.g. US, ID, VN.",
|
|
150
|
-
"type": "string"
|
|
151
|
-
},
|
|
152
|
-
"roas_range": {
|
|
153
|
-
"description": "ROAS range in the form {\"min\": number, \"max\": number}.",
|
|
154
|
-
"properties": {
|
|
155
|
-
"max": {
|
|
156
|
-
"description": "Maximum value.",
|
|
157
|
-
"type": "number"
|
|
158
|
-
},
|
|
159
|
-
"min": {
|
|
160
|
-
"description": "Minimum value.",
|
|
161
|
-
"type": "number"
|
|
162
|
-
}
|
|
163
|
-
},
|
|
164
|
-
"type": "object"
|
|
165
|
-
},
|
|
166
|
-
"video_create_date_range": {
|
|
167
|
-
"description": "Video publish-date range in the form {\"start_date\": \"YYYY-MM-DD\", \"end_date\": \"YYYY-MM-DD\"}.",
|
|
168
|
-
"properties": {
|
|
169
|
-
"end_date": {
|
|
170
|
-
"description": "End date, YYYY-MM-DD.",
|
|
171
|
-
"type": "string"
|
|
172
|
-
},
|
|
173
|
-
"start_date": {
|
|
174
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
175
|
-
"type": "string"
|
|
176
|
-
}
|
|
177
|
-
},
|
|
178
|
-
"type": "object"
|
|
179
|
-
}
|
|
180
|
-
},
|
|
181
|
-
"type": "object"
|
|
182
|
-
},
|
|
183
|
-
"orderby": {
|
|
184
|
-
"description": "Sort options.",
|
|
185
|
-
"items": {
|
|
186
|
-
"properties": {
|
|
187
|
-
"field": {
|
|
188
|
-
"description": "Sort field: last_seen_ad_date, first_seen_ad_date, play_count, estimated_ad_spend, roas, units_sold, gmv, or observed_active_days.",
|
|
189
|
-
"enum": [
|
|
190
|
-
"last_seen_ad_date",
|
|
191
|
-
"first_seen_ad_date",
|
|
192
|
-
"play_count",
|
|
193
|
-
"estimated_ad_spend",
|
|
194
|
-
"roas",
|
|
195
|
-
"units_sold",
|
|
196
|
-
"gmv",
|
|
197
|
-
"observed_active_days"
|
|
198
|
-
],
|
|
199
|
-
"type": "string"
|
|
200
|
-
},
|
|
201
|
-
"order": {
|
|
202
|
-
"default": "desc",
|
|
203
|
-
"description": "Sort direction: asc or desc. Default desc.",
|
|
204
|
-
"enum": [
|
|
205
|
-
"asc",
|
|
206
|
-
"desc"
|
|
207
|
-
],
|
|
208
|
-
"type": "string"
|
|
209
|
-
}
|
|
210
|
-
},
|
|
211
|
-
"type": "object"
|
|
212
|
-
},
|
|
213
|
-
"type": "array"
|
|
214
|
-
},
|
|
215
|
-
"page": {
|
|
216
|
-
"default": 1,
|
|
217
|
-
"description": "Page number. Default 1, max 10.",
|
|
218
|
-
"maximum": 10,
|
|
219
|
-
"type": "integer"
|
|
220
|
-
},
|
|
221
|
-
"pagesize": {
|
|
222
|
-
"default": 10,
|
|
223
|
-
"description": "Page size. Default 10, max 10.",
|
|
224
|
-
"maximum": 10,
|
|
225
|
-
"type": "integer"
|
|
226
|
-
}
|
|
227
|
-
},
|
|
228
|
-
"type": "object"
|
|
229
|
-
},
|
|
230
|
-
"name": "ad_search"
|
|
231
|
-
},
|
|
232
|
-
{
|
|
233
|
-
"annotations": {
|
|
234
|
-
"title": "Creator ecommerce summary",
|
|
235
|
-
"readOnlyHint": true,
|
|
236
|
-
"destructiveHint": false,
|
|
237
|
-
"idempotentHint": false,
|
|
238
|
-
"openWorldHint": true
|
|
239
|
-
},
|
|
240
|
-
"description": "Use when the user wants a creator video-vs-live selling split and main promoted categories.",
|
|
241
|
-
"inputSchema": {
|
|
242
|
-
"properties": {
|
|
243
|
-
"filter": {
|
|
244
|
-
"description": "Filter parameters.",
|
|
245
|
-
"properties": {
|
|
246
|
-
"uid": {
|
|
247
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
248
|
-
"type": "string"
|
|
249
|
-
}
|
|
250
|
-
},
|
|
251
|
-
"required": [
|
|
252
|
-
"uid"
|
|
253
|
-
],
|
|
254
|
-
"type": "object"
|
|
255
|
-
}
|
|
256
|
-
},
|
|
257
|
-
"required": [
|
|
258
|
-
"filter"
|
|
259
|
-
],
|
|
260
|
-
"type": "object"
|
|
261
|
-
},
|
|
262
|
-
"name": "creator_cargo_summary"
|
|
263
|
-
},
|
|
264
|
-
{
|
|
265
|
-
"annotations": {
|
|
266
|
-
"title": "Creator data trends",
|
|
267
|
-
"readOnlyHint": true,
|
|
268
|
-
"destructiveHint": false,
|
|
269
|
-
"idempotentHint": false,
|
|
270
|
-
"openWorldHint": true
|
|
271
|
-
},
|
|
272
|
-
"description": "Use when the user asks about creator follower, engagement, or commerce trends. Select field_type; returns daily series and period totals.",
|
|
273
|
-
"inputSchema": {
|
|
274
|
-
"properties": {
|
|
275
|
-
"filter": {
|
|
276
|
-
"description": "Filter parameters.",
|
|
277
|
-
"properties": {
|
|
278
|
-
"date_type": {
|
|
279
|
-
"description": "Ranking period: day, week, or month.",
|
|
280
|
-
"type": "integer"
|
|
281
|
-
},
|
|
282
|
-
"end_date": {
|
|
283
|
-
"description": "End date, YYYY-MM-DD.",
|
|
284
|
-
"type": "string"
|
|
285
|
-
},
|
|
286
|
-
"field_type": {
|
|
287
|
-
"description": "Metric: follower_change/play/like/comment/collect_count/share/units_sold/gmv; video_*=video commerce, live_*=live commerce, showcase_*=showcase commerce.",
|
|
288
|
-
"enum": [
|
|
289
|
-
"follower_change",
|
|
290
|
-
"play_count",
|
|
291
|
-
"like_count",
|
|
292
|
-
"comment_count",
|
|
293
|
-
"collect_count",
|
|
294
|
-
"share_count",
|
|
295
|
-
"units_sold",
|
|
296
|
-
"gmv",
|
|
297
|
-
"video_units_sold",
|
|
298
|
-
"video_gmv",
|
|
299
|
-
"live_units_sold",
|
|
300
|
-
"live_gmv",
|
|
301
|
-
"showcase_units_sold",
|
|
302
|
-
"showcase_gmv"
|
|
303
|
-
],
|
|
304
|
-
"type": "string"
|
|
305
|
-
},
|
|
306
|
-
"start_date": {
|
|
307
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
308
|
-
"type": "string"
|
|
309
|
-
},
|
|
310
|
-
"uid": {
|
|
311
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
312
|
-
"type": "string"
|
|
313
|
-
}
|
|
314
|
-
},
|
|
315
|
-
"required": [
|
|
316
|
-
"uid",
|
|
317
|
-
"field_type"
|
|
318
|
-
],
|
|
319
|
-
"type": "object"
|
|
320
|
-
}
|
|
321
|
-
},
|
|
322
|
-
"required": [
|
|
323
|
-
"filter"
|
|
324
|
-
],
|
|
325
|
-
"type": "object"
|
|
326
|
-
},
|
|
327
|
-
"name": "creator_data_trends"
|
|
328
|
-
},
|
|
329
|
-
{
|
|
330
|
-
"annotations": {
|
|
331
|
-
"title": "Creator fans distribution",
|
|
332
|
-
"readOnlyHint": true,
|
|
333
|
-
"destructiveHint": false,
|
|
334
|
-
"idempotentHint": false,
|
|
335
|
-
"openWorldHint": true
|
|
336
|
-
},
|
|
337
|
-
"description": "Use when the user wants to check whether a creator audience matches a target market. Returns age, gender, location, and top segments.",
|
|
338
|
-
"inputSchema": {
|
|
339
|
-
"properties": {
|
|
340
|
-
"filter": {
|
|
341
|
-
"description": "Filter parameters.",
|
|
342
|
-
"properties": {
|
|
343
|
-
"uid": {
|
|
344
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
345
|
-
"type": "string"
|
|
346
|
-
}
|
|
347
|
-
},
|
|
348
|
-
"required": [
|
|
349
|
-
"uid"
|
|
350
|
-
],
|
|
351
|
-
"type": "object"
|
|
352
|
-
}
|
|
353
|
-
},
|
|
354
|
-
"required": [
|
|
355
|
-
"filter"
|
|
356
|
-
],
|
|
357
|
-
"type": "object"
|
|
358
|
-
},
|
|
359
|
-
"name": "creator_fans_distribution"
|
|
360
|
-
},
|
|
361
|
-
{
|
|
362
|
-
"annotations": {
|
|
363
|
-
"title": "Creator product list",
|
|
364
|
-
"readOnlyHint": true,
|
|
365
|
-
"destructiveHint": false,
|
|
366
|
-
"idempotentHint": false,
|
|
367
|
-
"openWorldHint": true
|
|
368
|
-
},
|
|
369
|
-
"description": "Use when the user wants a creator showcase product list. Returns product GMV, units sold, category, price, commission, shop info, and time_range_days.",
|
|
370
|
-
"inputSchema": {
|
|
371
|
-
"properties": {
|
|
372
|
-
"filter": {
|
|
373
|
-
"description": "Filter parameters.",
|
|
374
|
-
"properties": {
|
|
375
|
-
"time_range_days": {
|
|
376
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
377
|
-
"type": "string"
|
|
378
|
-
},
|
|
379
|
-
"uid": {
|
|
380
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
381
|
-
"type": "string"
|
|
382
|
-
}
|
|
383
|
-
},
|
|
384
|
-
"required": [
|
|
385
|
-
"uid"
|
|
386
|
-
],
|
|
387
|
-
"type": "object"
|
|
388
|
-
},
|
|
389
|
-
"orderby": {
|
|
390
|
-
"description": "Sort options. Only the first sort rule takes effect. Fields: units_sold, gmv, commission_rate_percent.",
|
|
391
|
-
"items": {
|
|
392
|
-
"properties": {
|
|
393
|
-
"field": {
|
|
394
|
-
"enum": [
|
|
395
|
-
"units_sold",
|
|
396
|
-
"gmv",
|
|
397
|
-
"commission_rate_percent"
|
|
398
|
-
],
|
|
399
|
-
"type": "string"
|
|
400
|
-
},
|
|
401
|
-
"order": {
|
|
402
|
-
"default": "desc",
|
|
403
|
-
"enum": [
|
|
404
|
-
"asc",
|
|
405
|
-
"desc"
|
|
406
|
-
],
|
|
407
|
-
"type": "string"
|
|
408
|
-
}
|
|
409
|
-
},
|
|
410
|
-
"type": "object"
|
|
411
|
-
},
|
|
412
|
-
"type": "array"
|
|
413
|
-
},
|
|
414
|
-
"page": {
|
|
415
|
-
"default": 1,
|
|
416
|
-
"description": "Page number. Default 1, max 10.",
|
|
417
|
-
"maximum": 10,
|
|
418
|
-
"type": "integer"
|
|
419
|
-
},
|
|
420
|
-
"pagesize": {
|
|
421
|
-
"default": 10,
|
|
422
|
-
"description": "Page size. Default 10, max 10.",
|
|
423
|
-
"maximum": 10,
|
|
424
|
-
"type": "integer"
|
|
425
|
-
}
|
|
426
|
-
},
|
|
427
|
-
"required": [
|
|
428
|
-
"filter"
|
|
429
|
-
],
|
|
430
|
-
"type": "object"
|
|
431
|
-
},
|
|
432
|
-
"name": "creator_product_list"
|
|
433
|
-
},
|
|
434
|
-
{
|
|
435
|
-
"annotations": {
|
|
436
|
-
"title": "Creator profile overview",
|
|
437
|
-
"readOnlyHint": true,
|
|
438
|
-
"destructiveHint": false,
|
|
439
|
-
"idempotentHint": false,
|
|
440
|
-
"openWorldHint": true
|
|
441
|
-
},
|
|
442
|
-
"description": "Use when the user wants a creator snapshot or partnership check. Returns profile and performance_overview; GMV/rankings are mostly historical cumulative, so use creator_search day28_gmv for current activity.",
|
|
443
|
-
"inputSchema": {
|
|
444
|
-
"properties": {
|
|
445
|
-
"filter": {
|
|
446
|
-
"description": "Filter parameters.",
|
|
447
|
-
"properties": {
|
|
448
|
-
"lang": {
|
|
449
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
450
|
-
"type": "string"
|
|
451
|
-
},
|
|
452
|
-
"uid": {
|
|
453
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
454
|
-
"type": "string"
|
|
455
|
-
}
|
|
456
|
-
},
|
|
457
|
-
"required": [
|
|
458
|
-
"uid"
|
|
459
|
-
],
|
|
460
|
-
"type": "object"
|
|
461
|
-
}
|
|
462
|
-
},
|
|
463
|
-
"required": [
|
|
464
|
-
"filter"
|
|
465
|
-
],
|
|
466
|
-
"type": "object"
|
|
467
|
-
},
|
|
468
|
-
"name": "creator_profile_overview"
|
|
469
|
-
},
|
|
470
|
-
{
|
|
471
|
-
"annotations": {
|
|
472
|
-
"title": "Top ecommerce creators",
|
|
473
|
-
"readOnlyHint": true,
|
|
474
|
-
"destructiveHint": false,
|
|
475
|
-
"idempotentHint": false,
|
|
476
|
-
"openWorldHint": true
|
|
477
|
-
},
|
|
478
|
-
"description": "Use when the user wants top ecommerce creators. Returns creator and ranking_metrics; date_value is returned as YYYY-Www for weekly rankings.",
|
|
479
|
-
"inputSchema": {
|
|
480
|
-
"properties": {
|
|
481
|
-
"filter": {
|
|
482
|
-
"description": "Filter parameters.",
|
|
483
|
-
"properties": {
|
|
484
|
-
"account_type": {
|
|
485
|
-
"description": "Account type parameter.",
|
|
486
|
-
"type": "integer"
|
|
487
|
-
},
|
|
488
|
-
"creator_category_id": {
|
|
489
|
-
"description": "Creator category ID.",
|
|
490
|
-
"type": "integer"
|
|
491
|
-
},
|
|
492
|
-
"date_type": {
|
|
493
|
-
"description": "Ranking period: day, week, or month.",
|
|
494
|
-
"enum": [
|
|
495
|
-
"day",
|
|
496
|
-
"week",
|
|
497
|
-
"month"
|
|
498
|
-
],
|
|
499
|
-
"type": "string"
|
|
500
|
-
},
|
|
501
|
-
"date_value": {
|
|
502
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
503
|
-
"type": "string"
|
|
504
|
-
},
|
|
505
|
-
"ecommerce_type": {
|
|
506
|
-
"description": "Ecommerce type parameter.",
|
|
507
|
-
"type": "integer"
|
|
508
|
-
},
|
|
509
|
-
"product_category_id": {
|
|
510
|
-
"description": "Product category ID.",
|
|
511
|
-
"type": "integer"
|
|
512
|
-
},
|
|
513
|
-
"region": {
|
|
514
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
515
|
-
"type": "string"
|
|
516
|
-
}
|
|
517
|
-
},
|
|
518
|
-
"required": [
|
|
519
|
-
"date_type",
|
|
520
|
-
"date_value"
|
|
521
|
-
],
|
|
522
|
-
"type": "object"
|
|
523
|
-
},
|
|
524
|
-
"orderby": {
|
|
525
|
-
"description": "Sort options.",
|
|
526
|
-
"items": {
|
|
527
|
-
"properties": {
|
|
528
|
-
"field": {
|
|
529
|
-
"enum": [
|
|
530
|
-
"creator_usd_gmv",
|
|
531
|
-
"video_usd_gmv",
|
|
532
|
-
"live_usd_gmv"
|
|
533
|
-
],
|
|
534
|
-
"type": "string"
|
|
535
|
-
},
|
|
536
|
-
"order": {
|
|
537
|
-
"default": "desc",
|
|
538
|
-
"enum": [
|
|
539
|
-
"asc",
|
|
540
|
-
"desc"
|
|
541
|
-
],
|
|
542
|
-
"type": "string"
|
|
543
|
-
}
|
|
544
|
-
},
|
|
545
|
-
"type": "object"
|
|
546
|
-
},
|
|
547
|
-
"type": "array"
|
|
548
|
-
},
|
|
549
|
-
"page": {
|
|
550
|
-
"default": 1,
|
|
551
|
-
"description": "Page number. Default 1, max 10.",
|
|
552
|
-
"maximum": 10,
|
|
553
|
-
"type": "integer"
|
|
554
|
-
},
|
|
555
|
-
"pagesize": {
|
|
556
|
-
"default": 10,
|
|
557
|
-
"description": "Page size. Default 10, max 10.",
|
|
558
|
-
"maximum": 10,
|
|
559
|
-
"type": "integer"
|
|
560
|
-
}
|
|
561
|
-
},
|
|
562
|
-
"type": "object"
|
|
563
|
-
},
|
|
564
|
-
"name": "creator_rank_top_ecommerce"
|
|
565
|
-
},
|
|
566
|
-
{
|
|
567
|
-
"annotations": {
|
|
568
|
-
"title": "Top creator follower growth",
|
|
569
|
-
"readOnlyHint": true,
|
|
570
|
-
"destructiveHint": false,
|
|
571
|
-
"idempotentHint": false,
|
|
572
|
-
"openWorldHint": true
|
|
573
|
-
},
|
|
574
|
-
"description": "Use when the user wants fast-growing creators. Returns creator and growth_metrics; date_value is returned as YYYY-Www for weekly rankings.",
|
|
575
|
-
"inputSchema": {
|
|
576
|
-
"properties": {
|
|
577
|
-
"filter": {
|
|
578
|
-
"description": "Filter parameters.",
|
|
579
|
-
"properties": {
|
|
580
|
-
"category_id": {
|
|
581
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
582
|
-
"type": "integer"
|
|
583
|
-
},
|
|
584
|
-
"date_type": {
|
|
585
|
-
"description": "Ranking period: day, week, or month.",
|
|
586
|
-
"enum": [
|
|
587
|
-
"day",
|
|
588
|
-
"week",
|
|
589
|
-
"month"
|
|
590
|
-
],
|
|
591
|
-
"type": "string"
|
|
592
|
-
},
|
|
593
|
-
"date_value": {
|
|
594
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
595
|
-
"type": "string"
|
|
596
|
-
},
|
|
597
|
-
"region": {
|
|
598
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
599
|
-
"type": "string"
|
|
600
|
-
},
|
|
601
|
-
"verify_type": {
|
|
602
|
-
"description": "Verification type: 1 regular creators, 2 Blue V creators.",
|
|
603
|
-
"enum": [
|
|
604
|
-
1,
|
|
605
|
-
2
|
|
606
|
-
],
|
|
607
|
-
"type": "integer"
|
|
608
|
-
}
|
|
609
|
-
},
|
|
610
|
-
"required": [
|
|
611
|
-
"date_type",
|
|
612
|
-
"date_value"
|
|
613
|
-
],
|
|
614
|
-
"type": "object"
|
|
615
|
-
},
|
|
616
|
-
"orderby": {
|
|
617
|
-
"description": "Sort options.",
|
|
618
|
-
"items": {
|
|
619
|
-
"properties": {
|
|
620
|
-
"field": {
|
|
621
|
-
"enum": [
|
|
622
|
-
"follower_inc_count"
|
|
623
|
-
],
|
|
624
|
-
"type": "string"
|
|
625
|
-
},
|
|
626
|
-
"order": {
|
|
627
|
-
"default": "desc",
|
|
628
|
-
"enum": [
|
|
629
|
-
"asc",
|
|
630
|
-
"desc"
|
|
631
|
-
],
|
|
632
|
-
"type": "string"
|
|
633
|
-
}
|
|
634
|
-
},
|
|
635
|
-
"type": "object"
|
|
636
|
-
},
|
|
637
|
-
"type": "array"
|
|
638
|
-
},
|
|
639
|
-
"page": {
|
|
640
|
-
"default": 1,
|
|
641
|
-
"description": "Page number. Default 1, max 10.",
|
|
642
|
-
"maximum": 10,
|
|
643
|
-
"type": "integer"
|
|
644
|
-
},
|
|
645
|
-
"pagesize": {
|
|
646
|
-
"default": 10,
|
|
647
|
-
"description": "Page size. Default 10, max 10.",
|
|
648
|
-
"maximum": 10,
|
|
649
|
-
"type": "integer"
|
|
650
|
-
}
|
|
651
|
-
},
|
|
652
|
-
"type": "object"
|
|
653
|
-
},
|
|
654
|
-
"name": "creator_rank_top_growth"
|
|
655
|
-
},
|
|
656
|
-
{
|
|
657
|
-
"annotations": {
|
|
658
|
-
"title": "Top potential creators",
|
|
659
|
-
"readOnlyHint": true,
|
|
660
|
-
"destructiveHint": false,
|
|
661
|
-
"idempotentHint": false,
|
|
662
|
-
"openWorldHint": true
|
|
663
|
-
},
|
|
664
|
-
"description": "Use when the user wants creators with ecommerce potential. Returns creator, potential_metrics, and audience_summary; date_value is returned as YYYY-Www for weekly rankings.",
|
|
665
|
-
"inputSchema": {
|
|
666
|
-
"properties": {
|
|
667
|
-
"filter": {
|
|
668
|
-
"description": "Filter parameters.",
|
|
669
|
-
"properties": {
|
|
670
|
-
"category_path": {
|
|
671
|
-
"description": "Category path from level 1 to level 3, e.g. [100, 200, 300].",
|
|
672
|
-
"items": {
|
|
673
|
-
"type": "integer"
|
|
674
|
-
},
|
|
675
|
-
"type": "array"
|
|
676
|
-
},
|
|
677
|
-
"creator_category_id": {
|
|
678
|
-
"description": "Creator category ID.",
|
|
679
|
-
"type": "integer"
|
|
680
|
-
},
|
|
681
|
-
"date_type": {
|
|
682
|
-
"description": "Ranking period: day, week, or month.",
|
|
683
|
-
"enum": [
|
|
684
|
-
"day",
|
|
685
|
-
"week",
|
|
686
|
-
"month"
|
|
687
|
-
],
|
|
688
|
-
"type": "string"
|
|
689
|
-
},
|
|
690
|
-
"date_value": {
|
|
691
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
692
|
-
"type": "string"
|
|
693
|
-
},
|
|
694
|
-
"ecommerce_type": {
|
|
695
|
-
"description": "Ecommerce type parameter.",
|
|
696
|
-
"type": "integer"
|
|
697
|
-
},
|
|
698
|
-
"follower_age_type": {
|
|
699
|
-
"description": "Follower age: 1=18-24, 2=25-34, 3=35+.",
|
|
700
|
-
"type": "object"
|
|
701
|
-
},
|
|
702
|
-
"follower_count_range": {
|
|
703
|
-
"description": "Follower count range: {\"min\": number, \"max\": number}.",
|
|
704
|
-
"properties": {
|
|
705
|
-
"max": {
|
|
706
|
-
"description": "Maximum value.",
|
|
707
|
-
"type": "number"
|
|
708
|
-
},
|
|
709
|
-
"min": {
|
|
710
|
-
"description": "Minimum value.",
|
|
711
|
-
"type": "number"
|
|
712
|
-
}
|
|
713
|
-
},
|
|
714
|
-
"type": "object"
|
|
715
|
-
},
|
|
716
|
-
"follower_gender_type": {
|
|
717
|
-
"description": "Follower gender type parameter.",
|
|
718
|
-
"type": "integer"
|
|
719
|
-
},
|
|
720
|
-
"region": {
|
|
721
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
722
|
-
"type": "string"
|
|
723
|
-
}
|
|
724
|
-
},
|
|
725
|
-
"required": [
|
|
726
|
-
"date_type",
|
|
727
|
-
"date_value"
|
|
728
|
-
],
|
|
729
|
-
"type": "object"
|
|
730
|
-
},
|
|
731
|
-
"orderby": {
|
|
732
|
-
"description": "Sort options.",
|
|
733
|
-
"items": {
|
|
734
|
-
"properties": {
|
|
735
|
-
"field": {
|
|
736
|
-
"enum": [
|
|
737
|
-
"potential_index"
|
|
738
|
-
],
|
|
739
|
-
"type": "string"
|
|
740
|
-
},
|
|
741
|
-
"order": {
|
|
742
|
-
"default": "desc",
|
|
743
|
-
"enum": [
|
|
744
|
-
"asc",
|
|
745
|
-
"desc"
|
|
746
|
-
],
|
|
747
|
-
"type": "string"
|
|
748
|
-
}
|
|
749
|
-
},
|
|
750
|
-
"type": "object"
|
|
751
|
-
},
|
|
752
|
-
"type": "array"
|
|
753
|
-
},
|
|
754
|
-
"page": {
|
|
755
|
-
"default": 1,
|
|
756
|
-
"description": "Page number. Default 1, max 10.",
|
|
757
|
-
"maximum": 10,
|
|
758
|
-
"type": "integer"
|
|
759
|
-
},
|
|
760
|
-
"pagesize": {
|
|
761
|
-
"default": 10,
|
|
762
|
-
"description": "Page size. Default 10, max 10.",
|
|
763
|
-
"maximum": 10,
|
|
764
|
-
"type": "integer"
|
|
765
|
-
}
|
|
766
|
-
},
|
|
767
|
-
"type": "object"
|
|
768
|
-
},
|
|
769
|
-
"name": "creator_rank_top_potential"
|
|
770
|
-
},
|
|
771
|
-
{
|
|
772
|
-
"annotations": {
|
|
773
|
-
"title": "Creator search",
|
|
774
|
-
"readOnlyHint": true,
|
|
775
|
-
"destructiveHint": false,
|
|
776
|
-
"idempotentHint": false,
|
|
777
|
-
"openWorldHint": true
|
|
778
|
-
},
|
|
779
|
-
"description": "Use when the user has no UID and provides a nickname, keyword, niche, or region. Returns creator, commerce_summary, and audience_summary; day28_gmv is the key current-activity metric for tiering; has_email as a boolean, not the email address itself.",
|
|
780
|
-
"inputSchema": {
|
|
781
|
-
"properties": {
|
|
782
|
-
"filter": {
|
|
783
|
-
"description": "Filter parameters.",
|
|
784
|
-
"properties": {
|
|
785
|
-
"category_id": {
|
|
786
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
787
|
-
"type": "integer"
|
|
788
|
-
},
|
|
789
|
-
"creator_type": {
|
|
790
|
-
"description": "Creator type: 1 personal, 2 shop.",
|
|
791
|
-
"type": "integer"
|
|
792
|
-
},
|
|
793
|
-
"follower_age_type": {
|
|
794
|
-
"description": "Follower age: 1=18-24, 2=25-34, 3=35+.",
|
|
795
|
-
"type": "integer"
|
|
796
|
-
},
|
|
797
|
-
"follower_gender_type": {
|
|
798
|
-
"description": "Follower gender type parameter.",
|
|
799
|
-
"type": "integer"
|
|
800
|
-
},
|
|
801
|
-
"follower_range": {
|
|
802
|
-
"description": "Follower count range: {\"min\": number, \"max\": number}.",
|
|
803
|
-
"properties": {
|
|
804
|
-
"max": {
|
|
805
|
-
"description": "Maximum value.",
|
|
806
|
-
"type": "number"
|
|
807
|
-
},
|
|
808
|
-
"min": {
|
|
809
|
-
"description": "Minimum value.",
|
|
810
|
-
"type": "number"
|
|
811
|
-
}
|
|
812
|
-
},
|
|
813
|
-
"type": "object"
|
|
814
|
-
},
|
|
815
|
-
"is_ecommerce_creator": {
|
|
816
|
-
"description": "Is ecommerce creator parameter.",
|
|
817
|
-
"type": "boolean"
|
|
818
|
-
},
|
|
819
|
-
"is_mcn_creator": {
|
|
820
|
-
"description": "Is mcn creator parameter.",
|
|
821
|
-
"type": "boolean"
|
|
822
|
-
},
|
|
823
|
-
"region": {
|
|
824
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
825
|
-
"type": "string"
|
|
826
|
-
},
|
|
827
|
-
"uid": {
|
|
828
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
829
|
-
"type": "string"
|
|
830
|
-
},
|
|
831
|
-
"unique_id": {
|
|
832
|
-
"description": "Unique id.",
|
|
833
|
-
"type": "string"
|
|
834
|
-
},
|
|
835
|
-
"verify_type": {
|
|
836
|
-
"description": "Verification type: 1 regular creators, 2 Blue V creators.",
|
|
837
|
-
"type": "integer"
|
|
838
|
-
}
|
|
839
|
-
},
|
|
840
|
-
"type": "object"
|
|
841
|
-
},
|
|
842
|
-
"keywords": {
|
|
843
|
-
"description": "Search keywords: product, shop, creator, video, live, or category terms.",
|
|
844
|
-
"type": "string"
|
|
845
|
-
},
|
|
846
|
-
"orderby": {
|
|
847
|
-
"description": "Sort options.",
|
|
848
|
-
"items": {
|
|
849
|
-
"properties": {
|
|
850
|
-
"field": {
|
|
851
|
-
"enum": [
|
|
852
|
-
"follower_count",
|
|
853
|
-
"day28_follower_count",
|
|
854
|
-
"video_count",
|
|
855
|
-
"video_avg_play_count",
|
|
856
|
-
"video_avg_digg_count",
|
|
857
|
-
"day28_units_sold",
|
|
858
|
-
"day28_gmv"
|
|
859
|
-
],
|
|
860
|
-
"type": "string"
|
|
861
|
-
},
|
|
862
|
-
"order": {
|
|
863
|
-
"default": "desc",
|
|
864
|
-
"enum": [
|
|
865
|
-
"asc",
|
|
866
|
-
"desc"
|
|
867
|
-
],
|
|
868
|
-
"type": "string"
|
|
869
|
-
}
|
|
870
|
-
},
|
|
871
|
-
"type": "object"
|
|
872
|
-
},
|
|
873
|
-
"type": "array"
|
|
874
|
-
},
|
|
875
|
-
"page": {
|
|
876
|
-
"default": 1,
|
|
877
|
-
"description": "Page number. Default 1, max 10.",
|
|
878
|
-
"maximum": 10,
|
|
879
|
-
"type": "integer"
|
|
880
|
-
},
|
|
881
|
-
"pagesize": {
|
|
882
|
-
"default": 10,
|
|
883
|
-
"description": "Page size. Default 10, max 10.",
|
|
884
|
-
"maximum": 10,
|
|
885
|
-
"type": "integer"
|
|
886
|
-
}
|
|
887
|
-
},
|
|
888
|
-
"type": "object"
|
|
889
|
-
},
|
|
890
|
-
"name": "creator_search"
|
|
891
|
-
},
|
|
892
|
-
{
|
|
893
|
-
"annotations": {
|
|
894
|
-
"title": "Creator video analysis",
|
|
895
|
-
"readOnlyHint": true,
|
|
896
|
-
"destructiveHint": false,
|
|
897
|
-
"idempotentHint": false,
|
|
898
|
-
"openWorldHint": true
|
|
899
|
-
},
|
|
900
|
-
"description": "Use when the user wants creator content direction, tags, and selling videos. Returns video_tag_summary and video_list with interaction_rate_percent and linked_products so the model does not confuse video performance with product performance.",
|
|
901
|
-
"inputSchema": {
|
|
902
|
-
"properties": {
|
|
903
|
-
"filter": {
|
|
904
|
-
"description": "Filter parameters.",
|
|
905
|
-
"properties": {
|
|
906
|
-
"end_date": {
|
|
907
|
-
"description": "End date, YYYY-MM-DD.",
|
|
908
|
-
"type": "string"
|
|
909
|
-
},
|
|
910
|
-
"orderby": {
|
|
911
|
-
"description": "Sort options.",
|
|
912
|
-
"items": {
|
|
913
|
-
"properties": {
|
|
914
|
-
"field": {
|
|
915
|
-
"enum": [
|
|
916
|
-
"create_time",
|
|
917
|
-
"play_count",
|
|
918
|
-
"digg_count",
|
|
919
|
-
"share_count",
|
|
920
|
-
"comment_count",
|
|
921
|
-
"sold_count",
|
|
922
|
-
"sale_amount"
|
|
923
|
-
],
|
|
924
|
-
"type": "string"
|
|
925
|
-
},
|
|
926
|
-
"order": {
|
|
927
|
-
"default": "desc",
|
|
928
|
-
"enum": [
|
|
929
|
-
"asc",
|
|
930
|
-
"desc"
|
|
931
|
-
],
|
|
932
|
-
"type": "string"
|
|
933
|
-
}
|
|
934
|
-
},
|
|
935
|
-
"type": "object"
|
|
936
|
-
},
|
|
937
|
-
"type": "array"
|
|
938
|
-
},
|
|
939
|
-
"page": {
|
|
940
|
-
"description": "Page number. Default 1, max 10.",
|
|
941
|
-
"maximum": 10,
|
|
942
|
-
"type": "integer"
|
|
943
|
-
},
|
|
944
|
-
"pagesize": {
|
|
945
|
-
"description": "Page size. Default 10, max 10.",
|
|
946
|
-
"maximum": 10,
|
|
947
|
-
"type": "integer"
|
|
948
|
-
},
|
|
949
|
-
"start_date": {
|
|
950
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
951
|
-
"type": "string"
|
|
952
|
-
},
|
|
953
|
-
"time_range_days": {
|
|
954
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
955
|
-
"enum": [
|
|
956
|
-
7,
|
|
957
|
-
14,
|
|
958
|
-
28,
|
|
959
|
-
90
|
|
960
|
-
],
|
|
961
|
-
"type": "integer"
|
|
962
|
-
},
|
|
963
|
-
"type": {
|
|
964
|
-
"description": "Type parameter.",
|
|
965
|
-
"type": "string"
|
|
966
|
-
},
|
|
967
|
-
"uid": {
|
|
968
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
969
|
-
"type": "string"
|
|
970
|
-
}
|
|
971
|
-
},
|
|
972
|
-
"required": [
|
|
973
|
-
"uid"
|
|
974
|
-
],
|
|
975
|
-
"type": "object"
|
|
976
|
-
}
|
|
977
|
-
},
|
|
978
|
-
"required": [
|
|
979
|
-
"filter"
|
|
980
|
-
],
|
|
981
|
-
"type": "object"
|
|
982
|
-
},
|
|
983
|
-
"name": "creator_video_analysis"
|
|
984
|
-
},
|
|
985
|
-
{
|
|
986
|
-
"annotations": {
|
|
987
|
-
"title": "FastMoss Detail URL Examples",
|
|
988
|
-
"readOnlyHint": true,
|
|
989
|
-
"destructiveHint": false,
|
|
990
|
-
"idempotentHint": false,
|
|
991
|
-
"openWorldHint": true
|
|
992
|
-
},
|
|
993
|
-
"description": "Use when the AI needs FastMoss detail-page links. Takes no arguments and returns product, creator, shop, video, and live URL templates.",
|
|
994
|
-
"inputSchema": {
|
|
995
|
-
"properties": {},
|
|
996
|
-
"type": "object"
|
|
997
|
-
},
|
|
998
|
-
"name": "fastmoss_detail_url_examples"
|
|
999
|
-
},
|
|
1000
|
-
{
|
|
1001
|
-
"annotations": {
|
|
1002
|
-
"title": "Live detail analysis and category breakdown",
|
|
1003
|
-
"readOnlyHint": true,
|
|
1004
|
-
"destructiveHint": false,
|
|
1005
|
-
"idempotentHint": false,
|
|
1006
|
-
"openWorldHint": true
|
|
1007
|
-
},
|
|
1008
|
-
"description": "Use when the user wants one live session info, creator, key performance, and category breakdown.",
|
|
1009
|
-
"inputSchema": {
|
|
1010
|
-
"properties": {
|
|
1011
|
-
"filter": {
|
|
1012
|
-
"description": "Filter parameters.",
|
|
1013
|
-
"properties": {
|
|
1014
|
-
"room_id": {
|
|
1015
|
-
"description": "Live room ID; use live_search first if only a title/host/shop is known.",
|
|
1016
|
-
"type": "string"
|
|
1017
|
-
}
|
|
1018
|
-
},
|
|
1019
|
-
"required": [
|
|
1020
|
-
"room_id"
|
|
1021
|
-
],
|
|
1022
|
-
"type": "object"
|
|
1023
|
-
},
|
|
1024
|
-
"lang": {
|
|
1025
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
1026
|
-
"type": "string"
|
|
1027
|
-
}
|
|
1028
|
-
},
|
|
1029
|
-
"required": [
|
|
1030
|
-
"filter"
|
|
1031
|
-
],
|
|
1032
|
-
"type": "object"
|
|
1033
|
-
},
|
|
1034
|
-
"name": "live_detail_analysis"
|
|
1035
|
-
},
|
|
1036
|
-
{
|
|
1037
|
-
"annotations": {
|
|
1038
|
-
"title": "Live promoted product list",
|
|
1039
|
-
"readOnlyHint": true,
|
|
1040
|
-
"destructiveHint": false,
|
|
1041
|
-
"idempotentHint": false,
|
|
1042
|
-
"openWorldHint": true
|
|
1043
|
-
},
|
|
1044
|
-
"description": "Use when the user wants products sold in a live session or high GMV/units within this live session. Returns live_units_sold, live_gmv, commission_rate_percent, sales_timeline only when pagesize <= 10, and shop_cumulative_units_sold.",
|
|
1045
|
-
"inputSchema": {
|
|
1046
|
-
"properties": {
|
|
1047
|
-
"filter": {
|
|
1048
|
-
"description": "Filter parameters.",
|
|
1049
|
-
"properties": {
|
|
1050
|
-
"category_id": {
|
|
1051
|
-
"description": "Product category ID; omit it to include all categories. Passing 1 also means all.",
|
|
1052
|
-
"type": "integer"
|
|
1053
|
-
},
|
|
1054
|
-
"room_id": {
|
|
1055
|
-
"description": "Live room ID; use live_search first if only a title/host/shop is known.",
|
|
1056
|
-
"type": "string"
|
|
1057
|
-
},
|
|
1058
|
-
"seller_id": {
|
|
1059
|
-
"description": "Shop seller_id; omit it to include all shops. Passing 1 also means all.",
|
|
1060
|
-
"type": "string"
|
|
1061
|
-
}
|
|
1062
|
-
},
|
|
1063
|
-
"required": [
|
|
1064
|
-
"room_id"
|
|
1065
|
-
],
|
|
1066
|
-
"type": "object"
|
|
1067
|
-
},
|
|
1068
|
-
"lang": {
|
|
1069
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
1070
|
-
"type": "string"
|
|
1071
|
-
},
|
|
1072
|
-
"orderby": {
|
|
1073
|
-
"description": "Sort options; only the first sort rule takes effect. Fields: units_sold, gmv.",
|
|
1074
|
-
"items": {
|
|
1075
|
-
"properties": {
|
|
1076
|
-
"field": {
|
|
1077
|
-
"enum": [
|
|
1078
|
-
"units_sold",
|
|
1079
|
-
"gmv"
|
|
1080
|
-
],
|
|
1081
|
-
"type": "string"
|
|
1082
|
-
},
|
|
1083
|
-
"order": {
|
|
1084
|
-
"default": "desc",
|
|
1085
|
-
"enum": [
|
|
1086
|
-
"asc",
|
|
1087
|
-
"desc"
|
|
1088
|
-
],
|
|
1089
|
-
"type": "string"
|
|
1090
|
-
}
|
|
1091
|
-
},
|
|
1092
|
-
"type": "object"
|
|
1093
|
-
},
|
|
1094
|
-
"type": "array"
|
|
1095
|
-
},
|
|
1096
|
-
"page": {
|
|
1097
|
-
"default": 1,
|
|
1098
|
-
"description": "Page number. Default 1, max 10.",
|
|
1099
|
-
"maximum": 10,
|
|
1100
|
-
"type": "integer"
|
|
1101
|
-
},
|
|
1102
|
-
"pagesize": {
|
|
1103
|
-
"default": 10,
|
|
1104
|
-
"description": "Page size. Default 10, max 10; timeline snapshots are returned only when pagesize <= 10.",
|
|
1105
|
-
"maximum": 10,
|
|
1106
|
-
"type": "integer"
|
|
1107
|
-
}
|
|
1108
|
-
},
|
|
1109
|
-
"required": [
|
|
1110
|
-
"filter"
|
|
1111
|
-
],
|
|
1112
|
-
"type": "object"
|
|
1113
|
-
},
|
|
1114
|
-
"name": "live_products_list"
|
|
1115
|
-
},
|
|
1116
|
-
{
|
|
1117
|
-
"annotations": {
|
|
1118
|
-
"title": "Live search",
|
|
1119
|
-
"readOnlyHint": true,
|
|
1120
|
-
"destructiveHint": false,
|
|
1121
|
-
"idempotentHint": false,
|
|
1122
|
-
"openWorldHint": true
|
|
1123
|
-
},
|
|
1124
|
-
"description": "Use when the user has no room_id and provides a live title, host, or shop. Returns live, creator, and performance_summary.",
|
|
1125
|
-
"inputSchema": {
|
|
1126
|
-
"properties": {
|
|
1127
|
-
"filter": {
|
|
1128
|
-
"description": "Filter parameters.",
|
|
1129
|
-
"properties": {
|
|
1130
|
-
"creator_category": {
|
|
1131
|
-
"description": "Creator category ID.",
|
|
1132
|
-
"type": "integer"
|
|
1133
|
-
},
|
|
1134
|
-
"follower_range": {
|
|
1135
|
-
"description": "Follower count range: {\"min\": number, \"max\": number}.",
|
|
1136
|
-
"properties": {
|
|
1137
|
-
"max": {
|
|
1138
|
-
"description": "Maximum value.",
|
|
1139
|
-
"type": "number"
|
|
1140
|
-
},
|
|
1141
|
-
"min": {
|
|
1142
|
-
"description": "Minimum value.",
|
|
1143
|
-
"type": "number"
|
|
1144
|
-
}
|
|
1145
|
-
},
|
|
1146
|
-
"type": "object"
|
|
1147
|
-
},
|
|
1148
|
-
"live_type": {
|
|
1149
|
-
"description": "Live type: 1 shop live, 2 creator live.",
|
|
1150
|
-
"type": "integer"
|
|
1151
|
-
},
|
|
1152
|
-
"product_category": {
|
|
1153
|
-
"description": "Product category ID.",
|
|
1154
|
-
"type": "integer"
|
|
1155
|
-
},
|
|
1156
|
-
"region": {
|
|
1157
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
1158
|
-
"type": "string"
|
|
1159
|
-
},
|
|
1160
|
-
"room_id": {
|
|
1161
|
-
"description": "Live room ID; use live_search first if only a title/host/shop is known.",
|
|
1162
|
-
"type": "string"
|
|
1163
|
-
},
|
|
1164
|
-
"sold_range": {
|
|
1165
|
-
"description": "Sold range range in the form {\"min\": number, \"max\": number}.",
|
|
1166
|
-
"properties": {
|
|
1167
|
-
"max": {
|
|
1168
|
-
"description": "Maximum value.",
|
|
1169
|
-
"type": "number"
|
|
1170
|
-
},
|
|
1171
|
-
"min": {
|
|
1172
|
-
"description": "Minimum value.",
|
|
1173
|
-
"type": "number"
|
|
1174
|
-
}
|
|
1175
|
-
},
|
|
1176
|
-
"type": "object"
|
|
1177
|
-
},
|
|
1178
|
-
"start_time": {
|
|
1179
|
-
"description": "Start time parameter.",
|
|
1180
|
-
"type": "integer"
|
|
1181
|
-
},
|
|
1182
|
-
"viewer_range": {
|
|
1183
|
-
"description": "Viewer range range in the form {\"min\": number, \"max\": number}.",
|
|
1184
|
-
"properties": {
|
|
1185
|
-
"max": {
|
|
1186
|
-
"description": "Maximum value.",
|
|
1187
|
-
"type": "number"
|
|
1188
|
-
},
|
|
1189
|
-
"min": {
|
|
1190
|
-
"description": "Minimum value.",
|
|
1191
|
-
"type": "number"
|
|
1192
|
-
}
|
|
1193
|
-
},
|
|
1194
|
-
"type": "object"
|
|
1195
|
-
}
|
|
1196
|
-
},
|
|
1197
|
-
"required": [
|
|
1198
|
-
"start_time"
|
|
1199
|
-
],
|
|
1200
|
-
"type": "object"
|
|
1201
|
-
},
|
|
1202
|
-
"keywords": {
|
|
1203
|
-
"description": "Search keywords: product, shop, creator, video, live, or category terms.",
|
|
1204
|
-
"type": "string"
|
|
1205
|
-
},
|
|
1206
|
-
"lang": {
|
|
1207
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
1208
|
-
"type": "string"
|
|
1209
|
-
},
|
|
1210
|
-
"orderby": {
|
|
1211
|
-
"description": "Sort options.",
|
|
1212
|
-
"items": {
|
|
1213
|
-
"properties": {
|
|
1214
|
-
"field": {
|
|
1215
|
-
"enum": [
|
|
1216
|
-
"start_time",
|
|
1217
|
-
"total_viewer_count",
|
|
1218
|
-
"total_units_sold",
|
|
1219
|
-
"total_gmv"
|
|
1220
|
-
],
|
|
1221
|
-
"type": "string"
|
|
1222
|
-
},
|
|
1223
|
-
"order": {
|
|
1224
|
-
"default": "desc",
|
|
1225
|
-
"enum": [
|
|
1226
|
-
"asc",
|
|
1227
|
-
"desc"
|
|
1228
|
-
],
|
|
1229
|
-
"type": "string"
|
|
1230
|
-
}
|
|
1231
|
-
},
|
|
1232
|
-
"type": "object"
|
|
1233
|
-
},
|
|
1234
|
-
"type": "array"
|
|
1235
|
-
},
|
|
1236
|
-
"page": {
|
|
1237
|
-
"default": 1,
|
|
1238
|
-
"description": "Page number. Default 1, max 10.",
|
|
1239
|
-
"maximum": 10,
|
|
1240
|
-
"type": "integer"
|
|
1241
|
-
},
|
|
1242
|
-
"pagesize": {
|
|
1243
|
-
"default": 10,
|
|
1244
|
-
"description": "Page size. Default 10, max 10.",
|
|
1245
|
-
"maximum": 10,
|
|
1246
|
-
"type": "integer"
|
|
1247
|
-
}
|
|
1248
|
-
},
|
|
1249
|
-
"type": "object"
|
|
1250
|
-
},
|
|
1251
|
-
"name": "live_search"
|
|
1252
|
-
},
|
|
1253
|
-
{
|
|
1254
|
-
"annotations": {
|
|
1255
|
-
"title": "Category market analysis",
|
|
1256
|
-
"readOnlyHint": true,
|
|
1257
|
-
"destructiveHint": false,
|
|
1258
|
-
"idempotentHint": false,
|
|
1259
|
-
"openWorldHint": true
|
|
1260
|
-
},
|
|
1261
|
-
"description": "Use when the user wants category size, growth, competition, or opportunity. analysis_type basic_metrics returns category, scale_metrics, growth_metrics, concentration_metrics; sales_trends returns trend_series; price_distribution returns sales_price_distribution with left-open right-closed price bands and sub_category_units_sold_total.",
|
|
1262
|
-
"inputSchema": {
|
|
1263
|
-
"properties": {
|
|
1264
|
-
"analysis_type": {
|
|
1265
|
-
"description": "Analysis type parameter.",
|
|
1266
|
-
"enum": [
|
|
1267
|
-
"basic_metrics",
|
|
1268
|
-
"sales_trends",
|
|
1269
|
-
"price_distribution"
|
|
1270
|
-
],
|
|
1271
|
-
"type": "string"
|
|
1272
|
-
},
|
|
1273
|
-
"filter": {
|
|
1274
|
-
"description": "Filter parameters.",
|
|
1275
|
-
"properties": {
|
|
1276
|
-
"category_id": {
|
|
1277
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
1278
|
-
"type": "integer"
|
|
1279
|
-
},
|
|
1280
|
-
"date_type": {
|
|
1281
|
-
"description": "Ranking period: day, week, or month.",
|
|
1282
|
-
"type": "string"
|
|
1283
|
-
},
|
|
1284
|
-
"date_value": {
|
|
1285
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
1286
|
-
"type": "string"
|
|
1287
|
-
},
|
|
1288
|
-
"region": {
|
|
1289
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
1290
|
-
"type": "string"
|
|
1291
|
-
}
|
|
1292
|
-
},
|
|
1293
|
-
"type": "object"
|
|
1294
|
-
},
|
|
1295
|
-
"lang": {
|
|
1296
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
1297
|
-
"type": "string"
|
|
1298
|
-
}
|
|
1299
|
-
},
|
|
1300
|
-
"required": [
|
|
1301
|
-
"filter",
|
|
1302
|
-
"analysis_type"
|
|
1303
|
-
],
|
|
1304
|
-
"type": "object"
|
|
1305
|
-
},
|
|
1306
|
-
"name": "market_category_analysis"
|
|
1307
|
-
},
|
|
1308
|
-
{
|
|
1309
|
-
"annotations": {
|
|
1310
|
-
"title": "Category creator sales matrix",
|
|
1311
|
-
"readOnlyHint": true,
|
|
1312
|
-
"destructiveHint": false,
|
|
1313
|
-
"idempotentHint": false,
|
|
1314
|
-
"openWorldHint": true
|
|
1315
|
-
},
|
|
1316
|
-
"description": "Use when the user wants category sales contribution by creator follower_tier. Returns creator_count, category_gmv, gmv_share_percent, units_sold, and avg_creator_gmv.",
|
|
1317
|
-
"inputSchema": {
|
|
1318
|
-
"properties": {
|
|
1319
|
-
"filter": {
|
|
1320
|
-
"description": "Filter parameters.",
|
|
1321
|
-
"properties": {
|
|
1322
|
-
"category_id": {
|
|
1323
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
1324
|
-
"type": "integer"
|
|
1325
|
-
},
|
|
1326
|
-
"date_value": {
|
|
1327
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
1328
|
-
"type": "string"
|
|
1329
|
-
},
|
|
1330
|
-
"region": {
|
|
1331
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
1332
|
-
"type": "string"
|
|
1333
|
-
},
|
|
1334
|
-
"sold_type": {
|
|
1335
|
-
"description": "Sold type parameter.",
|
|
1336
|
-
"type": "integer"
|
|
1337
|
-
}
|
|
1338
|
-
},
|
|
1339
|
-
"type": "object"
|
|
1340
|
-
},
|
|
1341
|
-
"lang": {
|
|
1342
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
1343
|
-
"type": "string"
|
|
1344
|
-
}
|
|
1345
|
-
},
|
|
1346
|
-
"type": "object"
|
|
1347
|
-
},
|
|
1348
|
-
"name": "market_category_author_sales_matrix"
|
|
1349
|
-
},
|
|
1350
|
-
{
|
|
1351
|
-
"annotations": {
|
|
1352
|
-
"title": "Category market ranking",
|
|
1353
|
-
"readOnlyHint": true,
|
|
1354
|
-
"destructiveHint": false,
|
|
1355
|
-
"idempotentHint": false,
|
|
1356
|
-
"openWorldHint": true
|
|
1357
|
-
},
|
|
1358
|
-
"description": "Use when the user wants category ranking, growth, or concentration. Returns ranking_scope and ranked_categories; no category_id means level-1 category ranking, and a level-1 category_id means level-2 subcategory ranking.",
|
|
1359
|
-
"inputSchema": {
|
|
1360
|
-
"properties": {
|
|
1361
|
-
"filter": {
|
|
1362
|
-
"description": "Filter parameters.",
|
|
1363
|
-
"properties": {
|
|
1364
|
-
"category_id": {
|
|
1365
|
-
"description": "Parent category ID; omit it or set -100 for level-1 ranking, or pass a level-1 category for level-2 ranking.",
|
|
1366
|
-
"type": "integer"
|
|
1367
|
-
},
|
|
1368
|
-
"date_type": {
|
|
1369
|
-
"description": "Ranking period: day, week, or month.",
|
|
1370
|
-
"type": "string"
|
|
1371
|
-
},
|
|
1372
|
-
"date_value": {
|
|
1373
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
1374
|
-
"type": "string"
|
|
1375
|
-
},
|
|
1376
|
-
"region": {
|
|
1377
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
1378
|
-
"type": "string"
|
|
1379
|
-
}
|
|
1380
|
-
},
|
|
1381
|
-
"type": "object"
|
|
1382
|
-
},
|
|
1383
|
-
"lang": {
|
|
1384
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
1385
|
-
"type": "string"
|
|
1386
|
-
},
|
|
1387
|
-
"orderby": {
|
|
1388
|
-
"description": "Sort options. Only the first sort rule takes effect. Use ranking fields such as category_units_sold.",
|
|
1389
|
-
"items": {
|
|
1390
|
-
"properties": {
|
|
1391
|
-
"field": {
|
|
1392
|
-
"enum": [
|
|
1393
|
-
"category_units_sold",
|
|
1394
|
-
"category_units_sold_yoy_percent",
|
|
1395
|
-
"category_gmv_yoy_percent",
|
|
1396
|
-
"top_50_products_units_sold_share_percent",
|
|
1397
|
-
"top_10_shops_units_sold_share_percent"
|
|
1398
|
-
],
|
|
1399
|
-
"type": "string"
|
|
1400
|
-
},
|
|
1401
|
-
"order": {
|
|
1402
|
-
"default": "desc",
|
|
1403
|
-
"enum": [
|
|
1404
|
-
"asc",
|
|
1405
|
-
"desc"
|
|
1406
|
-
],
|
|
1407
|
-
"type": "string"
|
|
1408
|
-
}
|
|
1409
|
-
},
|
|
1410
|
-
"type": "object"
|
|
1411
|
-
},
|
|
1412
|
-
"type": "array"
|
|
1413
|
-
},
|
|
1414
|
-
"page": {
|
|
1415
|
-
"default": 1,
|
|
1416
|
-
"description": "Page number. Default 1, max 10.",
|
|
1417
|
-
"maximum": 10,
|
|
1418
|
-
"type": "integer"
|
|
1419
|
-
},
|
|
1420
|
-
"pagesize": {
|
|
1421
|
-
"default": 10,
|
|
1422
|
-
"description": "Page size. Default 10, max 10.",
|
|
1423
|
-
"maximum": 10,
|
|
1424
|
-
"type": "integer"
|
|
1425
|
-
}
|
|
1426
|
-
},
|
|
1427
|
-
"type": "object"
|
|
1428
|
-
},
|
|
1429
|
-
"name": "market_category_ranking"
|
|
1430
|
-
},
|
|
1431
|
-
{
|
|
1432
|
-
"annotations": {
|
|
1433
|
-
"title": "Product category list",
|
|
1434
|
-
"readOnlyHint": true,
|
|
1435
|
-
"destructiveHint": false,
|
|
1436
|
-
"idempotentHint": false,
|
|
1437
|
-
"openWorldHint": true
|
|
1438
|
-
},
|
|
1439
|
-
"description": "Use when the user needs the product category tree or category levels. Prefer search_category_by_words for natural-language category terms.",
|
|
1440
|
-
"inputSchema": {
|
|
1441
|
-
"properties": {},
|
|
1442
|
-
"type": "object"
|
|
1443
|
-
},
|
|
1444
|
-
"name": "product_category_info"
|
|
1445
|
-
},
|
|
1446
|
-
{
|
|
1447
|
-
"annotations": {
|
|
1448
|
-
"title": "Product creator analysis and creator list",
|
|
1449
|
-
"readOnlyHint": true,
|
|
1450
|
-
"destructiveHint": false,
|
|
1451
|
-
"idempotentHint": false,
|
|
1452
|
-
"openWorldHint": true
|
|
1453
|
-
},
|
|
1454
|
-
"description": "Use when the user wants who sells a product or the creator structure. Returns creator_summary with follower_tier_distribution and creator_category_distribution, plus linked_creators with creator, product_contribution, creator_cumulative_performance, and audience_summary.",
|
|
1455
|
-
"inputSchema": {
|
|
1456
|
-
"properties": {
|
|
1457
|
-
"filter": {
|
|
1458
|
-
"description": "Filter parameters.",
|
|
1459
|
-
"properties": {
|
|
1460
|
-
"product_id": {
|
|
1461
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
1462
|
-
"type": "string"
|
|
1463
|
-
}
|
|
1464
|
-
},
|
|
1465
|
-
"required": [
|
|
1466
|
-
"product_id"
|
|
1467
|
-
],
|
|
1468
|
-
"type": "object"
|
|
1469
|
-
},
|
|
1470
|
-
"orderby": {
|
|
1471
|
-
"description": "Sort options.",
|
|
1472
|
-
"items": {
|
|
1473
|
-
"properties": {
|
|
1474
|
-
"field": {
|
|
1475
|
-
"enum": [
|
|
1476
|
-
"product_gmv",
|
|
1477
|
-
"product_units_sold",
|
|
1478
|
-
"creator_total_like_count",
|
|
1479
|
-
"follower_count"
|
|
1480
|
-
],
|
|
1481
|
-
"type": "string"
|
|
1482
|
-
},
|
|
1483
|
-
"order": {
|
|
1484
|
-
"default": "desc",
|
|
1485
|
-
"enum": [
|
|
1486
|
-
"asc",
|
|
1487
|
-
"desc"
|
|
1488
|
-
],
|
|
1489
|
-
"type": "string"
|
|
1490
|
-
}
|
|
1491
|
-
},
|
|
1492
|
-
"type": "object"
|
|
1493
|
-
},
|
|
1494
|
-
"type": "array"
|
|
1495
|
-
},
|
|
1496
|
-
"page": {
|
|
1497
|
-
"default": 1,
|
|
1498
|
-
"description": "Page number. Default 1, max 10.",
|
|
1499
|
-
"maximum": 10,
|
|
1500
|
-
"type": "integer"
|
|
1501
|
-
},
|
|
1502
|
-
"pagesize": {
|
|
1503
|
-
"default": 10,
|
|
1504
|
-
"description": "Page size. Default 10, max 10.",
|
|
1505
|
-
"maximum": 10,
|
|
1506
|
-
"type": "integer"
|
|
1507
|
-
}
|
|
1508
|
-
},
|
|
1509
|
-
"required": [
|
|
1510
|
-
"filter"
|
|
1511
|
-
],
|
|
1512
|
-
"type": "object"
|
|
1513
|
-
},
|
|
1514
|
-
"name": "product_creator_analysis"
|
|
1515
|
-
},
|
|
1516
|
-
{
|
|
1517
|
-
"annotations": {
|
|
1518
|
-
"title": "Product detail info",
|
|
1519
|
-
"readOnlyHint": true,
|
|
1520
|
-
"destructiveHint": false,
|
|
1521
|
-
"idempotentHint": false,
|
|
1522
|
-
"openWorldHint": true
|
|
1523
|
-
},
|
|
1524
|
-
"description": "Use when the user wants product basics, shop, price, rating, logistics, images, or ad status. Returns product and shop; detail_url points to TikTok.",
|
|
1525
|
-
"inputSchema": {
|
|
1526
|
-
"properties": {
|
|
1527
|
-
"filter": {
|
|
1528
|
-
"description": "Filter parameters.",
|
|
1529
|
-
"properties": {
|
|
1530
|
-
"product_id": {
|
|
1531
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
1532
|
-
"type": "string"
|
|
1533
|
-
}
|
|
1534
|
-
},
|
|
1535
|
-
"required": [
|
|
1536
|
-
"product_id"
|
|
1537
|
-
],
|
|
1538
|
-
"type": "object"
|
|
1539
|
-
}
|
|
1540
|
-
},
|
|
1541
|
-
"required": [
|
|
1542
|
-
"filter"
|
|
1543
|
-
],
|
|
1544
|
-
"type": "object"
|
|
1545
|
-
},
|
|
1546
|
-
"name": "product_detail_info"
|
|
1547
|
-
},
|
|
1548
|
-
{
|
|
1549
|
-
"annotations": {
|
|
1550
|
-
"title": "Product ad investment analysis",
|
|
1551
|
-
"readOnlyHint": true,
|
|
1552
|
-
"destructiveHint": false,
|
|
1553
|
-
"idempotentHint": false,
|
|
1554
|
-
"openWorldHint": true
|
|
1555
|
-
},
|
|
1556
|
-
"description": "Use when the user asks about product ads, spend, ROAS, or daily paid-traffic changes. Returns ad_performance_summary and daily_ad_performance_trend; ad_gmv is ad-attributed.",
|
|
1557
|
-
"inputSchema": {
|
|
1558
|
-
"properties": {
|
|
1559
|
-
"filter": {
|
|
1560
|
-
"description": "Filter parameters.",
|
|
1561
|
-
"properties": {
|
|
1562
|
-
"end_date": {
|
|
1563
|
-
"description": "End date, YYYY-MM-DD.",
|
|
1564
|
-
"type": "string"
|
|
1565
|
-
},
|
|
1566
|
-
"product_id": {
|
|
1567
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
1568
|
-
"type": "string"
|
|
1569
|
-
},
|
|
1570
|
-
"start_date": {
|
|
1571
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
1572
|
-
"type": "string"
|
|
1573
|
-
},
|
|
1574
|
-
"time_range_days": {
|
|
1575
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
1576
|
-
"type": "integer"
|
|
1577
|
-
}
|
|
1578
|
-
},
|
|
1579
|
-
"required": [
|
|
1580
|
-
"product_id"
|
|
1581
|
-
],
|
|
1582
|
-
"type": "object"
|
|
1583
|
-
}
|
|
1584
|
-
},
|
|
1585
|
-
"required": [
|
|
1586
|
-
"filter"
|
|
1587
|
-
],
|
|
1588
|
-
"type": "object"
|
|
1589
|
-
},
|
|
1590
|
-
"name": "product_investment"
|
|
1591
|
-
},
|
|
1592
|
-
{
|
|
1593
|
-
"annotations": {
|
|
1594
|
-
"title": "Product overview",
|
|
1595
|
-
"readOnlyHint": true,
|
|
1596
|
-
"destructiveHint": false,
|
|
1597
|
-
"idempotentHint": false,
|
|
1598
|
-
"openWorldHint": true
|
|
1599
|
-
},
|
|
1600
|
-
"description": "Use when the user wants product channel attribution, lifecycle/momentum, or ad-vs-organic structure. Returns period_summary, daily_trend, ads_distribution, channel_distribution, and content_distribution.",
|
|
1601
|
-
"inputSchema": {
|
|
1602
|
-
"properties": {
|
|
1603
|
-
"filter": {
|
|
1604
|
-
"description": "Filter parameters.",
|
|
1605
|
-
"properties": {
|
|
1606
|
-
"end_date": {
|
|
1607
|
-
"description": "End date, YYYY-MM-DD.",
|
|
1608
|
-
"type": "string"
|
|
1609
|
-
},
|
|
1610
|
-
"product_id": {
|
|
1611
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
1612
|
-
"type": "string"
|
|
1613
|
-
},
|
|
1614
|
-
"start_date": {
|
|
1615
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
1616
|
-
"type": "string"
|
|
1617
|
-
},
|
|
1618
|
-
"time_range_days": {
|
|
1619
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
1620
|
-
"type": "integer"
|
|
1621
|
-
}
|
|
1622
|
-
},
|
|
1623
|
-
"required": [
|
|
1624
|
-
"product_id"
|
|
1625
|
-
],
|
|
1626
|
-
"type": "object"
|
|
1627
|
-
}
|
|
1628
|
-
},
|
|
1629
|
-
"required": [
|
|
1630
|
-
"filter"
|
|
1631
|
-
],
|
|
1632
|
-
"type": "object"
|
|
1633
|
-
},
|
|
1634
|
-
"name": "product_overview"
|
|
1635
|
-
},
|
|
1636
|
-
{
|
|
1637
|
-
"annotations": {
|
|
1638
|
-
"title": "New listed product ranking",
|
|
1639
|
-
"readOnlyHint": true,
|
|
1640
|
-
"destructiveHint": false,
|
|
1641
|
-
"idempotentHint": false,
|
|
1642
|
-
"openWorldHint": true
|
|
1643
|
-
},
|
|
1644
|
-
"description": "Use when the user wants recently listed hot products. Returns FastMoss new-product ranking, first_3d_gmv/units_sold, and total_gmv/units_sold; new means listed within 30 days.",
|
|
1645
|
-
"inputSchema": {
|
|
1646
|
-
"properties": {
|
|
1647
|
-
"filter": {
|
|
1648
|
-
"description": "Filter parameters.",
|
|
1649
|
-
"properties": {
|
|
1650
|
-
"category_id": {
|
|
1651
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
1652
|
-
"type": "integer"
|
|
1653
|
-
},
|
|
1654
|
-
"date_type": {
|
|
1655
|
-
"description": "Ranking period: day, week, or month.",
|
|
1656
|
-
"enum": [
|
|
1657
|
-
"day",
|
|
1658
|
-
"week",
|
|
1659
|
-
"month"
|
|
1660
|
-
],
|
|
1661
|
-
"type": "string"
|
|
1662
|
-
},
|
|
1663
|
-
"date_value": {
|
|
1664
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
1665
|
-
"type": "string"
|
|
1666
|
-
},
|
|
1667
|
-
"is_cross_border": {
|
|
1668
|
-
"description": "Whether it is cross-border.",
|
|
1669
|
-
"type": "boolean"
|
|
1670
|
-
},
|
|
1671
|
-
"is_fully_managed": {
|
|
1672
|
-
"description": "Whether it is fully managed.",
|
|
1673
|
-
"type": "boolean"
|
|
1674
|
-
},
|
|
1675
|
-
"region": {
|
|
1676
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
1677
|
-
"type": "string"
|
|
1678
|
-
}
|
|
1679
|
-
},
|
|
1680
|
-
"required": [
|
|
1681
|
-
"date_type",
|
|
1682
|
-
"date_value"
|
|
1683
|
-
],
|
|
1684
|
-
"type": "object"
|
|
1685
|
-
},
|
|
1686
|
-
"orderby": {
|
|
1687
|
-
"description": "Sort options.",
|
|
1688
|
-
"items": {
|
|
1689
|
-
"properties": {
|
|
1690
|
-
"field": {
|
|
1691
|
-
"enum": [
|
|
1692
|
-
"day3_units_sold",
|
|
1693
|
-
"day3_gmv",
|
|
1694
|
-
"total_units_sold",
|
|
1695
|
-
"total_gmv"
|
|
1696
|
-
],
|
|
1697
|
-
"type": "string"
|
|
1698
|
-
},
|
|
1699
|
-
"order": {
|
|
1700
|
-
"default": "desc",
|
|
1701
|
-
"enum": [
|
|
1702
|
-
"asc",
|
|
1703
|
-
"desc"
|
|
1704
|
-
],
|
|
1705
|
-
"type": "string"
|
|
1706
|
-
}
|
|
1707
|
-
},
|
|
1708
|
-
"type": "object"
|
|
1709
|
-
},
|
|
1710
|
-
"type": "array"
|
|
1711
|
-
},
|
|
1712
|
-
"page": {
|
|
1713
|
-
"default": 1,
|
|
1714
|
-
"description": "Page number. Default 1, max 10.",
|
|
1715
|
-
"maximum": 10,
|
|
1716
|
-
"type": "integer"
|
|
1717
|
-
},
|
|
1718
|
-
"pagesize": {
|
|
1719
|
-
"default": 10,
|
|
1720
|
-
"description": "Page size. Default 10, max 10.",
|
|
1721
|
-
"maximum": 10,
|
|
1722
|
-
"type": "integer"
|
|
1723
|
-
}
|
|
1724
|
-
},
|
|
1725
|
-
"type": "object"
|
|
1726
|
-
},
|
|
1727
|
-
"name": "product_rank_new_listed"
|
|
1728
|
-
},
|
|
1729
|
-
{
|
|
1730
|
-
"annotations": {
|
|
1731
|
-
"title": "Top selling products",
|
|
1732
|
-
"readOnlyHint": true,
|
|
1733
|
-
"destructiveHint": false,
|
|
1734
|
-
"idempotentHint": false,
|
|
1735
|
-
"openWorldHint": true
|
|
1736
|
-
},
|
|
1737
|
-
"description": "Use when the user wants bestsellers or top products. Returns period_gmv/units_sold, total_gmv/units_sold, and units_sold_growth_rate_percent.",
|
|
1738
|
-
"inputSchema": {
|
|
1739
|
-
"properties": {
|
|
1740
|
-
"filter": {
|
|
1741
|
-
"description": "Filter parameters.",
|
|
1742
|
-
"properties": {
|
|
1743
|
-
"category_id": {
|
|
1744
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
1745
|
-
"type": "integer"
|
|
1746
|
-
},
|
|
1747
|
-
"date_type": {
|
|
1748
|
-
"description": "Ranking period: day, week, or month.",
|
|
1749
|
-
"enum": [
|
|
1750
|
-
"day",
|
|
1751
|
-
"week",
|
|
1752
|
-
"month"
|
|
1753
|
-
],
|
|
1754
|
-
"type": "string"
|
|
1755
|
-
},
|
|
1756
|
-
"date_value": {
|
|
1757
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
1758
|
-
"type": "string"
|
|
1759
|
-
},
|
|
1760
|
-
"region": {
|
|
1761
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
1762
|
-
"type": "string"
|
|
1763
|
-
}
|
|
1764
|
-
},
|
|
1765
|
-
"required": [
|
|
1766
|
-
"date_type",
|
|
1767
|
-
"date_value"
|
|
1768
|
-
],
|
|
1769
|
-
"type": "object"
|
|
1770
|
-
},
|
|
1771
|
-
"orderby": {
|
|
1772
|
-
"description": "Sort options.",
|
|
1773
|
-
"items": {
|
|
1774
|
-
"properties": {
|
|
1775
|
-
"field": {
|
|
1776
|
-
"enum": [
|
|
1777
|
-
"period_units_sold",
|
|
1778
|
-
"period_gmv",
|
|
1779
|
-
"total_units_sold",
|
|
1780
|
-
"total_gmv",
|
|
1781
|
-
"units_sold_growth_rate_percent"
|
|
1782
|
-
],
|
|
1783
|
-
"type": "string"
|
|
1784
|
-
},
|
|
1785
|
-
"order": {
|
|
1786
|
-
"default": "desc",
|
|
1787
|
-
"enum": [
|
|
1788
|
-
"asc",
|
|
1789
|
-
"desc"
|
|
1790
|
-
],
|
|
1791
|
-
"type": "string"
|
|
1792
|
-
}
|
|
1793
|
-
},
|
|
1794
|
-
"type": "object"
|
|
1795
|
-
},
|
|
1796
|
-
"type": "array"
|
|
1797
|
-
},
|
|
1798
|
-
"page": {
|
|
1799
|
-
"default": 1,
|
|
1800
|
-
"description": "Page number. Default 1, max 10.",
|
|
1801
|
-
"maximum": 10,
|
|
1802
|
-
"type": "integer"
|
|
1803
|
-
},
|
|
1804
|
-
"pagesize": {
|
|
1805
|
-
"default": 10,
|
|
1806
|
-
"description": "Page size. Default 10, max 10.",
|
|
1807
|
-
"maximum": 10,
|
|
1808
|
-
"type": "integer"
|
|
1809
|
-
}
|
|
1810
|
-
},
|
|
1811
|
-
"type": "object"
|
|
1812
|
-
},
|
|
1813
|
-
"name": "product_rank_top_selling"
|
|
1814
|
-
},
|
|
1815
|
-
{
|
|
1816
|
-
"annotations": {
|
|
1817
|
-
"title": "Product review list",
|
|
1818
|
-
"readOnlyHint": true,
|
|
1819
|
-
"destructiveHint": false,
|
|
1820
|
-
"idempotentHint": false,
|
|
1821
|
-
"openWorldHint": true
|
|
1822
|
-
},
|
|
1823
|
-
"description": "Use when the user wants product reviews or buyer feedback. Returns review list and count; supports time_range_days and rating/create_time/review_id sorting.",
|
|
1824
|
-
"inputSchema": {
|
|
1825
|
-
"properties": {
|
|
1826
|
-
"filter": {
|
|
1827
|
-
"description": "Filter parameters.",
|
|
1828
|
-
"properties": {
|
|
1829
|
-
"product_id": {
|
|
1830
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
1831
|
-
"type": "string"
|
|
1832
|
-
},
|
|
1833
|
-
"time_range_days": {
|
|
1834
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
1835
|
-
"type": "integer"
|
|
1836
|
-
}
|
|
1837
|
-
},
|
|
1838
|
-
"required": [
|
|
1839
|
-
"product_id"
|
|
1840
|
-
],
|
|
1841
|
-
"type": "object"
|
|
1842
|
-
},
|
|
1843
|
-
"orderby": {
|
|
1844
|
-
"description": "Sort options.",
|
|
1845
|
-
"items": {
|
|
1846
|
-
"properties": {
|
|
1847
|
-
"field": {
|
|
1848
|
-
"enum": [
|
|
1849
|
-
"rating",
|
|
1850
|
-
"create_time",
|
|
1851
|
-
"review_id"
|
|
1852
|
-
],
|
|
1853
|
-
"type": "string"
|
|
1854
|
-
},
|
|
1855
|
-
"order": {
|
|
1856
|
-
"default": "desc",
|
|
1857
|
-
"enum": [
|
|
1858
|
-
"asc",
|
|
1859
|
-
"desc"
|
|
1860
|
-
],
|
|
1861
|
-
"type": "string"
|
|
1862
|
-
}
|
|
1863
|
-
},
|
|
1864
|
-
"type": "object"
|
|
1865
|
-
},
|
|
1866
|
-
"type": "array"
|
|
1867
|
-
},
|
|
1868
|
-
"page": {
|
|
1869
|
-
"default": 1,
|
|
1870
|
-
"description": "Page number. Default 1, max 10.",
|
|
1871
|
-
"maximum": 10,
|
|
1872
|
-
"type": "integer"
|
|
1873
|
-
},
|
|
1874
|
-
"pagesize": {
|
|
1875
|
-
"default": 10,
|
|
1876
|
-
"description": "Page size. Default 10, max 10.",
|
|
1877
|
-
"maximum": 10,
|
|
1878
|
-
"type": "integer"
|
|
1879
|
-
}
|
|
1880
|
-
},
|
|
1881
|
-
"type": "object"
|
|
1882
|
-
},
|
|
1883
|
-
"name": "product_review_list"
|
|
1884
|
-
},
|
|
1885
|
-
{
|
|
1886
|
-
"annotations": {
|
|
1887
|
-
"title": "Product sales trend",
|
|
1888
|
-
"readOnlyHint": true,
|
|
1889
|
-
"destructiveHint": false,
|
|
1890
|
-
"idempotentHint": false,
|
|
1891
|
-
"openWorldHint": true
|
|
1892
|
-
},
|
|
1893
|
-
"description": "Use when the user wants a product GMV/units trend or traction check. Returns period_summary and daily_trend with period_gmv, period_units_sold, daily_gmv, and daily_units_sold.",
|
|
1894
|
-
"inputSchema": {
|
|
1895
|
-
"properties": {
|
|
1896
|
-
"filter": {
|
|
1897
|
-
"description": "Filter parameters.",
|
|
1898
|
-
"properties": {
|
|
1899
|
-
"product_id": {
|
|
1900
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
1901
|
-
"type": "string"
|
|
1902
|
-
},
|
|
1903
|
-
"time_range_days": {
|
|
1904
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
1905
|
-
"type": "integer"
|
|
1906
|
-
}
|
|
1907
|
-
},
|
|
1908
|
-
"required": [
|
|
1909
|
-
"product_id",
|
|
1910
|
-
"time_range_days"
|
|
1911
|
-
],
|
|
1912
|
-
"type": "object"
|
|
1913
|
-
}
|
|
1914
|
-
},
|
|
1915
|
-
"type": "object"
|
|
1916
|
-
},
|
|
1917
|
-
"name": "product_sales_trend"
|
|
1918
|
-
},
|
|
1919
|
-
{
|
|
1920
|
-
"annotations": {
|
|
1921
|
-
"title": "Product search",
|
|
1922
|
-
"readOnlyHint": true,
|
|
1923
|
-
"destructiveHint": false,
|
|
1924
|
-
"idempotentHint": false,
|
|
1925
|
-
"openWorldHint": true
|
|
1926
|
-
},
|
|
1927
|
-
"description": "Use when the user has no product_id and provides a name, keyword, price band, category, bestseller clue, or new-product clue. Returns product, sales_summary, distribution_summary, and shop.",
|
|
1928
|
-
"inputSchema": {
|
|
1929
|
-
"properties": {
|
|
1930
|
-
"filter": {
|
|
1931
|
-
"description": "Filter parameters.",
|
|
1932
|
-
"properties": {
|
|
1933
|
-
"category_path": {
|
|
1934
|
-
"description": "Category path from level 1 to level 3, e.g. [100, 200, 300].",
|
|
1935
|
-
"items": {
|
|
1936
|
-
"type": "integer"
|
|
1937
|
-
},
|
|
1938
|
-
"type": "array"
|
|
1939
|
-
},
|
|
1940
|
-
"commission_rate_range": {
|
|
1941
|
-
"description": "Commission-rate range: {\"min\": number, \"max\": number}.",
|
|
1942
|
-
"properties": {
|
|
1943
|
-
"max": {
|
|
1944
|
-
"description": "Maximum value.",
|
|
1945
|
-
"type": "number"
|
|
1946
|
-
},
|
|
1947
|
-
"min": {
|
|
1948
|
-
"description": "Minimum value.",
|
|
1949
|
-
"type": "number"
|
|
1950
|
-
}
|
|
1951
|
-
},
|
|
1952
|
-
"type": "object"
|
|
1953
|
-
},
|
|
1954
|
-
"creator_count_range": {
|
|
1955
|
-
"description": "Creator count range range in the form {\"min\": number, \"max\": number}.",
|
|
1956
|
-
"properties": {
|
|
1957
|
-
"max": {
|
|
1958
|
-
"description": "Maximum value.",
|
|
1959
|
-
"type": "number"
|
|
1960
|
-
},
|
|
1961
|
-
"min": {
|
|
1962
|
-
"description": "Minimum value.",
|
|
1963
|
-
"type": "number"
|
|
1964
|
-
}
|
|
1965
|
-
},
|
|
1966
|
-
"type": "object"
|
|
1967
|
-
},
|
|
1968
|
-
"day28_gmv_range": {
|
|
1969
|
-
"description": "Last-28-day GMV range; maps to day28_sale_amount.",
|
|
1970
|
-
"properties": {
|
|
1971
|
-
"max": {
|
|
1972
|
-
"description": "Maximum value.",
|
|
1973
|
-
"type": "number"
|
|
1974
|
-
},
|
|
1975
|
-
"min": {
|
|
1976
|
-
"description": "Minimum value.",
|
|
1977
|
-
"type": "number"
|
|
1978
|
-
}
|
|
1979
|
-
},
|
|
1980
|
-
"type": "object"
|
|
1981
|
-
},
|
|
1982
|
-
"day28_units_sold_range": {
|
|
1983
|
-
"description": "Last-28-day units-sold range; maps to day28_sold_count.",
|
|
1984
|
-
"properties": {
|
|
1985
|
-
"max": {
|
|
1986
|
-
"description": "Maximum value.",
|
|
1987
|
-
"type": "number"
|
|
1988
|
-
},
|
|
1989
|
-
"min": {
|
|
1990
|
-
"description": "Minimum value.",
|
|
1991
|
-
"type": "number"
|
|
1992
|
-
}
|
|
1993
|
-
},
|
|
1994
|
-
"type": "object"
|
|
1995
|
-
},
|
|
1996
|
-
"day7_gmv_range": {
|
|
1997
|
-
"description": "Last-7-day GMV range; maps to day7_sale_amount.",
|
|
1998
|
-
"properties": {
|
|
1999
|
-
"max": {
|
|
2000
|
-
"description": "Maximum value.",
|
|
2001
|
-
"type": "number"
|
|
2002
|
-
},
|
|
2003
|
-
"min": {
|
|
2004
|
-
"description": "Minimum value.",
|
|
2005
|
-
"type": "number"
|
|
2006
|
-
}
|
|
2007
|
-
},
|
|
2008
|
-
"type": "object"
|
|
2009
|
-
},
|
|
2010
|
-
"day7_units_sold_range": {
|
|
2011
|
-
"description": "Last-7-day units-sold range; maps to day7_sold_count.",
|
|
2012
|
-
"properties": {
|
|
2013
|
-
"max": {
|
|
2014
|
-
"description": "Maximum value.",
|
|
2015
|
-
"type": "number"
|
|
2016
|
-
},
|
|
2017
|
-
"min": {
|
|
2018
|
-
"description": "Minimum value.",
|
|
2019
|
-
"type": "number"
|
|
2020
|
-
}
|
|
2021
|
-
},
|
|
2022
|
-
"type": "object"
|
|
2023
|
-
},
|
|
2024
|
-
"floor_price_range": {
|
|
2025
|
-
"description": "Product price range: {\"min\": number, \"max\": number}.",
|
|
2026
|
-
"properties": {
|
|
2027
|
-
"max": {
|
|
2028
|
-
"description": "Maximum value.",
|
|
2029
|
-
"type": "number"
|
|
2030
|
-
},
|
|
2031
|
-
"min": {
|
|
2032
|
-
"description": "Minimum value.",
|
|
2033
|
-
"type": "number"
|
|
2034
|
-
}
|
|
2035
|
-
},
|
|
2036
|
-
"type": "object"
|
|
2037
|
-
},
|
|
2038
|
-
"is_cross_border": {
|
|
2039
|
-
"description": "Whether it is cross-border.",
|
|
2040
|
-
"type": "boolean"
|
|
2041
|
-
},
|
|
2042
|
-
"is_free_shipping": {
|
|
2043
|
-
"description": "Is free shipping parameter.",
|
|
2044
|
-
"type": "boolean"
|
|
2045
|
-
},
|
|
2046
|
-
"is_fully_managed": {
|
|
2047
|
-
"description": "Whether it is fully managed.",
|
|
2048
|
-
"type": "boolean"
|
|
2049
|
-
},
|
|
2050
|
-
"is_local_warehouse": {
|
|
2051
|
-
"description": "Is local warehouse parameter.",
|
|
2052
|
-
"type": "boolean"
|
|
2053
|
-
},
|
|
2054
|
-
"is_new_listed": {
|
|
2055
|
-
"description": "Is new listed parameter.",
|
|
2056
|
-
"type": "boolean"
|
|
2057
|
-
},
|
|
2058
|
-
"is_sshop": {
|
|
2059
|
-
"description": "Whether it is fully managed.",
|
|
2060
|
-
"type": "boolean"
|
|
2061
|
-
},
|
|
2062
|
-
"is_top_selling": {
|
|
2063
|
-
"description": "Is top selling parameter.",
|
|
2064
|
-
"type": "boolean"
|
|
2065
|
-
},
|
|
2066
|
-
"product_id": {
|
|
2067
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
2068
|
-
"type": "string"
|
|
2069
|
-
},
|
|
2070
|
-
"region": {
|
|
2071
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
2072
|
-
"type": "string"
|
|
2073
|
-
},
|
|
2074
|
-
"shop_type": {
|
|
2075
|
-
"description": "Shop type: 1 local, 2 cross-border; deprecated.",
|
|
2076
|
-
"type": "integer"
|
|
2077
|
-
},
|
|
2078
|
-
"total_gmv_range": {
|
|
2079
|
-
"description": "Total GMV range; maps to sale_amount.",
|
|
2080
|
-
"properties": {
|
|
2081
|
-
"max": {
|
|
2082
|
-
"description": "Maximum value.",
|
|
2083
|
-
"type": "number"
|
|
2084
|
-
},
|
|
2085
|
-
"min": {
|
|
2086
|
-
"description": "Minimum value.",
|
|
2087
|
-
"type": "number"
|
|
2088
|
-
}
|
|
2089
|
-
},
|
|
2090
|
-
"type": "object"
|
|
2091
|
-
},
|
|
2092
|
-
"units_sold_range": {
|
|
2093
|
-
"description": "Units sold range range in the form {\"min\": number, \"max\": number}.",
|
|
2094
|
-
"properties": {
|
|
2095
|
-
"max": {
|
|
2096
|
-
"description": "Maximum value.",
|
|
2097
|
-
"type": "number"
|
|
2098
|
-
},
|
|
2099
|
-
"min": {
|
|
2100
|
-
"description": "Minimum value.",
|
|
2101
|
-
"type": "number"
|
|
2102
|
-
}
|
|
2103
|
-
},
|
|
2104
|
-
"type": "object"
|
|
2105
|
-
}
|
|
2106
|
-
},
|
|
2107
|
-
"type": "object"
|
|
2108
|
-
},
|
|
2109
|
-
"keywords": {
|
|
2110
|
-
"description": "Search keywords: product, shop, creator, video, live, or category terms.",
|
|
2111
|
-
"type": "string"
|
|
2112
|
-
},
|
|
2113
|
-
"orderby": {
|
|
2114
|
-
"description": "Sort options.",
|
|
2115
|
-
"items": {
|
|
2116
|
-
"properties": {
|
|
2117
|
-
"field": {
|
|
2118
|
-
"enum": [
|
|
2119
|
-
"day7_units_sold",
|
|
2120
|
-
"day7_gmv",
|
|
2121
|
-
"day28_units_sold",
|
|
2122
|
-
"day28_gmv",
|
|
2123
|
-
"commission_rate",
|
|
2124
|
-
"total_units_sold",
|
|
2125
|
-
"total_gmv",
|
|
2126
|
-
"creator_count"
|
|
2127
|
-
],
|
|
2128
|
-
"type": "string"
|
|
2129
|
-
},
|
|
2130
|
-
"order": {
|
|
2131
|
-
"default": "desc",
|
|
2132
|
-
"enum": [
|
|
2133
|
-
"asc",
|
|
2134
|
-
"desc"
|
|
2135
|
-
],
|
|
2136
|
-
"type": "string"
|
|
2137
|
-
}
|
|
2138
|
-
},
|
|
2139
|
-
"type": "object"
|
|
2140
|
-
},
|
|
2141
|
-
"type": "array"
|
|
2142
|
-
},
|
|
2143
|
-
"page": {
|
|
2144
|
-
"default": 1,
|
|
2145
|
-
"description": "Page number. Default 1, max 10.",
|
|
2146
|
-
"maximum": 10,
|
|
2147
|
-
"type": "integer"
|
|
2148
|
-
},
|
|
2149
|
-
"pagesize": {
|
|
2150
|
-
"default": 10,
|
|
2151
|
-
"description": "Page size. Default 10, max 10.",
|
|
2152
|
-
"maximum": 10,
|
|
2153
|
-
"type": "integer"
|
|
2154
|
-
}
|
|
2155
|
-
},
|
|
2156
|
-
"type": "object"
|
|
2157
|
-
},
|
|
2158
|
-
"name": "product_search"
|
|
2159
|
-
},
|
|
2160
|
-
{
|
|
2161
|
-
"annotations": {
|
|
2162
|
-
"title": "Product SKU analysis",
|
|
2163
|
-
"readOnlyHint": true,
|
|
2164
|
-
"destructiveHint": false,
|
|
2165
|
-
"idempotentHint": false,
|
|
2166
|
-
"openWorldHint": true
|
|
2167
|
-
},
|
|
2168
|
-
"description": "Use when the user wants SKU sales share, inventory share, or SKU health. Returns SKU-level sales and inventory shares.",
|
|
2169
|
-
"inputSchema": {
|
|
2170
|
-
"properties": {
|
|
2171
|
-
"filter": {
|
|
2172
|
-
"description": "Filter parameters.",
|
|
2173
|
-
"properties": {
|
|
2174
|
-
"product_id": {
|
|
2175
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
2176
|
-
"type": "string"
|
|
2177
|
-
},
|
|
2178
|
-
"time_range_days": {
|
|
2179
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2180
|
-
"type": "integer"
|
|
2181
|
-
}
|
|
2182
|
-
},
|
|
2183
|
-
"required": [
|
|
2184
|
-
"product_id"
|
|
2185
|
-
],
|
|
2186
|
-
"type": "object"
|
|
2187
|
-
}
|
|
2188
|
-
},
|
|
2189
|
-
"required": [
|
|
2190
|
-
"filter"
|
|
2191
|
-
],
|
|
2192
|
-
"type": "object"
|
|
2193
|
-
},
|
|
2194
|
-
"name": "product_sku"
|
|
2195
|
-
},
|
|
2196
|
-
{
|
|
2197
|
-
"annotations": {
|
|
2198
|
-
"title": "Product video list",
|
|
2199
|
-
"readOnlyHint": true,
|
|
2200
|
-
"destructiveHint": false,
|
|
2201
|
-
"idempotentHint": false,
|
|
2202
|
-
"openWorldHint": true
|
|
2203
|
-
},
|
|
2204
|
-
"description": "Use when the user wants videos selling a product, high-play videos, or paid-vs-organic video traffic. Filter with is_ad; returns GMV, plays, video_desc, and fastmoss_url.",
|
|
2205
|
-
"inputSchema": {
|
|
2206
|
-
"properties": {
|
|
2207
|
-
"filter": {
|
|
2208
|
-
"description": "Filter parameters.",
|
|
2209
|
-
"properties": {
|
|
2210
|
-
"create_time_range": {
|
|
2211
|
-
"description": "Creation/publish time range: {\"min\": unix_timestamp, \"max\": unix_timestamp}.",
|
|
2212
|
-
"properties": {
|
|
2213
|
-
"max": {
|
|
2214
|
-
"type": "number"
|
|
2215
|
-
},
|
|
2216
|
-
"min": {
|
|
2217
|
-
"type": "number"
|
|
2218
|
-
}
|
|
2219
|
-
},
|
|
2220
|
-
"type": "object"
|
|
2221
|
-
},
|
|
2222
|
-
"is_ad": {
|
|
2223
|
-
"description": "Whether it uses ad traffic.",
|
|
2224
|
-
"type": "boolean"
|
|
2225
|
-
},
|
|
2226
|
-
"product_id": {
|
|
2227
|
-
"description": "Product ID; use product_search first if only a product name is known.",
|
|
2228
|
-
"type": "string"
|
|
2229
|
-
},
|
|
2230
|
-
"time_range_days": {
|
|
2231
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2232
|
-
"type": "integer"
|
|
2233
|
-
}
|
|
2234
|
-
},
|
|
2235
|
-
"required": [
|
|
2236
|
-
"product_id"
|
|
2237
|
-
],
|
|
2238
|
-
"type": "object"
|
|
2239
|
-
},
|
|
2240
|
-
"orderby": {
|
|
2241
|
-
"description": "Sort options.",
|
|
2242
|
-
"items": {
|
|
2243
|
-
"properties": {
|
|
2244
|
-
"field": {
|
|
2245
|
-
"enum": [
|
|
2246
|
-
"gmv",
|
|
2247
|
-
"units_sold",
|
|
2248
|
-
"digg_count",
|
|
2249
|
-
"play_count",
|
|
2250
|
-
"share_count"
|
|
2251
|
-
],
|
|
2252
|
-
"type": "string"
|
|
2253
|
-
},
|
|
2254
|
-
"order": {
|
|
2255
|
-
"default": "desc",
|
|
2256
|
-
"enum": [
|
|
2257
|
-
"asc",
|
|
2258
|
-
"desc"
|
|
2259
|
-
],
|
|
2260
|
-
"type": "string"
|
|
2261
|
-
}
|
|
2262
|
-
},
|
|
2263
|
-
"type": "object"
|
|
2264
|
-
},
|
|
2265
|
-
"type": "array"
|
|
2266
|
-
},
|
|
2267
|
-
"page": {
|
|
2268
|
-
"default": 1,
|
|
2269
|
-
"description": "Page number. Default 1, max 10.",
|
|
2270
|
-
"maximum": 10,
|
|
2271
|
-
"type": "integer"
|
|
2272
|
-
},
|
|
2273
|
-
"pagesize": {
|
|
2274
|
-
"default": 10,
|
|
2275
|
-
"description": "Page size. Default 10, max 10.",
|
|
2276
|
-
"maximum": 10,
|
|
2277
|
-
"type": "integer"
|
|
2278
|
-
}
|
|
2279
|
-
},
|
|
2280
|
-
"required": [
|
|
2281
|
-
"filter"
|
|
2282
|
-
],
|
|
2283
|
-
"type": "object"
|
|
2284
|
-
},
|
|
2285
|
-
"name": "product_video_list"
|
|
2286
|
-
},
|
|
2287
|
-
{
|
|
2288
|
-
"annotations": {
|
|
2289
|
-
"title": "Search TikTok Product Category by Keywords",
|
|
2290
|
-
"readOnlyHint": true,
|
|
2291
|
-
"destructiveHint": false,
|
|
2292
|
-
"idempotentHint": false,
|
|
2293
|
-
"openWorldHint": true
|
|
2294
|
-
},
|
|
2295
|
-
"description": "Use when the user knows a product/category term but does not have the category_id yet. Returns matched TikTok product category IDs and Chinese category paths.",
|
|
2296
|
-
"inputSchema": {
|
|
2297
|
-
"properties": {
|
|
2298
|
-
"max_total_results": {
|
|
2299
|
-
"default": 15,
|
|
2300
|
-
"description": "Max deduplicated candidates. Default 15.",
|
|
2301
|
-
"type": "integer"
|
|
2302
|
-
},
|
|
2303
|
-
"query": {
|
|
2304
|
-
"description": "Product or category terms, string or array; map natural-language category clues into category_id.",
|
|
2305
|
-
"items": {
|
|
2306
|
-
"type": "string"
|
|
2307
|
-
},
|
|
2308
|
-
"type": [
|
|
2309
|
-
"array",
|
|
2310
|
-
"string"
|
|
2311
|
-
]
|
|
2312
|
-
},
|
|
2313
|
-
"top_k": {
|
|
2314
|
-
"default": 5,
|
|
2315
|
-
"description": "Candidate categories per keyword. Default 5.",
|
|
2316
|
-
"type": "integer"
|
|
2317
|
-
}
|
|
2318
|
-
},
|
|
2319
|
-
"required": [
|
|
2320
|
-
"query"
|
|
2321
|
-
],
|
|
2322
|
-
"type": "object"
|
|
2323
|
-
},
|
|
2324
|
-
"name": "search_category_by_words"
|
|
2325
|
-
},
|
|
2326
|
-
{
|
|
2327
|
-
"annotations": {
|
|
2328
|
-
"title": "FastMoss Knowledge Base Search",
|
|
2329
|
-
"readOnlyHint": true,
|
|
2330
|
-
"destructiveHint": false,
|
|
2331
|
-
"idempotentHint": false,
|
|
2332
|
-
"openWorldHint": true
|
|
2333
|
-
},
|
|
2334
|
-
"description": "Use when the user asks about FastMoss rules, features, terms, or operations rather than real-time business data. Returns knowledge snippets and documents.",
|
|
2335
|
-
"inputSchema": {
|
|
2336
|
-
"properties": {
|
|
2337
|
-
"query": {
|
|
2338
|
-
"description": "Feature terms, terminology, rule questions, or operation questions; string or array.",
|
|
2339
|
-
"items": {
|
|
2340
|
-
"type": "string"
|
|
2341
|
-
},
|
|
2342
|
-
"type": [
|
|
2343
|
-
"array",
|
|
2344
|
-
"string"
|
|
2345
|
-
]
|
|
2346
|
-
},
|
|
2347
|
-
"source_file": {
|
|
2348
|
-
"description": "Optional source file; use it to narrow the search scope and reduce noise.",
|
|
2349
|
-
"type": "string"
|
|
2350
|
-
},
|
|
2351
|
-
"top_k": {
|
|
2352
|
-
"default": 5,
|
|
2353
|
-
"description": "Knowledge snippets per query. Default 5.",
|
|
2354
|
-
"type": "integer"
|
|
2355
|
-
}
|
|
2356
|
-
},
|
|
2357
|
-
"required": [
|
|
2358
|
-
"query"
|
|
2359
|
-
],
|
|
2360
|
-
"type": "object"
|
|
2361
|
-
},
|
|
2362
|
-
"name": "search_fastmoss_documents"
|
|
2363
|
-
},
|
|
2364
|
-
{
|
|
2365
|
-
"annotations": {
|
|
2366
|
-
"title": "Shop base info",
|
|
2367
|
-
"readOnlyHint": true,
|
|
2368
|
-
"destructiveHint": false,
|
|
2369
|
-
"idempotentHint": false,
|
|
2370
|
-
"openWorldHint": true
|
|
2371
|
-
},
|
|
2372
|
-
"description": "Use when the user wants a shop snapshot, store type, rating, or profile. Returns cumulative GMV/units, ranks, age, product count, and creator/video/live counts.",
|
|
2373
|
-
"inputSchema": {
|
|
2374
|
-
"properties": {
|
|
2375
|
-
"filter": {
|
|
2376
|
-
"description": "Filter parameters.",
|
|
2377
|
-
"properties": {
|
|
2378
|
-
"seller_id": {
|
|
2379
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
2380
|
-
"type": "string"
|
|
2381
|
-
}
|
|
2382
|
-
},
|
|
2383
|
-
"required": [
|
|
2384
|
-
"seller_id"
|
|
2385
|
-
],
|
|
2386
|
-
"type": "object"
|
|
2387
|
-
}
|
|
2388
|
-
},
|
|
2389
|
-
"required": [
|
|
2390
|
-
"filter"
|
|
2391
|
-
],
|
|
2392
|
-
"type": "object"
|
|
2393
|
-
},
|
|
2394
|
-
"name": "shop_base_info"
|
|
2395
|
-
},
|
|
2396
|
-
{
|
|
2397
|
-
"annotations": {
|
|
2398
|
-
"title": "Shop creator analysis and creator list",
|
|
2399
|
-
"readOnlyHint": true,
|
|
2400
|
-
"destructiveHint": false,
|
|
2401
|
-
"idempotentHint": false,
|
|
2402
|
-
"openWorldHint": true
|
|
2403
|
-
},
|
|
2404
|
-
"description": "Use when the user wants shop collaborators, creator tiers, or video-vs-live selling structure. Returns creator list and distributions.",
|
|
2405
|
-
"inputSchema": {
|
|
2406
|
-
"properties": {
|
|
2407
|
-
"filter": {
|
|
2408
|
-
"description": "Filter parameters.",
|
|
2409
|
-
"properties": {
|
|
2410
|
-
"author_product_type": {
|
|
2411
|
-
"description": "Selling mode: 1 video, 2 live.",
|
|
2412
|
-
"enum": [
|
|
2413
|
-
1,
|
|
2414
|
-
2
|
|
2415
|
-
],
|
|
2416
|
-
"type": "integer"
|
|
2417
|
-
},
|
|
2418
|
-
"follower_count_range": {
|
|
2419
|
-
"description": "Follower count range: {\"min\": number, \"max\": number}.",
|
|
2420
|
-
"properties": {
|
|
2421
|
-
"max": {
|
|
2422
|
-
"description": "Maximum value.",
|
|
2423
|
-
"type": "number"
|
|
2424
|
-
},
|
|
2425
|
-
"min": {
|
|
2426
|
-
"description": "Minimum value.",
|
|
2427
|
-
"type": "number"
|
|
2428
|
-
}
|
|
2429
|
-
},
|
|
2430
|
-
"type": "object"
|
|
2431
|
-
},
|
|
2432
|
-
"seller_id": {
|
|
2433
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
2434
|
-
"type": "string"
|
|
2435
|
-
},
|
|
2436
|
-
"sold_count_range": {
|
|
2437
|
-
"description": "Units sold range: {\"min\": number, \"max\": number}.",
|
|
2438
|
-
"properties": {
|
|
2439
|
-
"max": {
|
|
2440
|
-
"description": "Maximum value.",
|
|
2441
|
-
"type": "number"
|
|
2442
|
-
},
|
|
2443
|
-
"min": {
|
|
2444
|
-
"description": "Minimum value.",
|
|
2445
|
-
"type": "number"
|
|
2446
|
-
}
|
|
2447
|
-
},
|
|
2448
|
-
"type": "object"
|
|
2449
|
-
},
|
|
2450
|
-
"time_range_days": {
|
|
2451
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2452
|
-
"enum": [
|
|
2453
|
-
7,
|
|
2454
|
-
28,
|
|
2455
|
-
90,
|
|
2456
|
-
-1
|
|
2457
|
-
],
|
|
2458
|
-
"type": "integer"
|
|
2459
|
-
}
|
|
2460
|
-
},
|
|
2461
|
-
"required": [
|
|
2462
|
-
"seller_id"
|
|
2463
|
-
],
|
|
2464
|
-
"type": "object"
|
|
2465
|
-
},
|
|
2466
|
-
"orderby": {
|
|
2467
|
-
"description": "Sort options.",
|
|
2468
|
-
"items": {
|
|
2469
|
-
"properties": {
|
|
2470
|
-
"field": {
|
|
2471
|
-
"enum": [
|
|
2472
|
-
"follower_count",
|
|
2473
|
-
"sold_count",
|
|
2474
|
-
"sale_amount"
|
|
2475
|
-
],
|
|
2476
|
-
"type": "string"
|
|
2477
|
-
},
|
|
2478
|
-
"order": {
|
|
2479
|
-
"default": "desc",
|
|
2480
|
-
"enum": [
|
|
2481
|
-
"asc",
|
|
2482
|
-
"desc"
|
|
2483
|
-
],
|
|
2484
|
-
"type": "string"
|
|
2485
|
-
}
|
|
2486
|
-
},
|
|
2487
|
-
"type": "object"
|
|
2488
|
-
},
|
|
2489
|
-
"type": "array"
|
|
2490
|
-
},
|
|
2491
|
-
"page": {
|
|
2492
|
-
"default": 1,
|
|
2493
|
-
"description": "Page number. Default 1, max 10.",
|
|
2494
|
-
"maximum": 10,
|
|
2495
|
-
"type": "integer"
|
|
2496
|
-
},
|
|
2497
|
-
"pagesize": {
|
|
2498
|
-
"default": 10,
|
|
2499
|
-
"description": "Page size. Default 10, max 10.",
|
|
2500
|
-
"maximum": 10,
|
|
2501
|
-
"type": "integer"
|
|
2502
|
-
}
|
|
2503
|
-
},
|
|
2504
|
-
"required": [
|
|
2505
|
-
"filter"
|
|
2506
|
-
],
|
|
2507
|
-
"type": "object"
|
|
2508
|
-
},
|
|
2509
|
-
"name": "shop_creator_analysis"
|
|
2510
|
-
},
|
|
2511
|
-
{
|
|
2512
|
-
"annotations": {
|
|
2513
|
-
"title": "Shop data trends",
|
|
2514
|
-
"readOnlyHint": true,
|
|
2515
|
-
"destructiveHint": false,
|
|
2516
|
-
"idempotentHint": false,
|
|
2517
|
-
"openWorldHint": true
|
|
2518
|
-
},
|
|
2519
|
-
"description": "Use when the user wants recent shop GMV, units, creator, live, video, or active-product trends. Returns daily trends.",
|
|
2520
|
-
"inputSchema": {
|
|
2521
|
-
"properties": {
|
|
2522
|
-
"filter": {
|
|
2523
|
-
"description": "Filter parameters.",
|
|
2524
|
-
"properties": {
|
|
2525
|
-
"end_date": {
|
|
2526
|
-
"description": "End date, YYYY-MM-DD.",
|
|
2527
|
-
"type": "string"
|
|
2528
|
-
},
|
|
2529
|
-
"seller_id": {
|
|
2530
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
2531
|
-
"type": "string"
|
|
2532
|
-
},
|
|
2533
|
-
"start_date": {
|
|
2534
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
2535
|
-
"type": "string"
|
|
2536
|
-
},
|
|
2537
|
-
"time_range_days": {
|
|
2538
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2539
|
-
"enum": [
|
|
2540
|
-
7,
|
|
2541
|
-
28,
|
|
2542
|
-
90
|
|
2543
|
-
],
|
|
2544
|
-
"type": "integer"
|
|
2545
|
-
}
|
|
2546
|
-
},
|
|
2547
|
-
"required": [
|
|
2548
|
-
"seller_id"
|
|
2549
|
-
],
|
|
2550
|
-
"type": "object"
|
|
2551
|
-
}
|
|
2552
|
-
},
|
|
2553
|
-
"required": [
|
|
2554
|
-
"filter"
|
|
2555
|
-
],
|
|
2556
|
-
"type": "object"
|
|
2557
|
-
},
|
|
2558
|
-
"name": "shop_data_trends"
|
|
2559
|
-
},
|
|
2560
|
-
{
|
|
2561
|
-
"annotations": {
|
|
2562
|
-
"title": "Shop ad investment analysis",
|
|
2563
|
-
"readOnlyHint": true,
|
|
2564
|
-
"destructiveHint": false,
|
|
2565
|
-
"idempotentHint": false,
|
|
2566
|
-
"openWorldHint": true
|
|
2567
|
-
},
|
|
2568
|
-
"description": "Use when the user asks about shop ads, spend, ROAS, ad GMV, or promoted assets. Returns ad estimates and daily changes.",
|
|
2569
|
-
"inputSchema": {
|
|
2570
|
-
"properties": {
|
|
2571
|
-
"filter": {
|
|
2572
|
-
"description": "Filter parameters.",
|
|
2573
|
-
"properties": {
|
|
2574
|
-
"end_date": {
|
|
2575
|
-
"description": "End date, YYYY-MM-DD.",
|
|
2576
|
-
"type": "string"
|
|
2577
|
-
},
|
|
2578
|
-
"seller_id": {
|
|
2579
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
2580
|
-
"type": "string"
|
|
2581
|
-
},
|
|
2582
|
-
"start_date": {
|
|
2583
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
2584
|
-
"type": "string"
|
|
2585
|
-
},
|
|
2586
|
-
"time_range_days": {
|
|
2587
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2588
|
-
"enum": [
|
|
2589
|
-
7,
|
|
2590
|
-
14,
|
|
2591
|
-
28,
|
|
2592
|
-
60,
|
|
2593
|
-
90,
|
|
2594
|
-
180
|
|
2595
|
-
],
|
|
2596
|
-
"type": "integer"
|
|
2597
|
-
}
|
|
2598
|
-
},
|
|
2599
|
-
"required": [
|
|
2600
|
-
"seller_id"
|
|
2601
|
-
],
|
|
2602
|
-
"type": "object"
|
|
2603
|
-
}
|
|
2604
|
-
},
|
|
2605
|
-
"required": [
|
|
2606
|
-
"filter"
|
|
2607
|
-
],
|
|
2608
|
-
"type": "object"
|
|
2609
|
-
},
|
|
2610
|
-
"name": "shop_investment_analysis"
|
|
2611
|
-
},
|
|
2612
|
-
{
|
|
2613
|
-
"annotations": {
|
|
2614
|
-
"title": "Shop live analysis and live list",
|
|
2615
|
-
"readOnlyHint": true,
|
|
2616
|
-
"destructiveHint": false,
|
|
2617
|
-
"idempotentHint": false,
|
|
2618
|
-
"openWorldHint": true
|
|
2619
|
-
},
|
|
2620
|
-
"description": "Use when the user wants shop live performance, shop-live vs affiliate-live structure, or live sessions.",
|
|
2621
|
-
"inputSchema": {
|
|
2622
|
-
"properties": {
|
|
2623
|
-
"filter": {
|
|
2624
|
-
"description": "Filter parameters.",
|
|
2625
|
-
"properties": {
|
|
2626
|
-
"end_date": {
|
|
2627
|
-
"description": "End date, YYYY-MM-DD.",
|
|
2628
|
-
"type": "string"
|
|
2629
|
-
},
|
|
2630
|
-
"is_shop": {
|
|
2631
|
-
"description": "Live type: 0 all, 1 shop live, 2 affiliate live.",
|
|
2632
|
-
"type": "integer"
|
|
2633
|
-
},
|
|
2634
|
-
"seller_id": {
|
|
2635
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
2636
|
-
"type": "string"
|
|
2637
|
-
},
|
|
2638
|
-
"start_date": {
|
|
2639
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
2640
|
-
"type": "string"
|
|
2641
|
-
},
|
|
2642
|
-
"time_range_days": {
|
|
2643
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2644
|
-
"enum": [
|
|
2645
|
-
7,
|
|
2646
|
-
28,
|
|
2647
|
-
90
|
|
2648
|
-
],
|
|
2649
|
-
"type": "integer"
|
|
2650
|
-
}
|
|
2651
|
-
},
|
|
2652
|
-
"required": [
|
|
2653
|
-
"seller_id"
|
|
2654
|
-
],
|
|
2655
|
-
"type": "object"
|
|
2656
|
-
},
|
|
2657
|
-
"orderby": {
|
|
2658
|
-
"description": "Sort options.",
|
|
2659
|
-
"items": {
|
|
2660
|
-
"properties": {
|
|
2661
|
-
"field": {
|
|
2662
|
-
"enum": [
|
|
2663
|
-
"start_time",
|
|
2664
|
-
"product_count",
|
|
2665
|
-
"total_user_count",
|
|
2666
|
-
"units_sold",
|
|
2667
|
-
"gmv"
|
|
2668
|
-
],
|
|
2669
|
-
"type": "string"
|
|
2670
|
-
},
|
|
2671
|
-
"order": {
|
|
2672
|
-
"default": "desc",
|
|
2673
|
-
"enum": [
|
|
2674
|
-
"asc",
|
|
2675
|
-
"desc"
|
|
2676
|
-
],
|
|
2677
|
-
"type": "string"
|
|
2678
|
-
}
|
|
2679
|
-
},
|
|
2680
|
-
"type": "object"
|
|
2681
|
-
},
|
|
2682
|
-
"type": "array"
|
|
2683
|
-
},
|
|
2684
|
-
"page": {
|
|
2685
|
-
"default": 1,
|
|
2686
|
-
"description": "Page number. Default 1, max 10.",
|
|
2687
|
-
"maximum": 10,
|
|
2688
|
-
"type": "integer"
|
|
2689
|
-
},
|
|
2690
|
-
"pagesize": {
|
|
2691
|
-
"default": 10,
|
|
2692
|
-
"description": "Page size. Default 10, max 10.",
|
|
2693
|
-
"maximum": 10,
|
|
2694
|
-
"type": "integer"
|
|
2695
|
-
}
|
|
2696
|
-
},
|
|
2697
|
-
"required": [
|
|
2698
|
-
"filter"
|
|
2699
|
-
],
|
|
2700
|
-
"type": "object"
|
|
2701
|
-
},
|
|
2702
|
-
"name": "shop_live_analysis"
|
|
2703
|
-
},
|
|
2704
|
-
{
|
|
2705
|
-
"annotations": {
|
|
2706
|
-
"title": "Shop product analysis and product list",
|
|
2707
|
-
"readOnlyHint": true,
|
|
2708
|
-
"destructiveHint": false,
|
|
2709
|
-
"idempotentHint": false,
|
|
2710
|
-
"openWorldHint": true
|
|
2711
|
-
},
|
|
2712
|
-
"description": "Use when the user wants shop categories, price bands, product mix, or product details. Returns distributions and product list.",
|
|
2713
|
-
"inputSchema": {
|
|
2714
|
-
"properties": {
|
|
2715
|
-
"filter": {
|
|
2716
|
-
"description": "Filter parameters.",
|
|
2717
|
-
"properties": {
|
|
2718
|
-
"category_id": {
|
|
2719
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
2720
|
-
"type": "integer"
|
|
2721
|
-
},
|
|
2722
|
-
"end_date": {
|
|
2723
|
-
"description": "End date, YYYY-MM-DD.",
|
|
2724
|
-
"type": "string"
|
|
2725
|
-
},
|
|
2726
|
-
"listing_time_range_days": {
|
|
2727
|
-
"description": "Listing age in days, commonly 7/14/28/90.",
|
|
2728
|
-
"enum": [
|
|
2729
|
-
7,
|
|
2730
|
-
14,
|
|
2731
|
-
28,
|
|
2732
|
-
90
|
|
2733
|
-
],
|
|
2734
|
-
"type": "integer"
|
|
2735
|
-
},
|
|
2736
|
-
"seller_id": {
|
|
2737
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
2738
|
-
"type": "string"
|
|
2739
|
-
},
|
|
2740
|
-
"start_date": {
|
|
2741
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
2742
|
-
"type": "string"
|
|
2743
|
-
},
|
|
2744
|
-
"time_range_days": {
|
|
2745
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2746
|
-
"enum": [
|
|
2747
|
-
7,
|
|
2748
|
-
28,
|
|
2749
|
-
90
|
|
2750
|
-
],
|
|
2751
|
-
"type": "integer"
|
|
2752
|
-
}
|
|
2753
|
-
},
|
|
2754
|
-
"required": [
|
|
2755
|
-
"seller_id"
|
|
2756
|
-
],
|
|
2757
|
-
"type": "object"
|
|
2758
|
-
},
|
|
2759
|
-
"orderby": {
|
|
2760
|
-
"description": "Sort options.",
|
|
2761
|
-
"items": {
|
|
2762
|
-
"properties": {
|
|
2763
|
-
"field": {
|
|
2764
|
-
"enum": [
|
|
2765
|
-
"launch_time",
|
|
2766
|
-
"commission_rate_percent",
|
|
2767
|
-
"day7_units_sold",
|
|
2768
|
-
"day28_units_sold",
|
|
2769
|
-
"day90_units_sold",
|
|
2770
|
-
"day7_gmv",
|
|
2771
|
-
"day28_gmv",
|
|
2772
|
-
"day90_gmv",
|
|
2773
|
-
"total_units_sold",
|
|
2774
|
-
"total_gmv"
|
|
2775
|
-
],
|
|
2776
|
-
"type": "string"
|
|
2777
|
-
},
|
|
2778
|
-
"order": {
|
|
2779
|
-
"default": "desc",
|
|
2780
|
-
"enum": [
|
|
2781
|
-
"asc",
|
|
2782
|
-
"desc"
|
|
2783
|
-
],
|
|
2784
|
-
"type": "string"
|
|
2785
|
-
}
|
|
2786
|
-
},
|
|
2787
|
-
"type": "object"
|
|
2788
|
-
},
|
|
2789
|
-
"type": "array"
|
|
2790
|
-
},
|
|
2791
|
-
"page": {
|
|
2792
|
-
"default": 1,
|
|
2793
|
-
"description": "Page number. Default 1, max 10.",
|
|
2794
|
-
"maximum": 10,
|
|
2795
|
-
"type": "integer"
|
|
2796
|
-
},
|
|
2797
|
-
"pagesize": {
|
|
2798
|
-
"default": 10,
|
|
2799
|
-
"description": "Page size. Default 10, max 10.",
|
|
2800
|
-
"maximum": 10,
|
|
2801
|
-
"type": "integer"
|
|
2802
|
-
}
|
|
2803
|
-
},
|
|
2804
|
-
"required": [
|
|
2805
|
-
"filter"
|
|
2806
|
-
],
|
|
2807
|
-
"type": "object"
|
|
2808
|
-
},
|
|
2809
|
-
"name": "shop_product_analysis"
|
|
2810
|
-
},
|
|
2811
|
-
{
|
|
2812
|
-
"annotations": {
|
|
2813
|
-
"title": "Top selling shops",
|
|
2814
|
-
"readOnlyHint": true,
|
|
2815
|
-
"destructiveHint": false,
|
|
2816
|
-
"idempotentHint": false,
|
|
2817
|
-
"openWorldHint": true
|
|
2818
|
-
},
|
|
2819
|
-
"description": "Use when the user wants top shops in a market or category. Returns shop ranking and ecommerce metrics.",
|
|
2820
|
-
"inputSchema": {
|
|
2821
|
-
"properties": {
|
|
2822
|
-
"filter": {
|
|
2823
|
-
"description": "Filter parameters.",
|
|
2824
|
-
"properties": {
|
|
2825
|
-
"category_id": {
|
|
2826
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
2827
|
-
"type": "integer"
|
|
2828
|
-
},
|
|
2829
|
-
"date_type": {
|
|
2830
|
-
"description": "Ranking period: day, week, or month.",
|
|
2831
|
-
"enum": [
|
|
2832
|
-
"day",
|
|
2833
|
-
"week",
|
|
2834
|
-
"month"
|
|
2835
|
-
],
|
|
2836
|
-
"type": "string"
|
|
2837
|
-
},
|
|
2838
|
-
"date_value": {
|
|
2839
|
-
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww, last month YYYY-MM; do not use the current period.",
|
|
2840
|
-
"type": "string"
|
|
2841
|
-
},
|
|
2842
|
-
"is_cross_border": {
|
|
2843
|
-
"description": "Whether it is cross-border.",
|
|
2844
|
-
"type": "boolean"
|
|
2845
|
-
},
|
|
2846
|
-
"region": {
|
|
2847
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
2848
|
-
"type": "string"
|
|
2849
|
-
},
|
|
2850
|
-
"shop_type": {
|
|
2851
|
-
"description": "Shop type: 1 brand shop, 2 retail shop.",
|
|
2852
|
-
"type": "integer"
|
|
2853
|
-
}
|
|
2854
|
-
},
|
|
2855
|
-
"required": [
|
|
2856
|
-
"date_type",
|
|
2857
|
-
"date_value"
|
|
2858
|
-
],
|
|
2859
|
-
"type": "object"
|
|
2860
|
-
},
|
|
2861
|
-
"orderby": {
|
|
2862
|
-
"description": "Sort options.",
|
|
2863
|
-
"items": {
|
|
2864
|
-
"properties": {
|
|
2865
|
-
"field": {
|
|
2866
|
-
"enum": [
|
|
2867
|
-
"units_sold",
|
|
2868
|
-
"usd_gmv"
|
|
2869
|
-
],
|
|
2870
|
-
"type": "string"
|
|
2871
|
-
},
|
|
2872
|
-
"order": {
|
|
2873
|
-
"default": "desc",
|
|
2874
|
-
"enum": [
|
|
2875
|
-
"asc",
|
|
2876
|
-
"desc"
|
|
2877
|
-
],
|
|
2878
|
-
"type": "string"
|
|
2879
|
-
}
|
|
2880
|
-
},
|
|
2881
|
-
"type": "object"
|
|
2882
|
-
},
|
|
2883
|
-
"type": "array"
|
|
2884
|
-
},
|
|
2885
|
-
"page": {
|
|
2886
|
-
"default": 1,
|
|
2887
|
-
"description": "Page number. Default 1, max 10.",
|
|
2888
|
-
"maximum": 10,
|
|
2889
|
-
"type": "integer"
|
|
2890
|
-
},
|
|
2891
|
-
"pagesize": {
|
|
2892
|
-
"default": 10,
|
|
2893
|
-
"description": "Page size. Default 10, max 10.",
|
|
2894
|
-
"maximum": 10,
|
|
2895
|
-
"type": "integer"
|
|
2896
|
-
}
|
|
2897
|
-
},
|
|
2898
|
-
"type": "object"
|
|
2899
|
-
},
|
|
2900
|
-
"name": "shop_rank_top_selling"
|
|
2901
|
-
},
|
|
2902
|
-
{
|
|
2903
|
-
"annotations": {
|
|
2904
|
-
"title": "Shop sales analysis",
|
|
2905
|
-
"readOnlyHint": true,
|
|
2906
|
-
"destructiveHint": false,
|
|
2907
|
-
"idempotentHint": false,
|
|
2908
|
-
"openWorldHint": true
|
|
2909
|
-
},
|
|
2910
|
-
"description": "Use when the user wants shop sales by short video, live, product card, creator, or self-operated channels. Returns channel_distribution and content_distribution.",
|
|
2911
|
-
"inputSchema": {
|
|
2912
|
-
"properties": {
|
|
2913
|
-
"filter": {
|
|
2914
|
-
"description": "Filter parameters.",
|
|
2915
|
-
"properties": {
|
|
2916
|
-
"end_date": {
|
|
2917
|
-
"description": "End date, YYYY-MM-DD.",
|
|
2918
|
-
"type": "string"
|
|
2919
|
-
},
|
|
2920
|
-
"seller_id": {
|
|
2921
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
2922
|
-
"type": "string"
|
|
2923
|
-
},
|
|
2924
|
-
"start_date": {
|
|
2925
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
2926
|
-
"type": "string"
|
|
2927
|
-
},
|
|
2928
|
-
"time_range_days": {
|
|
2929
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
2930
|
-
"enum": [
|
|
2931
|
-
7,
|
|
2932
|
-
28,
|
|
2933
|
-
90
|
|
2934
|
-
],
|
|
2935
|
-
"type": "integer"
|
|
2936
|
-
}
|
|
2937
|
-
},
|
|
2938
|
-
"required": [
|
|
2939
|
-
"seller_id"
|
|
2940
|
-
],
|
|
2941
|
-
"type": "object"
|
|
2942
|
-
}
|
|
2943
|
-
},
|
|
2944
|
-
"required": [
|
|
2945
|
-
"filter"
|
|
2946
|
-
],
|
|
2947
|
-
"type": "object"
|
|
2948
|
-
},
|
|
2949
|
-
"name": "shop_sale_analysis"
|
|
2950
|
-
},
|
|
2951
|
-
{
|
|
2952
|
-
"annotations": {
|
|
2953
|
-
"title": "Shop search",
|
|
2954
|
-
"readOnlyHint": true,
|
|
2955
|
-
"destructiveHint": false,
|
|
2956
|
-
"idempotentHint": false,
|
|
2957
|
-
"openWorldHint": true
|
|
2958
|
-
},
|
|
2959
|
-
"description": "Use when the user has no seller_id and provides a shop name, keyword, or region. Returns matching shops.",
|
|
2960
|
-
"inputSchema": {
|
|
2961
|
-
"properties": {
|
|
2962
|
-
"filter": {
|
|
2963
|
-
"description": "Filter parameters.",
|
|
2964
|
-
"properties": {
|
|
2965
|
-
"brand_name": {
|
|
2966
|
-
"description": "Brand name parameter.",
|
|
2967
|
-
"type": "string"
|
|
2968
|
-
},
|
|
2969
|
-
"category_id": {
|
|
2970
|
-
"description": "Category ID; confirm category first if only a category name is known.",
|
|
2971
|
-
"type": "integer"
|
|
2972
|
-
},
|
|
2973
|
-
"creator_range": {
|
|
2974
|
-
"description": "Creator count range: {\"min\": number, \"max\": number}.",
|
|
2975
|
-
"properties": {
|
|
2976
|
-
"max": {
|
|
2977
|
-
"description": "Maximum value.",
|
|
2978
|
-
"type": "number"
|
|
2979
|
-
},
|
|
2980
|
-
"min": {
|
|
2981
|
-
"description": "Minimum value.",
|
|
2982
|
-
"type": "number"
|
|
2983
|
-
}
|
|
2984
|
-
},
|
|
2985
|
-
"type": "object"
|
|
2986
|
-
},
|
|
2987
|
-
"creator_uid": {
|
|
2988
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
2989
|
-
"type": "string"
|
|
2990
|
-
},
|
|
2991
|
-
"creator_unique_id": {
|
|
2992
|
-
"description": "Creator unique id.",
|
|
2993
|
-
"type": "string"
|
|
2994
|
-
},
|
|
2995
|
-
"is_fully_managed": {
|
|
2996
|
-
"description": "Whether it is fully managed.",
|
|
2997
|
-
"type": "boolean"
|
|
2998
|
-
},
|
|
2999
|
-
"is_local": {
|
|
3000
|
-
"description": "Is local parameter.",
|
|
3001
|
-
"type": "boolean"
|
|
3002
|
-
},
|
|
3003
|
-
"rating_range": {
|
|
3004
|
-
"description": "Rating range range in the form {\"min\": number, \"max\": number}.",
|
|
3005
|
-
"properties": {
|
|
3006
|
-
"max": {
|
|
3007
|
-
"description": "Maximum value.",
|
|
3008
|
-
"type": "number"
|
|
3009
|
-
},
|
|
3010
|
-
"min": {
|
|
3011
|
-
"description": "Minimum value.",
|
|
3012
|
-
"type": "number"
|
|
3013
|
-
}
|
|
3014
|
-
},
|
|
3015
|
-
"type": "object"
|
|
3016
|
-
},
|
|
3017
|
-
"region": {
|
|
3018
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
3019
|
-
"type": "string"
|
|
3020
|
-
},
|
|
3021
|
-
"seller_id": {
|
|
3022
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
3023
|
-
"type": "string"
|
|
3024
|
-
},
|
|
3025
|
-
"shop_name": {
|
|
3026
|
-
"description": "Shop name parameter.",
|
|
3027
|
-
"type": "string"
|
|
3028
|
-
}
|
|
3029
|
-
},
|
|
3030
|
-
"type": "object"
|
|
3031
|
-
},
|
|
3032
|
-
"keywords": {
|
|
3033
|
-
"description": "Search keywords: product, shop, creator, video, live, or category terms.",
|
|
3034
|
-
"type": "string"
|
|
3035
|
-
},
|
|
3036
|
-
"orderby": {
|
|
3037
|
-
"description": "Sort options.",
|
|
3038
|
-
"items": {
|
|
3039
|
-
"properties": {
|
|
3040
|
-
"field": {
|
|
3041
|
-
"enum": [
|
|
3042
|
-
"day7_units_sold",
|
|
3043
|
-
"day7_gmv",
|
|
3044
|
-
"total_units_sold",
|
|
3045
|
-
"total_gmv"
|
|
3046
|
-
],
|
|
3047
|
-
"type": "string"
|
|
3048
|
-
},
|
|
3049
|
-
"order": {
|
|
3050
|
-
"default": "desc",
|
|
3051
|
-
"enum": [
|
|
3052
|
-
"asc",
|
|
3053
|
-
"desc"
|
|
3054
|
-
],
|
|
3055
|
-
"type": "string"
|
|
3056
|
-
}
|
|
3057
|
-
},
|
|
3058
|
-
"type": "object"
|
|
3059
|
-
},
|
|
3060
|
-
"type": "array"
|
|
3061
|
-
},
|
|
3062
|
-
"page": {
|
|
3063
|
-
"default": 1,
|
|
3064
|
-
"description": "Page number. Default 1, max 10.",
|
|
3065
|
-
"maximum": 10,
|
|
3066
|
-
"type": "integer"
|
|
3067
|
-
},
|
|
3068
|
-
"pagesize": {
|
|
3069
|
-
"default": 10,
|
|
3070
|
-
"description": "Page size. Default 10, max 10.",
|
|
3071
|
-
"maximum": 10,
|
|
3072
|
-
"type": "integer"
|
|
3073
|
-
}
|
|
3074
|
-
},
|
|
3075
|
-
"type": "object"
|
|
3076
|
-
},
|
|
3077
|
-
"name": "shop_search"
|
|
3078
|
-
},
|
|
3079
|
-
{
|
|
3080
|
-
"annotations": {
|
|
3081
|
-
"title": "Shop video analysis and video list",
|
|
3082
|
-
"readOnlyHint": true,
|
|
3083
|
-
"destructiveHint": false,
|
|
3084
|
-
"idempotentHint": false,
|
|
3085
|
-
"openWorldHint": true
|
|
3086
|
-
},
|
|
3087
|
-
"description": "Use when the user wants shop selling videos, video performance, or ad status.",
|
|
3088
|
-
"inputSchema": {
|
|
3089
|
-
"properties": {
|
|
3090
|
-
"filter": {
|
|
3091
|
-
"description": "Filter parameters.",
|
|
3092
|
-
"properties": {
|
|
3093
|
-
"end_date": {
|
|
3094
|
-
"description": "End date, YYYY-MM-DD.",
|
|
3095
|
-
"type": "string"
|
|
3096
|
-
},
|
|
3097
|
-
"is_ad": {
|
|
3098
|
-
"description": "Whether it uses ad traffic.",
|
|
3099
|
-
"type": "boolean"
|
|
3100
|
-
},
|
|
3101
|
-
"publish_time_range_days": {
|
|
3102
|
-
"description": "Video publish age in days, commonly 7/28/90.",
|
|
3103
|
-
"enum": [
|
|
3104
|
-
7,
|
|
3105
|
-
28,
|
|
3106
|
-
90
|
|
3107
|
-
],
|
|
3108
|
-
"type": "integer"
|
|
3109
|
-
},
|
|
3110
|
-
"seller_id": {
|
|
3111
|
-
"description": "Shop seller_id; use shop_search first if only a shop name is known.",
|
|
3112
|
-
"type": "string"
|
|
3113
|
-
},
|
|
3114
|
-
"start_date": {
|
|
3115
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
3116
|
-
"type": "string"
|
|
3117
|
-
},
|
|
3118
|
-
"time_range_days": {
|
|
3119
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
3120
|
-
"enum": [
|
|
3121
|
-
7,
|
|
3122
|
-
28,
|
|
3123
|
-
90
|
|
3124
|
-
],
|
|
3125
|
-
"type": "integer"
|
|
3126
|
-
}
|
|
3127
|
-
},
|
|
3128
|
-
"required": [
|
|
3129
|
-
"seller_id"
|
|
3130
|
-
],
|
|
3131
|
-
"type": "object"
|
|
3132
|
-
},
|
|
3133
|
-
"orderby": {
|
|
3134
|
-
"description": "Sort options.",
|
|
3135
|
-
"items": {
|
|
3136
|
-
"properties": {
|
|
3137
|
-
"field": {
|
|
3138
|
-
"enum": [
|
|
3139
|
-
"video_create_time",
|
|
3140
|
-
"units_sold",
|
|
3141
|
-
"gmv",
|
|
3142
|
-
"digg_count",
|
|
3143
|
-
"play_count"
|
|
3144
|
-
],
|
|
3145
|
-
"type": "string"
|
|
3146
|
-
},
|
|
3147
|
-
"order": {
|
|
3148
|
-
"default": "desc",
|
|
3149
|
-
"enum": [
|
|
3150
|
-
"asc",
|
|
3151
|
-
"desc"
|
|
3152
|
-
],
|
|
3153
|
-
"type": "string"
|
|
3154
|
-
}
|
|
3155
|
-
},
|
|
3156
|
-
"type": "object"
|
|
3157
|
-
},
|
|
3158
|
-
"type": "array"
|
|
3159
|
-
},
|
|
3160
|
-
"page": {
|
|
3161
|
-
"default": 1,
|
|
3162
|
-
"description": "Page number. Default 1, max 10.",
|
|
3163
|
-
"maximum": 10,
|
|
3164
|
-
"type": "integer"
|
|
3165
|
-
},
|
|
3166
|
-
"pagesize": {
|
|
3167
|
-
"default": 10,
|
|
3168
|
-
"description": "Page size. Default 10, max 10.",
|
|
3169
|
-
"maximum": 10,
|
|
3170
|
-
"type": "integer"
|
|
3171
|
-
}
|
|
3172
|
-
},
|
|
3173
|
-
"required": [
|
|
3174
|
-
"filter"
|
|
3175
|
-
],
|
|
3176
|
-
"type": "object"
|
|
3177
|
-
},
|
|
3178
|
-
"name": "shop_video_analysis"
|
|
3179
|
-
},
|
|
3180
|
-
{
|
|
3181
|
-
"annotations": {
|
|
3182
|
-
"title": "Video data trends",
|
|
3183
|
-
"readOnlyHint": true,
|
|
3184
|
-
"destructiveHint": false,
|
|
3185
|
-
"idempotentHint": false,
|
|
3186
|
-
"openWorldHint": true
|
|
3187
|
-
},
|
|
3188
|
-
"description": "Use when the user wants one video play, like, comment, or share trends. Returns daily interaction trends.",
|
|
3189
|
-
"inputSchema": {
|
|
3190
|
-
"properties": {
|
|
3191
|
-
"filter": {
|
|
3192
|
-
"description": "Filter parameters.",
|
|
3193
|
-
"properties": {
|
|
3194
|
-
"end_date": {
|
|
3195
|
-
"description": "End date, YYYY-MM-DD.",
|
|
3196
|
-
"type": "string"
|
|
3197
|
-
},
|
|
3198
|
-
"start_date": {
|
|
3199
|
-
"description": "Start date, YYYY-MM-DD.",
|
|
3200
|
-
"type": "string"
|
|
3201
|
-
},
|
|
3202
|
-
"time_range_days": {
|
|
3203
|
-
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
3204
|
-
"type": "integer"
|
|
3205
|
-
},
|
|
3206
|
-
"video_id": {
|
|
3207
|
-
"description": "Video ID; use video_search first if only a title/creator is known.",
|
|
3208
|
-
"type": "string"
|
|
3209
|
-
}
|
|
3210
|
-
},
|
|
3211
|
-
"required": [
|
|
3212
|
-
"video_id"
|
|
3213
|
-
],
|
|
3214
|
-
"type": "object"
|
|
3215
|
-
}
|
|
3216
|
-
},
|
|
3217
|
-
"required": [
|
|
3218
|
-
"filter"
|
|
3219
|
-
],
|
|
3220
|
-
"type": "object"
|
|
3221
|
-
},
|
|
3222
|
-
"name": "video_data_trends"
|
|
3223
|
-
},
|
|
3224
|
-
{
|
|
3225
|
-
"annotations": {
|
|
3226
|
-
"title": "Video detail analysis and product list",
|
|
3227
|
-
"readOnlyHint": true,
|
|
3228
|
-
"destructiveHint": false,
|
|
3229
|
-
"idempotentHint": false,
|
|
3230
|
-
"openWorldHint": true
|
|
3231
|
-
},
|
|
3232
|
-
"description": "Use when the user wants one video basics, plays, engagement, interaction rate, IPM, and linked products.",
|
|
3233
|
-
"inputSchema": {
|
|
3234
|
-
"properties": {
|
|
3235
|
-
"filter": {
|
|
3236
|
-
"description": "Filter parameters.",
|
|
3237
|
-
"properties": {
|
|
3238
|
-
"video_id": {
|
|
3239
|
-
"description": "Video ID; use video_search first if only a title/creator is known.",
|
|
3240
|
-
"type": "string"
|
|
3241
|
-
}
|
|
3242
|
-
},
|
|
3243
|
-
"required": [
|
|
3244
|
-
"video_id"
|
|
3245
|
-
],
|
|
3246
|
-
"type": "object"
|
|
3247
|
-
},
|
|
3248
|
-
"lang": {
|
|
3249
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
3250
|
-
"type": "string"
|
|
3251
|
-
},
|
|
3252
|
-
"orderby": {
|
|
3253
|
-
"description": "Sort options.",
|
|
3254
|
-
"items": {
|
|
3255
|
-
"properties": {
|
|
3256
|
-
"field": {
|
|
3257
|
-
"enum": [
|
|
3258
|
-
"units_sold",
|
|
3259
|
-
"gmv",
|
|
3260
|
-
"launch_time",
|
|
3261
|
-
"commission_rate"
|
|
3262
|
-
],
|
|
3263
|
-
"type": "string"
|
|
3264
|
-
},
|
|
3265
|
-
"order": {
|
|
3266
|
-
"default": "desc",
|
|
3267
|
-
"enum": [
|
|
3268
|
-
"asc",
|
|
3269
|
-
"desc"
|
|
3270
|
-
],
|
|
3271
|
-
"type": "string"
|
|
3272
|
-
}
|
|
3273
|
-
},
|
|
3274
|
-
"type": "object"
|
|
3275
|
-
},
|
|
3276
|
-
"type": "array"
|
|
3277
|
-
},
|
|
3278
|
-
"page": {
|
|
3279
|
-
"default": 1,
|
|
3280
|
-
"description": "Page number. Default 1, max 10.",
|
|
3281
|
-
"maximum": 10,
|
|
3282
|
-
"type": "integer"
|
|
3283
|
-
},
|
|
3284
|
-
"pagesize": {
|
|
3285
|
-
"default": 10,
|
|
3286
|
-
"description": "Page size. Default 10, max 10.",
|
|
3287
|
-
"maximum": 10,
|
|
3288
|
-
"type": "integer"
|
|
3289
|
-
}
|
|
3290
|
-
},
|
|
3291
|
-
"required": [
|
|
3292
|
-
"filter"
|
|
3293
|
-
],
|
|
3294
|
-
"type": "object"
|
|
3295
|
-
},
|
|
3296
|
-
"name": "video_detail_analysis"
|
|
3297
|
-
},
|
|
3298
|
-
{
|
|
3299
|
-
"annotations": {
|
|
3300
|
-
"title": "Video subtitle script",
|
|
3301
|
-
"readOnlyHint": true,
|
|
3302
|
-
"destructiveHint": false,
|
|
3303
|
-
"idempotentHint": false,
|
|
3304
|
-
"openWorldHint": true
|
|
3305
|
-
},
|
|
3306
|
-
"description": "Use when the user wants video subtitles or line-by-line spoken copy. Returns start/end time and text; empty subtitles can fall back to video_desc.",
|
|
3307
|
-
"inputSchema": {
|
|
3308
|
-
"properties": {
|
|
3309
|
-
"video_id": {
|
|
3310
|
-
"description": "Video ID; use video_search first if only a title/creator is known.",
|
|
3311
|
-
"type": "string"
|
|
3312
|
-
}
|
|
3313
|
-
},
|
|
3314
|
-
"required": [
|
|
3315
|
-
"video_id"
|
|
3316
|
-
],
|
|
3317
|
-
"type": "object"
|
|
3318
|
-
},
|
|
3319
|
-
"name": "video_script_info"
|
|
3320
|
-
},
|
|
3321
|
-
{
|
|
3322
|
-
"annotations": {
|
|
3323
|
-
"title": "Video search",
|
|
3324
|
-
"readOnlyHint": true,
|
|
3325
|
-
"destructiveHint": false,
|
|
3326
|
-
"idempotentHint": false,
|
|
3327
|
-
"openWorldHint": true
|
|
3328
|
-
},
|
|
3329
|
-
"description": "Use when the user has no video_id and provides video keywords, title, or creator. Returns matching videos.",
|
|
3330
|
-
"inputSchema": {
|
|
3331
|
-
"properties": {
|
|
3332
|
-
"filter": {
|
|
3333
|
-
"description": "Filter parameters.",
|
|
3334
|
-
"properties": {
|
|
3335
|
-
"create_time_range": {
|
|
3336
|
-
"description": "Creation/publish time range: {\"min\": unix_timestamp, \"max\": unix_timestamp}.",
|
|
3337
|
-
"properties": {
|
|
3338
|
-
"max": {
|
|
3339
|
-
"description": "Maximum value.",
|
|
3340
|
-
"type": "number"
|
|
3341
|
-
},
|
|
3342
|
-
"min": {
|
|
3343
|
-
"description": "Minimum value.",
|
|
3344
|
-
"type": "number"
|
|
3345
|
-
}
|
|
3346
|
-
},
|
|
3347
|
-
"type": "object"
|
|
3348
|
-
},
|
|
3349
|
-
"creator_category_id": {
|
|
3350
|
-
"description": "Creator category ID.",
|
|
3351
|
-
"type": "integer"
|
|
3352
|
-
},
|
|
3353
|
-
"creator_uid": {
|
|
3354
|
-
"description": "Creator UID; use creator_search first if only a handle/nickname is known.",
|
|
3355
|
-
"type": "integer"
|
|
3356
|
-
},
|
|
3357
|
-
"creator_unique_id": {
|
|
3358
|
-
"description": "Creator unique id.",
|
|
3359
|
-
"type": "string"
|
|
3360
|
-
},
|
|
3361
|
-
"digg_count_range": {
|
|
3362
|
-
"description": "Digg count range range in the form {\"min\": number, \"max\": number}.",
|
|
3363
|
-
"properties": {
|
|
3364
|
-
"max": {
|
|
3365
|
-
"description": "Maximum value.",
|
|
3366
|
-
"type": "number"
|
|
3367
|
-
},
|
|
3368
|
-
"min": {
|
|
3369
|
-
"description": "Minimum value.",
|
|
3370
|
-
"type": "number"
|
|
3371
|
-
}
|
|
3372
|
-
},
|
|
3373
|
-
"type": "object"
|
|
3374
|
-
},
|
|
3375
|
-
"follower_count_range": {
|
|
3376
|
-
"description": "Follower count range: {\"min\": number, \"max\": number}.",
|
|
3377
|
-
"properties": {
|
|
3378
|
-
"max": {
|
|
3379
|
-
"description": "Maximum value.",
|
|
3380
|
-
"type": "number"
|
|
3381
|
-
},
|
|
3382
|
-
"min": {
|
|
3383
|
-
"description": "Minimum value.",
|
|
3384
|
-
"type": "number"
|
|
3385
|
-
}
|
|
3386
|
-
},
|
|
3387
|
-
"type": "object"
|
|
3388
|
-
},
|
|
3389
|
-
"interact_rate_range": {
|
|
3390
|
-
"description": "Interact rate range range in the form {\"min\": number, \"max\": number}.",
|
|
3391
|
-
"properties": {
|
|
3392
|
-
"max": {
|
|
3393
|
-
"description": "Maximum value.",
|
|
3394
|
-
"type": "number"
|
|
3395
|
-
},
|
|
3396
|
-
"min": {
|
|
3397
|
-
"description": "Minimum value.",
|
|
3398
|
-
"type": "number"
|
|
3399
|
-
}
|
|
3400
|
-
},
|
|
3401
|
-
"type": "object"
|
|
3402
|
-
},
|
|
3403
|
-
"is_ecommerce": {
|
|
3404
|
-
"description": "Is ecommerce parameter.",
|
|
3405
|
-
"type": "boolean"
|
|
3406
|
-
},
|
|
3407
|
-
"play_count_range": {
|
|
3408
|
-
"description": "Play count range range in the form {\"min\": number, \"max\": number}.",
|
|
3409
|
-
"properties": {
|
|
3410
|
-
"max": {
|
|
3411
|
-
"description": "Maximum value.",
|
|
3412
|
-
"type": "number"
|
|
3413
|
-
},
|
|
3414
|
-
"min": {
|
|
3415
|
-
"description": "Minimum value.",
|
|
3416
|
-
"type": "number"
|
|
3417
|
-
}
|
|
3418
|
-
},
|
|
3419
|
-
"type": "object"
|
|
3420
|
-
},
|
|
3421
|
-
"product_category_id": {
|
|
3422
|
-
"description": "Product category ID.",
|
|
3423
|
-
"type": "integer"
|
|
3424
|
-
},
|
|
3425
|
-
"region": {
|
|
3426
|
-
"description": "Country or region code, e.g. US, UK, ID.",
|
|
3427
|
-
"type": "string"
|
|
3428
|
-
}
|
|
3429
|
-
},
|
|
3430
|
-
"required": [
|
|
3431
|
-
"create_time_range"
|
|
3432
|
-
],
|
|
3433
|
-
"type": "object"
|
|
3434
|
-
},
|
|
3435
|
-
"keywords": {
|
|
3436
|
-
"description": "Search keywords: product, shop, creator, video, live, or category terms.",
|
|
3437
|
-
"type": "string"
|
|
3438
|
-
},
|
|
3439
|
-
"lang": {
|
|
3440
|
-
"description": "Language. Default EN_US, optional ZH_CN.",
|
|
3441
|
-
"type": "string"
|
|
3442
|
-
},
|
|
3443
|
-
"orderby": {
|
|
3444
|
-
"description": "Sort options.",
|
|
3445
|
-
"items": {
|
|
3446
|
-
"properties": {
|
|
3447
|
-
"field": {
|
|
3448
|
-
"enum": [
|
|
3449
|
-
"follower_count",
|
|
3450
|
-
"create_time",
|
|
3451
|
-
"play_count",
|
|
3452
|
-
"digg_count",
|
|
3453
|
-
"units_sold",
|
|
3454
|
-
"interact_rate"
|
|
3455
|
-
],
|
|
3456
|
-
"type": "string"
|
|
3457
|
-
},
|
|
3458
|
-
"order": {
|
|
3459
|
-
"default": "desc",
|
|
3460
|
-
"enum": [
|
|
3461
|
-
"asc",
|
|
3462
|
-
"desc"
|
|
3463
|
-
],
|
|
3464
|
-
"type": "string"
|
|
3465
|
-
}
|
|
3466
|
-
},
|
|
3467
|
-
"type": "object"
|
|
3468
|
-
},
|
|
3469
|
-
"type": "array"
|
|
3470
|
-
},
|
|
3471
|
-
"page": {
|
|
3472
|
-
"default": 1,
|
|
3473
|
-
"description": "Page number. Default 1, max 10.",
|
|
3474
|
-
"maximum": 10,
|
|
3475
|
-
"type": "integer"
|
|
3476
|
-
},
|
|
3477
|
-
"pagesize": {
|
|
3478
|
-
"default": 10,
|
|
3479
|
-
"description": "Page size. Default 10, max 10.",
|
|
3480
|
-
"maximum": 10,
|
|
3481
|
-
"type": "integer"
|
|
3482
|
-
}
|
|
3483
|
-
},
|
|
3484
|
-
"type": "object"
|
|
3485
|
-
},
|
|
3486
|
-
"name": "video_search"
|
|
3487
|
-
}
|
|
3488
|
-
]
|
|
3489
|
-
}
|
|
3490
|
-
}
|