@fastmoss/cli 0.1.5 → 0.1.6
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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: fastmoss
|
|
3
|
-
description: Use when working with FastMoss CLI, FastMoss MCP tools, TikTok Shop product, creator, shop, video, ad, category, or market data, or when the user asks an agent to call FastMoss tools from the command line.
|
|
2
|
+
name: fastmoss
|
|
3
|
+
description: Use when working with FastMoss CLI, FastMoss MCP tools, TikTok Shop product, creator, shop, MCN agency, video, ad, category, or market data, or when the user asks an agent to call FastMoss tools from the command line.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# FastMoss CLI
|
|
@@ -18,7 +18,7 @@ Use the `fastmoss` command to discover and call FastMoss tools.
|
|
|
18
18
|
If the FastMoss CLI is not installed or the command is not found, install it first:
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
npm install -g @fastmoss/cli
|
|
21
|
+
npm install -g --allow-scripts=@fastmoss/cli @fastmoss/cli
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
To update an existing FastMoss CLI installation to the latest package version, run:
|
|
@@ -229,6 +229,530 @@
|
|
|
229
229
|
},
|
|
230
230
|
"name": "ad_search"
|
|
231
231
|
},
|
|
232
|
+
{
|
|
233
|
+
"annotations": {
|
|
234
|
+
"title": "MCN agency creator analysis",
|
|
235
|
+
"readOnlyHint": true,
|
|
236
|
+
"destructiveHint": false,
|
|
237
|
+
"idempotentHint": false,
|
|
238
|
+
"openWorldHint": true
|
|
239
|
+
},
|
|
240
|
+
"description": "Use when the user wants agency creator structure, follower tiers, and individual collaborators. Returns distributions and a paginated creator list.",
|
|
241
|
+
"inputSchema": {
|
|
242
|
+
"properties": {
|
|
243
|
+
"filter": {
|
|
244
|
+
"description": "Filter parameters.",
|
|
245
|
+
"properties": {
|
|
246
|
+
"agency_id": {
|
|
247
|
+
"description": "Unique MCN agency ID; use agency_search first when only the agency name is known.",
|
|
248
|
+
"type": "string"
|
|
249
|
+
},
|
|
250
|
+
"time_range_days": {
|
|
251
|
+
"default": 28,
|
|
252
|
+
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
253
|
+
"enum": [
|
|
254
|
+
7,
|
|
255
|
+
28,
|
|
256
|
+
90
|
|
257
|
+
],
|
|
258
|
+
"type": "integer"
|
|
259
|
+
}
|
|
260
|
+
},
|
|
261
|
+
"required": [
|
|
262
|
+
"agency_id"
|
|
263
|
+
],
|
|
264
|
+
"type": "object"
|
|
265
|
+
},
|
|
266
|
+
"orderby": {
|
|
267
|
+
"description": "Sort options.",
|
|
268
|
+
"items": {
|
|
269
|
+
"properties": {
|
|
270
|
+
"field": {
|
|
271
|
+
"description": "Field parameter.",
|
|
272
|
+
"enum": [
|
|
273
|
+
"follower_count",
|
|
274
|
+
"agency_collaboration_units_sold",
|
|
275
|
+
"agency_collaboration_gmv"
|
|
276
|
+
],
|
|
277
|
+
"type": "string"
|
|
278
|
+
},
|
|
279
|
+
"order": {
|
|
280
|
+
"default": "desc",
|
|
281
|
+
"description": "Order parameter.",
|
|
282
|
+
"enum": [
|
|
283
|
+
"asc",
|
|
284
|
+
"desc"
|
|
285
|
+
],
|
|
286
|
+
"type": "string"
|
|
287
|
+
}
|
|
288
|
+
},
|
|
289
|
+
"required": [
|
|
290
|
+
"field"
|
|
291
|
+
],
|
|
292
|
+
"type": "object"
|
|
293
|
+
},
|
|
294
|
+
"type": "array"
|
|
295
|
+
},
|
|
296
|
+
"page": {
|
|
297
|
+
"default": 1,
|
|
298
|
+
"description": "Page number. Default 1, max 10.",
|
|
299
|
+
"maximum": 10,
|
|
300
|
+
"minimum": 1,
|
|
301
|
+
"type": "integer"
|
|
302
|
+
},
|
|
303
|
+
"pagesize": {
|
|
304
|
+
"default": 10,
|
|
305
|
+
"description": "Page size. Default 10, max 10.",
|
|
306
|
+
"maximum": 10,
|
|
307
|
+
"minimum": 1,
|
|
308
|
+
"type": "integer"
|
|
309
|
+
}
|
|
310
|
+
},
|
|
311
|
+
"required": [
|
|
312
|
+
"filter"
|
|
313
|
+
],
|
|
314
|
+
"type": "object"
|
|
315
|
+
},
|
|
316
|
+
"name": "agency_creator_analysis"
|
|
317
|
+
},
|
|
318
|
+
{
|
|
319
|
+
"annotations": {
|
|
320
|
+
"title": "MCN agency product analysis",
|
|
321
|
+
"readOnlyHint": true,
|
|
322
|
+
"destructiveHint": false,
|
|
323
|
+
"idempotentHint": false,
|
|
324
|
+
"openWorldHint": true
|
|
325
|
+
},
|
|
326
|
+
"description": "Use for agency product-category and price-band structure. Use agency_product_list for individual products.",
|
|
327
|
+
"inputSchema": {
|
|
328
|
+
"properties": {
|
|
329
|
+
"filter": {
|
|
330
|
+
"description": "Filter parameters.",
|
|
331
|
+
"properties": {
|
|
332
|
+
"agency_id": {
|
|
333
|
+
"description": "Unique MCN agency ID; use agency_search first when only the agency name is known.",
|
|
334
|
+
"type": "string"
|
|
335
|
+
},
|
|
336
|
+
"time_range_days": {
|
|
337
|
+
"default": 28,
|
|
338
|
+
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
339
|
+
"enum": [
|
|
340
|
+
7,
|
|
341
|
+
28,
|
|
342
|
+
90
|
|
343
|
+
],
|
|
344
|
+
"type": "integer"
|
|
345
|
+
}
|
|
346
|
+
},
|
|
347
|
+
"required": [
|
|
348
|
+
"agency_id"
|
|
349
|
+
],
|
|
350
|
+
"type": "object"
|
|
351
|
+
}
|
|
352
|
+
},
|
|
353
|
+
"required": [
|
|
354
|
+
"filter"
|
|
355
|
+
],
|
|
356
|
+
"type": "object"
|
|
357
|
+
},
|
|
358
|
+
"name": "agency_product_analysis"
|
|
359
|
+
},
|
|
360
|
+
{
|
|
361
|
+
"annotations": {
|
|
362
|
+
"title": "MCN agency product list",
|
|
363
|
+
"readOnlyHint": true,
|
|
364
|
+
"destructiveHint": false,
|
|
365
|
+
"idempotentHint": false,
|
|
366
|
+
"openWorldHint": true
|
|
367
|
+
},
|
|
368
|
+
"description": "Use when the user wants individual products promoted through an agency. Supports category, price, period, sorting, and pagination.",
|
|
369
|
+
"inputSchema": {
|
|
370
|
+
"properties": {
|
|
371
|
+
"filter": {
|
|
372
|
+
"description": "Filter parameters.",
|
|
373
|
+
"properties": {
|
|
374
|
+
"agency_id": {
|
|
375
|
+
"description": "Unique MCN agency ID; use agency_search first when only the agency name is known.",
|
|
376
|
+
"type": "string"
|
|
377
|
+
},
|
|
378
|
+
"maximum_price": {
|
|
379
|
+
"description": "Inclusive product-price upper bound; currency follows the agency market.",
|
|
380
|
+
"minimum": 0,
|
|
381
|
+
"type": "number"
|
|
382
|
+
},
|
|
383
|
+
"minimum_price": {
|
|
384
|
+
"description": "Inclusive product-price lower bound; currency follows the agency market.",
|
|
385
|
+
"minimum": 0,
|
|
386
|
+
"type": "number"
|
|
387
|
+
},
|
|
388
|
+
"product_category_id": {
|
|
389
|
+
"description": "Product category ID.",
|
|
390
|
+
"type": "integer"
|
|
391
|
+
},
|
|
392
|
+
"time_range_days": {
|
|
393
|
+
"default": 28,
|
|
394
|
+
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
395
|
+
"enum": [
|
|
396
|
+
7,
|
|
397
|
+
28,
|
|
398
|
+
90
|
|
399
|
+
],
|
|
400
|
+
"type": "integer"
|
|
401
|
+
}
|
|
402
|
+
},
|
|
403
|
+
"required": [
|
|
404
|
+
"agency_id"
|
|
405
|
+
],
|
|
406
|
+
"type": "object"
|
|
407
|
+
},
|
|
408
|
+
"orderby": {
|
|
409
|
+
"description": "Sort options.",
|
|
410
|
+
"items": {
|
|
411
|
+
"properties": {
|
|
412
|
+
"field": {
|
|
413
|
+
"description": "Field parameter.",
|
|
414
|
+
"enum": [
|
|
415
|
+
"agency_collaboration_units_sold",
|
|
416
|
+
"agency_collaboration_gmv"
|
|
417
|
+
],
|
|
418
|
+
"type": "string"
|
|
419
|
+
},
|
|
420
|
+
"order": {
|
|
421
|
+
"default": "desc",
|
|
422
|
+
"description": "Order parameter.",
|
|
423
|
+
"enum": [
|
|
424
|
+
"asc",
|
|
425
|
+
"desc"
|
|
426
|
+
],
|
|
427
|
+
"type": "string"
|
|
428
|
+
}
|
|
429
|
+
},
|
|
430
|
+
"required": [
|
|
431
|
+
"field"
|
|
432
|
+
],
|
|
433
|
+
"type": "object"
|
|
434
|
+
},
|
|
435
|
+
"type": "array"
|
|
436
|
+
},
|
|
437
|
+
"page": {
|
|
438
|
+
"default": 1,
|
|
439
|
+
"description": "Page number. Default 1, max 10.",
|
|
440
|
+
"maximum": 10,
|
|
441
|
+
"minimum": 1,
|
|
442
|
+
"type": "integer"
|
|
443
|
+
},
|
|
444
|
+
"pagesize": {
|
|
445
|
+
"default": 10,
|
|
446
|
+
"description": "Page size. Default 10, max 10.",
|
|
447
|
+
"maximum": 10,
|
|
448
|
+
"minimum": 1,
|
|
449
|
+
"type": "integer"
|
|
450
|
+
}
|
|
451
|
+
},
|
|
452
|
+
"required": [
|
|
453
|
+
"filter"
|
|
454
|
+
],
|
|
455
|
+
"type": "object"
|
|
456
|
+
},
|
|
457
|
+
"name": "agency_product_list"
|
|
458
|
+
},
|
|
459
|
+
{
|
|
460
|
+
"annotations": {
|
|
461
|
+
"title": "MCN agency profile and data overview",
|
|
462
|
+
"readOnlyHint": true,
|
|
463
|
+
"destructiveHint": false,
|
|
464
|
+
"idempotentHint": false,
|
|
465
|
+
"openWorldHint": true
|
|
466
|
+
},
|
|
467
|
+
"description": "Use when the user wants an agency profile, historical performance, and recent 7/28/90-day data overview.",
|
|
468
|
+
"inputSchema": {
|
|
469
|
+
"properties": {
|
|
470
|
+
"filter": {
|
|
471
|
+
"description": "Filter parameters.",
|
|
472
|
+
"properties": {
|
|
473
|
+
"agency_id": {
|
|
474
|
+
"description": "Unique MCN agency ID; use agency_search first when only the agency name is known.",
|
|
475
|
+
"type": "string"
|
|
476
|
+
},
|
|
477
|
+
"time_range_days": {
|
|
478
|
+
"default": 28,
|
|
479
|
+
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
480
|
+
"enum": [
|
|
481
|
+
7,
|
|
482
|
+
28,
|
|
483
|
+
90
|
|
484
|
+
],
|
|
485
|
+
"type": "integer"
|
|
486
|
+
}
|
|
487
|
+
},
|
|
488
|
+
"required": [
|
|
489
|
+
"agency_id"
|
|
490
|
+
],
|
|
491
|
+
"type": "object"
|
|
492
|
+
}
|
|
493
|
+
},
|
|
494
|
+
"required": [
|
|
495
|
+
"filter"
|
|
496
|
+
],
|
|
497
|
+
"type": "object"
|
|
498
|
+
},
|
|
499
|
+
"name": "agency_profile_overview"
|
|
500
|
+
},
|
|
501
|
+
{
|
|
502
|
+
"annotations": {
|
|
503
|
+
"title": "Top MCN agencies",
|
|
504
|
+
"readOnlyHint": true,
|
|
505
|
+
"destructiveHint": false,
|
|
506
|
+
"idempotentHint": false,
|
|
507
|
+
"openWorldHint": true
|
|
508
|
+
},
|
|
509
|
+
"description": "Use when the user wants leading MCN agencies in a market. Returns weekly or monthly agency rankings and period performance.",
|
|
510
|
+
"inputSchema": {
|
|
511
|
+
"properties": {
|
|
512
|
+
"filter": {
|
|
513
|
+
"description": "Filter parameters.",
|
|
514
|
+
"properties": {
|
|
515
|
+
"date_type": {
|
|
516
|
+
"default": "week",
|
|
517
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
518
|
+
"enum": [
|
|
519
|
+
"week",
|
|
520
|
+
"month"
|
|
521
|
+
],
|
|
522
|
+
"type": "string"
|
|
523
|
+
},
|
|
524
|
+
"date_value": {
|
|
525
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
526
|
+
"type": "string"
|
|
527
|
+
},
|
|
528
|
+
"region": {
|
|
529
|
+
"description": "Country or region code, e.g. US, UK, ID.",
|
|
530
|
+
"type": "string"
|
|
531
|
+
}
|
|
532
|
+
},
|
|
533
|
+
"required": [],
|
|
534
|
+
"type": "object"
|
|
535
|
+
},
|
|
536
|
+
"orderby": {
|
|
537
|
+
"description": "Sort options.",
|
|
538
|
+
"items": {
|
|
539
|
+
"properties": {
|
|
540
|
+
"field": {
|
|
541
|
+
"description": "Field parameter.",
|
|
542
|
+
"enum": [
|
|
543
|
+
"gmv",
|
|
544
|
+
"collaborating_creator_count",
|
|
545
|
+
"collaborating_product_count",
|
|
546
|
+
"estimated_commission_amount"
|
|
547
|
+
],
|
|
548
|
+
"type": "string"
|
|
549
|
+
},
|
|
550
|
+
"order": {
|
|
551
|
+
"default": "desc",
|
|
552
|
+
"description": "Order parameter.",
|
|
553
|
+
"enum": [
|
|
554
|
+
"asc",
|
|
555
|
+
"desc"
|
|
556
|
+
],
|
|
557
|
+
"type": "string"
|
|
558
|
+
}
|
|
559
|
+
},
|
|
560
|
+
"required": [
|
|
561
|
+
"field"
|
|
562
|
+
],
|
|
563
|
+
"type": "object"
|
|
564
|
+
},
|
|
565
|
+
"type": "array"
|
|
566
|
+
},
|
|
567
|
+
"page": {
|
|
568
|
+
"default": 1,
|
|
569
|
+
"description": "Page number. Default 1, max 10.",
|
|
570
|
+
"maximum": 10,
|
|
571
|
+
"minimum": 1,
|
|
572
|
+
"type": "integer"
|
|
573
|
+
},
|
|
574
|
+
"pagesize": {
|
|
575
|
+
"default": 10,
|
|
576
|
+
"description": "Page size. Default 10, max 10.",
|
|
577
|
+
"maximum": 10,
|
|
578
|
+
"minimum": 1,
|
|
579
|
+
"type": "integer"
|
|
580
|
+
}
|
|
581
|
+
},
|
|
582
|
+
"required": [
|
|
583
|
+
"filter"
|
|
584
|
+
],
|
|
585
|
+
"type": "object"
|
|
586
|
+
},
|
|
587
|
+
"name": "agency_rank_top"
|
|
588
|
+
},
|
|
589
|
+
{
|
|
590
|
+
"annotations": {
|
|
591
|
+
"title": "MCN agency search",
|
|
592
|
+
"readOnlyHint": true,
|
|
593
|
+
"destructiveHint": false,
|
|
594
|
+
"idempotentHint": false,
|
|
595
|
+
"openWorldHint": true
|
|
596
|
+
},
|
|
597
|
+
"description": "Use when the user has an agency name or market clue but no agency_id. Returns matching agencies and recent 7-day performance.",
|
|
598
|
+
"inputSchema": {
|
|
599
|
+
"properties": {
|
|
600
|
+
"filter": {
|
|
601
|
+
"description": "Filter parameters.",
|
|
602
|
+
"properties": {
|
|
603
|
+
"region": {
|
|
604
|
+
"description": "Country or region code, e.g. US, UK, ID.",
|
|
605
|
+
"type": "string"
|
|
606
|
+
},
|
|
607
|
+
"search_keyword": {
|
|
608
|
+
"description": "Agency-name keyword, maximum 120 characters.",
|
|
609
|
+
"maxLength": 120,
|
|
610
|
+
"type": "string"
|
|
611
|
+
}
|
|
612
|
+
},
|
|
613
|
+
"required": [],
|
|
614
|
+
"type": "object"
|
|
615
|
+
},
|
|
616
|
+
"orderby": {
|
|
617
|
+
"description": "Sort options.",
|
|
618
|
+
"items": {
|
|
619
|
+
"properties": {
|
|
620
|
+
"field": {
|
|
621
|
+
"description": "Field parameter.",
|
|
622
|
+
"enum": [
|
|
623
|
+
"recent_7d_gmv"
|
|
624
|
+
],
|
|
625
|
+
"type": "string"
|
|
626
|
+
},
|
|
627
|
+
"order": {
|
|
628
|
+
"default": "desc",
|
|
629
|
+
"description": "Order parameter.",
|
|
630
|
+
"enum": [
|
|
631
|
+
"asc",
|
|
632
|
+
"desc"
|
|
633
|
+
],
|
|
634
|
+
"type": "string"
|
|
635
|
+
}
|
|
636
|
+
},
|
|
637
|
+
"required": [
|
|
638
|
+
"field"
|
|
639
|
+
],
|
|
640
|
+
"type": "object"
|
|
641
|
+
},
|
|
642
|
+
"type": "array"
|
|
643
|
+
},
|
|
644
|
+
"page": {
|
|
645
|
+
"default": 1,
|
|
646
|
+
"description": "Page number. Default 1, max 10.",
|
|
647
|
+
"maximum": 10,
|
|
648
|
+
"minimum": 1,
|
|
649
|
+
"type": "integer"
|
|
650
|
+
},
|
|
651
|
+
"pagesize": {
|
|
652
|
+
"default": 10,
|
|
653
|
+
"description": "Page size. Default 10, max 10.",
|
|
654
|
+
"maximum": 10,
|
|
655
|
+
"minimum": 1,
|
|
656
|
+
"type": "integer"
|
|
657
|
+
}
|
|
658
|
+
},
|
|
659
|
+
"required": [
|
|
660
|
+
"filter"
|
|
661
|
+
],
|
|
662
|
+
"type": "object"
|
|
663
|
+
},
|
|
664
|
+
"name": "agency_search"
|
|
665
|
+
},
|
|
666
|
+
{
|
|
667
|
+
"annotations": {
|
|
668
|
+
"title": "MCN agency shop analysis",
|
|
669
|
+
"readOnlyHint": true,
|
|
670
|
+
"destructiveHint": false,
|
|
671
|
+
"idempotentHint": false,
|
|
672
|
+
"openWorldHint": true
|
|
673
|
+
},
|
|
674
|
+
"description": "Use when the user wants agency collaborating-shop totals and individual shop performance.",
|
|
675
|
+
"inputSchema": {
|
|
676
|
+
"properties": {
|
|
677
|
+
"filter": {
|
|
678
|
+
"description": "Filter parameters.",
|
|
679
|
+
"properties": {
|
|
680
|
+
"agency_id": {
|
|
681
|
+
"description": "Unique MCN agency ID; use agency_search first when only the agency name is known.",
|
|
682
|
+
"type": "string"
|
|
683
|
+
},
|
|
684
|
+
"product_category_id": {
|
|
685
|
+
"description": "Product category ID.",
|
|
686
|
+
"type": "integer"
|
|
687
|
+
},
|
|
688
|
+
"time_range_days": {
|
|
689
|
+
"default": 28,
|
|
690
|
+
"description": "Days: 7/14/28/90; recent=28; -1=cumulative.",
|
|
691
|
+
"enum": [
|
|
692
|
+
7,
|
|
693
|
+
28,
|
|
694
|
+
90
|
|
695
|
+
],
|
|
696
|
+
"type": "integer"
|
|
697
|
+
}
|
|
698
|
+
},
|
|
699
|
+
"required": [
|
|
700
|
+
"agency_id"
|
|
701
|
+
],
|
|
702
|
+
"type": "object"
|
|
703
|
+
},
|
|
704
|
+
"orderby": {
|
|
705
|
+
"description": "Sort options.",
|
|
706
|
+
"items": {
|
|
707
|
+
"properties": {
|
|
708
|
+
"field": {
|
|
709
|
+
"description": "Field parameter.",
|
|
710
|
+
"enum": [
|
|
711
|
+
"collaborating_product_count",
|
|
712
|
+
"agency_collaboration_units_sold",
|
|
713
|
+
"agency_collaboration_gmv"
|
|
714
|
+
],
|
|
715
|
+
"type": "string"
|
|
716
|
+
},
|
|
717
|
+
"order": {
|
|
718
|
+
"default": "desc",
|
|
719
|
+
"description": "Order parameter.",
|
|
720
|
+
"enum": [
|
|
721
|
+
"asc",
|
|
722
|
+
"desc"
|
|
723
|
+
],
|
|
724
|
+
"type": "string"
|
|
725
|
+
}
|
|
726
|
+
},
|
|
727
|
+
"required": [
|
|
728
|
+
"field"
|
|
729
|
+
],
|
|
730
|
+
"type": "object"
|
|
731
|
+
},
|
|
732
|
+
"type": "array"
|
|
733
|
+
},
|
|
734
|
+
"page": {
|
|
735
|
+
"default": 1,
|
|
736
|
+
"description": "Page number. Default 1, max 10.",
|
|
737
|
+
"maximum": 10,
|
|
738
|
+
"minimum": 1,
|
|
739
|
+
"type": "integer"
|
|
740
|
+
},
|
|
741
|
+
"pagesize": {
|
|
742
|
+
"default": 10,
|
|
743
|
+
"description": "Page size. Default 10, max 10.",
|
|
744
|
+
"maximum": 10,
|
|
745
|
+
"minimum": 1,
|
|
746
|
+
"type": "integer"
|
|
747
|
+
}
|
|
748
|
+
},
|
|
749
|
+
"required": [
|
|
750
|
+
"filter"
|
|
751
|
+
],
|
|
752
|
+
"type": "object"
|
|
753
|
+
},
|
|
754
|
+
"name": "agency_shop_analysis"
|
|
755
|
+
},
|
|
232
756
|
{
|
|
233
757
|
"annotations": {
|
|
234
758
|
"title": "Creator ecommerce summary",
|
|
@@ -276,7 +800,7 @@
|
|
|
276
800
|
"description": "Filter parameters.",
|
|
277
801
|
"properties": {
|
|
278
802
|
"date_type": {
|
|
279
|
-
"description": "Ranking period: day, week, or month.",
|
|
803
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
280
804
|
"type": "integer"
|
|
281
805
|
},
|
|
282
806
|
"end_date": {
|
|
@@ -490,7 +1014,7 @@
|
|
|
490
1014
|
"type": "integer"
|
|
491
1015
|
},
|
|
492
1016
|
"date_type": {
|
|
493
|
-
"description": "Ranking period: day, week, or month.",
|
|
1017
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
494
1018
|
"enum": [
|
|
495
1019
|
"day",
|
|
496
1020
|
"week",
|
|
@@ -499,7 +1023,7 @@
|
|
|
499
1023
|
"type": "string"
|
|
500
1024
|
},
|
|
501
1025
|
"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.",
|
|
1026
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
503
1027
|
"type": "string"
|
|
504
1028
|
},
|
|
505
1029
|
"ecommerce_type": {
|
|
@@ -582,7 +1106,7 @@
|
|
|
582
1106
|
"type": "integer"
|
|
583
1107
|
},
|
|
584
1108
|
"date_type": {
|
|
585
|
-
"description": "Ranking period: day, week, or month.",
|
|
1109
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
586
1110
|
"enum": [
|
|
587
1111
|
"day",
|
|
588
1112
|
"week",
|
|
@@ -591,7 +1115,7 @@
|
|
|
591
1115
|
"type": "string"
|
|
592
1116
|
},
|
|
593
1117
|
"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.",
|
|
1118
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
595
1119
|
"type": "string"
|
|
596
1120
|
},
|
|
597
1121
|
"region": {
|
|
@@ -679,7 +1203,7 @@
|
|
|
679
1203
|
"type": "integer"
|
|
680
1204
|
},
|
|
681
1205
|
"date_type": {
|
|
682
|
-
"description": "Ranking period: day, week, or month.",
|
|
1206
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
683
1207
|
"enum": [
|
|
684
1208
|
"day",
|
|
685
1209
|
"week",
|
|
@@ -688,7 +1212,7 @@
|
|
|
688
1212
|
"type": "string"
|
|
689
1213
|
},
|
|
690
1214
|
"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.",
|
|
1215
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
692
1216
|
"type": "string"
|
|
693
1217
|
},
|
|
694
1218
|
"ecommerce_type": {
|
|
@@ -1278,11 +1802,11 @@
|
|
|
1278
1802
|
"type": "integer"
|
|
1279
1803
|
},
|
|
1280
1804
|
"date_type": {
|
|
1281
|
-
"description": "Ranking period: day, week, or month.",
|
|
1805
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
1282
1806
|
"type": "string"
|
|
1283
1807
|
},
|
|
1284
1808
|
"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.",
|
|
1809
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
1286
1810
|
"type": "string"
|
|
1287
1811
|
},
|
|
1288
1812
|
"region": {
|
|
@@ -1324,7 +1848,7 @@
|
|
|
1324
1848
|
"type": "integer"
|
|
1325
1849
|
},
|
|
1326
1850
|
"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.",
|
|
1851
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
1328
1852
|
"type": "string"
|
|
1329
1853
|
},
|
|
1330
1854
|
"region": {
|
|
@@ -1366,11 +1890,11 @@
|
|
|
1366
1890
|
"type": "integer"
|
|
1367
1891
|
},
|
|
1368
1892
|
"date_type": {
|
|
1369
|
-
"description": "Ranking period: day, week, or month.",
|
|
1893
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
1370
1894
|
"type": "string"
|
|
1371
1895
|
},
|
|
1372
1896
|
"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.",
|
|
1897
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
1374
1898
|
"type": "string"
|
|
1375
1899
|
},
|
|
1376
1900
|
"region": {
|
|
@@ -1652,7 +2176,7 @@
|
|
|
1652
2176
|
"type": "integer"
|
|
1653
2177
|
},
|
|
1654
2178
|
"date_type": {
|
|
1655
|
-
"description": "Ranking period: day, week, or month.",
|
|
2179
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
1656
2180
|
"enum": [
|
|
1657
2181
|
"day",
|
|
1658
2182
|
"week",
|
|
@@ -1661,7 +2185,7 @@
|
|
|
1661
2185
|
"type": "string"
|
|
1662
2186
|
},
|
|
1663
2187
|
"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.",
|
|
2188
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
1665
2189
|
"type": "string"
|
|
1666
2190
|
},
|
|
1667
2191
|
"is_cross_border": {
|
|
@@ -1745,7 +2269,7 @@
|
|
|
1745
2269
|
"type": "integer"
|
|
1746
2270
|
},
|
|
1747
2271
|
"date_type": {
|
|
1748
|
-
"description": "Ranking period: day, week, or month.",
|
|
2272
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
1749
2273
|
"enum": [
|
|
1750
2274
|
"day",
|
|
1751
2275
|
"week",
|
|
@@ -1754,7 +2278,7 @@
|
|
|
1754
2278
|
"type": "string"
|
|
1755
2279
|
},
|
|
1756
2280
|
"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.",
|
|
2281
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
1758
2282
|
"type": "string"
|
|
1759
2283
|
},
|
|
1760
2284
|
"region": {
|
|
@@ -2827,7 +3351,7 @@
|
|
|
2827
3351
|
"type": "integer"
|
|
2828
3352
|
},
|
|
2829
3353
|
"date_type": {
|
|
2830
|
-
"description": "Ranking period: day, week, or month.",
|
|
3354
|
+
"description": "Ranking period: day, week, or month; MCN agency rankings support only week/month.",
|
|
2831
3355
|
"enum": [
|
|
2832
3356
|
"day",
|
|
2833
3357
|
"week",
|
|
@@ -2836,7 +3360,7 @@
|
|
|
2836
3360
|
"type": "string"
|
|
2837
3361
|
},
|
|
2838
3362
|
"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.",
|
|
3363
|
+
"description": "Completed period only: yesterday YYYY-MM-DD, last week YYYY-ww or YYYY-Www, last month YYYY-MM; do not use the current period.",
|
|
2840
3364
|
"type": "string"
|
|
2841
3365
|
},
|
|
2842
3366
|
"is_cross_border": {
|
|
@@ -34,6 +34,7 @@ If a value contains a single quote, write the JSON to a temporary file or carefu
|
|
|
34
34
|
|
|
35
35
|
1. Read `references/tools.md` for the packaged static catalog index, then read the matching category file:
|
|
36
36
|
- `tools-advertising.md` for `ad_` tools.
|
|
37
|
+
- `tools-agency.md` for `agency_` tools.
|
|
37
38
|
- `tools-creator.md` for `creator_` tools.
|
|
38
39
|
- `tools-product.md` for `product_` tools.
|
|
39
40
|
- `tools-shop.md` for `shop_` tools.
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
# Agency Tools
|
|
2
|
+
|
|
3
|
+
> Agency tools for MCN agency search, rankings, profiles, creator collaborations, promoted products, and collaborating-shop analysis.
|
|
4
|
+
|
|
5
|
+
## Tool summary
|
|
6
|
+
|
|
7
|
+
| Tool | Description |
|
|
8
|
+
|---|---|
|
|
9
|
+
| agency_creator_analysis | Use when the user wants agency creator structure, follower tiers, and individual collaborators. Returns distributions... |
|
|
10
|
+
| agency_product_analysis | Use for agency product-category and price-band structure. Use agency_product_list for individual products. |
|
|
11
|
+
| agency_product_list | Use when the user wants individual products promoted through an agency. Supports category, price, period, sorting, an... |
|
|
12
|
+
| agency_profile_overview | Use when the user wants an agency profile, historical performance, and recent 7/28/90-day data overview. |
|
|
13
|
+
| agency_rank_top | Use when the user wants leading MCN agencies in a market. Returns weekly or monthly agency rankings and period perfor... |
|
|
14
|
+
| agency_search | Use when the user has an agency name or market clue but no agency_id. Returns matching agencies and recent 7-day perf... |
|
|
15
|
+
| agency_shop_analysis | Use when the user wants agency collaborating-shop totals and individual shop performance. |
|
|
16
|
+
|
|
17
|
+
## Tool details
|
|
18
|
+
|
|
19
|
+
### agency_creator_analysis
|
|
20
|
+
|
|
21
|
+
Use when the user wants agency creator structure, follower tiers, and individual collaborators. Returns distributions and a paginated creator list.
|
|
22
|
+
|
|
23
|
+
Example:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
fastmoss call --tool agency_creator_analysis --args '{"filter":{}}' --output mcp
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Parameters:
|
|
30
|
+
|
|
31
|
+
| Name | Type | Required | Description |
|
|
32
|
+
|---|---|---|---|
|
|
33
|
+
| filter | object | yes | Filter parameters. |
|
|
34
|
+
| orderby | array | no | Sort options. |
|
|
35
|
+
| page | integer | no | Page number. Default 1, max 10. |
|
|
36
|
+
| pagesize | integer | no | Page size. Default 10, max 10. |
|
|
37
|
+
|
|
38
|
+
### agency_product_analysis
|
|
39
|
+
|
|
40
|
+
Use for agency product-category and price-band structure. Use agency_product_list for individual products.
|
|
41
|
+
|
|
42
|
+
Example:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
fastmoss call --tool agency_product_analysis --args '{"filter":{}}' --output mcp
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Parameters:
|
|
49
|
+
|
|
50
|
+
| Name | Type | Required | Description |
|
|
51
|
+
|---|---|---|---|
|
|
52
|
+
| filter | object | yes | Filter parameters. |
|
|
53
|
+
|
|
54
|
+
### agency_product_list
|
|
55
|
+
|
|
56
|
+
Use when the user wants individual products promoted through an agency. Supports category, price, period, sorting, and pagination.
|
|
57
|
+
|
|
58
|
+
Example:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
fastmoss call --tool agency_product_list --args '{"filter":{}}' --output mcp
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Parameters:
|
|
65
|
+
|
|
66
|
+
| Name | Type | Required | Description |
|
|
67
|
+
|---|---|---|---|
|
|
68
|
+
| filter | object | yes | Filter parameters. |
|
|
69
|
+
| orderby | array | no | Sort options. |
|
|
70
|
+
| page | integer | no | Page number. Default 1, max 10. |
|
|
71
|
+
| pagesize | integer | no | Page size. Default 10, max 10. |
|
|
72
|
+
|
|
73
|
+
### agency_profile_overview
|
|
74
|
+
|
|
75
|
+
Use when the user wants an agency profile, historical performance, and recent 7/28/90-day data overview.
|
|
76
|
+
|
|
77
|
+
Example:
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
fastmoss call --tool agency_profile_overview --args '{"filter":{}}' --output mcp
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Parameters:
|
|
84
|
+
|
|
85
|
+
| Name | Type | Required | Description |
|
|
86
|
+
|---|---|---|---|
|
|
87
|
+
| filter | object | yes | Filter parameters. |
|
|
88
|
+
|
|
89
|
+
### agency_rank_top
|
|
90
|
+
|
|
91
|
+
Use when the user wants leading MCN agencies in a market. Returns weekly or monthly agency rankings and period performance.
|
|
92
|
+
|
|
93
|
+
Example:
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
fastmoss call --tool agency_rank_top --args '{"filter":{}}' --output mcp
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Parameters:
|
|
100
|
+
|
|
101
|
+
| Name | Type | Required | Description |
|
|
102
|
+
|---|---|---|---|
|
|
103
|
+
| filter | object | yes | Filter parameters. |
|
|
104
|
+
| orderby | array | no | Sort options. |
|
|
105
|
+
| page | integer | no | Page number. Default 1, max 10. |
|
|
106
|
+
| pagesize | integer | no | Page size. Default 10, max 10. |
|
|
107
|
+
|
|
108
|
+
### agency_search
|
|
109
|
+
|
|
110
|
+
Use when the user has an agency name or market clue but no agency_id. Returns matching agencies and recent 7-day performance.
|
|
111
|
+
|
|
112
|
+
Example:
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
fastmoss call --tool agency_search --args '{"filter":{}}' --output mcp
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Parameters:
|
|
119
|
+
|
|
120
|
+
| Name | Type | Required | Description |
|
|
121
|
+
|---|---|---|---|
|
|
122
|
+
| filter | object | yes | Filter parameters. |
|
|
123
|
+
| orderby | array | no | Sort options. |
|
|
124
|
+
| page | integer | no | Page number. Default 1, max 10. |
|
|
125
|
+
| pagesize | integer | no | Page size. Default 10, max 10. |
|
|
126
|
+
|
|
127
|
+
### agency_shop_analysis
|
|
128
|
+
|
|
129
|
+
Use when the user wants agency collaborating-shop totals and individual shop performance.
|
|
130
|
+
|
|
131
|
+
Example:
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
fastmoss call --tool agency_shop_analysis --args '{"filter":{}}' --output mcp
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
Parameters:
|
|
138
|
+
|
|
139
|
+
| Name | Type | Required | Description |
|
|
140
|
+
|---|---|---|---|
|
|
141
|
+
| filter | object | yes | Filter parameters. |
|
|
142
|
+
| orderby | array | no | Sort options. |
|
|
143
|
+
| page | integer | no | Page number. Default 1, max 10. |
|
|
144
|
+
| pagesize | integer | no | Page size. Default 10, max 10. |
|
|
145
|
+
|
|
@@ -15,6 +15,7 @@ Use `fastmoss tools --search <tool_name>` only when the installed CLI and accoun
|
|
|
15
15
|
| Category | File | Tools | Use for |
|
|
16
16
|
|---|---|---:|---|
|
|
17
17
|
| Advertising Tools | [Advertising Tools](tools-advertising.md) | 2 | Advertising tools for ad creatives, ad spend, ROAS, engagement, and paid-traffic performance analysis. |
|
|
18
|
+
| Agency Tools | [Agency Tools](tools-agency.md) | 7 | Agency tools for MCN agency search, rankings, profiles, creator collaborations, promoted products, and collaborating-shop analysis. |
|
|
18
19
|
| Creator Tools | [Creator Tools](tools-creator.md) | 10 | Creator tools for creator search, profile checks, ecommerce performance, audience fit, trends, videos, and partnership evaluation. |
|
|
19
20
|
| Product Tools | [Product Tools](tools-product.md) | 12 | Product tools for product search, details, sales trends, creator mix, videos, SKUs, reviews, and ad investment analysis. |
|
|
20
21
|
| Shop Tools | [Shop Tools](tools-shop.md) | 10 | Shop tools for shop search, profile checks, sales, products, creators, livestreams, short videos, and ad investment analysis. |
|