@fastmoss/cli 0.1.14 → 0.1.16
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 +54 -55
- package/README.zh-CN.md +75 -76
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -82,90 +82,89 @@ fastmoss call --tool <tool_name> --args '<json>' --output mcp
|
|
|
82
82
|
|
|
83
83
|
| Tool | Description |
|
|
84
84
|
|---|---|
|
|
85
|
-
| `ad_data_overview` |
|
|
86
|
-
| `ad_search` |
|
|
85
|
+
| `ad_data_overview` | View a video's ad spend, ROAS, reach, engagement, followers, and commerce performance over time. |
|
|
86
|
+
| `ad_search` | Find active ads by market, category, landing page, spend, ROAS, reach, or run duration. |
|
|
87
87
|
|
|
88
88
|
### Agency Tools
|
|
89
89
|
|
|
90
90
|
| Tool | Description |
|
|
91
91
|
|---|---|
|
|
92
|
-
| `agency_creator_analysis` |
|
|
93
|
-
| `agency_product_analysis` |
|
|
94
|
-
| `agency_product_list` |
|
|
95
|
-
| `agency_profile_overview` |
|
|
96
|
-
| `agency_rank_top` |
|
|
97
|
-
| `agency_search` |
|
|
98
|
-
| `agency_shop_analysis` |
|
|
92
|
+
| `agency_creator_analysis` | Analyze an agency's creator mix, follower tiers, and collaborators. |
|
|
93
|
+
| `agency_product_analysis` | Analyze an agency's promoted product categories and price bands. |
|
|
94
|
+
| `agency_product_list` | List products promoted by an agency with category, price, period, and ranking filters. |
|
|
95
|
+
| `agency_profile_overview` | View an agency profile and recent 7/28/90-day performance. |
|
|
96
|
+
| `agency_rank_top` | Rank leading MCN agencies by weekly or monthly performance. |
|
|
97
|
+
| `agency_search` | Find agencies by name or market clue. |
|
|
98
|
+
| `agency_shop_analysis` | Analyze an agency's collaborating shops and their performance. |
|
|
99
99
|
|
|
100
100
|
### Creator Tools
|
|
101
101
|
|
|
102
102
|
| Tool | Description |
|
|
103
103
|
|---|---|
|
|
104
|
-
| `creator_cargo_summary` |
|
|
105
|
-
| `creator_data_trends` |
|
|
106
|
-
| `creator_fans_distribution` |
|
|
107
|
-
| `creator_product_list` |
|
|
108
|
-
| `creator_profile_overview` |
|
|
109
|
-
| `creator_rank_top_ecommerce` |
|
|
110
|
-
| `creator_rank_top_growth` |
|
|
111
|
-
| `creator_rank_top_potential` |
|
|
112
|
-
| `creator_search` |
|
|
113
|
-
| `creator_video_analysis` |
|
|
104
|
+
| `creator_cargo_summary` | Compare a creator's video and live selling mix and promoted categories. |
|
|
105
|
+
| `creator_data_trends` | Track creator follower, engagement, and commerce trends. |
|
|
106
|
+
| `creator_fans_distribution` | Analyze a creator audience by age, gender, location, and segments. |
|
|
107
|
+
| `creator_product_list` | List products promoted by a creator with GMV, sales, price, commission, and shop data. |
|
|
108
|
+
| `creator_profile_overview` | View a creator profile and historical performance snapshot. |
|
|
109
|
+
| `creator_rank_top_ecommerce` | Rank top ecommerce creators. |
|
|
110
|
+
| `creator_rank_top_growth` | Rank fast-growing creators. |
|
|
111
|
+
| `creator_rank_top_potential` | Find creators with ecommerce potential. |
|
|
112
|
+
| `creator_search` | Find creators by nickname, keyword, niche, or market. |
|
|
113
|
+
| `creator_video_analysis` | Analyze creator content direction, tags, videos, and linked products. |
|
|
114
114
|
|
|
115
115
|
### Product Tools
|
|
116
116
|
|
|
117
117
|
| Tool | Description |
|
|
118
118
|
|---|---|
|
|
119
|
-
| `product_category_info` |
|
|
120
|
-
| `product_creator_analysis` |
|
|
121
|
-
| `product_detail_info` |
|
|
122
|
-
| `product_investment` |
|
|
123
|
-
| `product_overview` |
|
|
124
|
-
| `product_rank_new_listed` |
|
|
125
|
-
| `product_rank_top_selling` |
|
|
126
|
-
| `product_review_list` |
|
|
127
|
-
| `product_sales_trend` |
|
|
128
|
-
| `product_search` |
|
|
129
|
-
| `product_sku` |
|
|
130
|
-
| `product_video_list` |
|
|
119
|
+
| `product_category_info` | Get the TikTok Shop product category tree and hierarchy. |
|
|
120
|
+
| `product_creator_analysis` | Analyze creators who promote a product and their contribution. |
|
|
121
|
+
| `product_detail_info` | Get product, shop, price, rating, logistics, image, and ad details. |
|
|
122
|
+
| `product_investment` | Analyze a product's ad spend, ROAS, ad GMV, and paid-traffic trends. |
|
|
123
|
+
| `product_overview` | Analyze product channels, lifecycle, momentum, and organic versus ad mix. |
|
|
124
|
+
| `product_rank_new_listed` | Find popular products listed within the last 30 days. |
|
|
125
|
+
| `product_rank_top_selling` | Rank bestselling products and compare sales growth. |
|
|
126
|
+
| `product_review_list` | Get product reviews and buyer feedback. |
|
|
127
|
+
| `product_sales_trend` | Track product GMV and unit-sales trends. |
|
|
128
|
+
| `product_search` | Find products by name, keyword, price, category, or market signal. |
|
|
129
|
+
| `product_sku` | Analyze SKU sales share, inventory share, and SKU health. |
|
|
130
|
+
| `product_video_list` | Find videos selling a product and compare paid versus organic traffic. |
|
|
131
131
|
|
|
132
132
|
### Shop Tools
|
|
133
133
|
|
|
134
134
|
| Tool | Description |
|
|
135
135
|
|---|---|
|
|
136
|
-
| `shop_base_info` |
|
|
137
|
-
| `shop_creator_analysis` |
|
|
138
|
-
| `shop_data_trends` |
|
|
139
|
-
| `shop_investment_analysis` |
|
|
140
|
-
| `shop_live_analysis` |
|
|
141
|
-
| `shop_product_analysis` |
|
|
142
|
-
| `shop_rank_top_selling` |
|
|
143
|
-
| `shop_sale_analysis` |
|
|
144
|
-
| `shop_search` |
|
|
145
|
-
| `shop_video_analysis` |
|
|
136
|
+
| `shop_base_info` | View a shop profile, ratings, cumulative sales, ranks, and operating scale. |
|
|
137
|
+
| `shop_creator_analysis` | Analyze shop collaborators, creator tiers, and selling structure. |
|
|
138
|
+
| `shop_data_trends` | Track shop GMV, sales, creator, live, video, and product trends. |
|
|
139
|
+
| `shop_investment_analysis` | Analyze shop advertising spend, ROAS, ad GMV, and promoted assets. |
|
|
140
|
+
| `shop_live_analysis` | Analyze shop live performance and individual live sessions. |
|
|
141
|
+
| `shop_product_analysis` | Analyze shop categories, price bands, product mix, and products. |
|
|
142
|
+
| `shop_rank_top_selling` | Rank top-selling shops by market or category. |
|
|
143
|
+
| `shop_sale_analysis` | Analyze shop sales by video, live, product card, creator, and self-operated channels. |
|
|
144
|
+
| `shop_search` | Find shops by name, keyword, or market. |
|
|
145
|
+
| `shop_video_analysis` | Analyze shop selling videos, performance, and ad status. |
|
|
146
146
|
|
|
147
147
|
### Market Insight Tools
|
|
148
148
|
|
|
149
149
|
| Tool | Description |
|
|
150
150
|
|---|---|
|
|
151
|
-
| `market_category_analysis` |
|
|
152
|
-
| `market_category_author_sales_matrix` |
|
|
153
|
-
| `market_category_ranking` |
|
|
151
|
+
| `market_category_analysis` | Analyze category size, growth, competition, opportunity, sales trends, and price distribution. |
|
|
152
|
+
| `market_category_author_sales_matrix` | Analyze category sales contribution by creator follower tier. |
|
|
153
|
+
| `market_category_ranking` | Rank categories and analyze growth and concentration. |
|
|
154
154
|
|
|
155
155
|
### Auxiliary and Knowledge Base Tools
|
|
156
156
|
|
|
157
157
|
| Tool | Description |
|
|
158
158
|
|---|---|
|
|
159
|
-
| `fastmoss_detail_url_examples` |
|
|
160
|
-
| `live_detail_analysis` |
|
|
161
|
-
| `live_products_list` |
|
|
162
|
-
| `live_search` |
|
|
163
|
-
| `search_category_by_words` |
|
|
164
|
-
| `search_fastmoss_documents` |
|
|
165
|
-
| `video_data_trends` |
|
|
166
|
-
| `video_detail_analysis` |
|
|
167
|
-
| `video_script_info` |
|
|
168
|
-
| `video_search` |
|
|
169
|
-
|
|
159
|
+
| `fastmoss_detail_url_examples` | Get FastMoss detail-page URL templates for products, creators, shops, videos, and lives. |
|
|
160
|
+
| `live_detail_analysis` | Analyze a live session, creator, performance, and category breakdown. |
|
|
161
|
+
| `live_products_list` | List products sold in a live session and their GMV and unit sales. |
|
|
162
|
+
| `live_search` | Find live sessions by title, host, or shop. |
|
|
163
|
+
| `search_category_by_words` | Match a natural-language product term to TikTok Shop categories. |
|
|
164
|
+
| `search_fastmoss_documents` | Search FastMoss documentation, rules, features, and operational guidance. |
|
|
165
|
+
| `video_data_trends` | Track a video's plays, likes, comments, and shares over time. |
|
|
166
|
+
| `video_detail_analysis` | Analyze a video's basics, reach, engagement, IPM, and linked products. |
|
|
167
|
+
| `video_script_info` | Get video subtitles or spoken-script text. |
|
|
168
|
+
| `video_search` | Find videos by keyword, title, or creator. |
|
|
170
169
|
|
|
171
170
|
This package only installs the CLI. Use `@fastmoss/skill` when you want an Agent Skill that teaches an agent how and when to call the CLI.
|
package/README.zh-CN.md
CHANGED
|
@@ -76,96 +76,95 @@ fastmoss tools
|
|
|
76
76
|
fastmoss call --tool <tool_name> --args '<json>' --output mcp
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
## CLI
|
|
79
|
+
## CLI 工具列表
|
|
80
80
|
|
|
81
|
-
###
|
|
81
|
+
### 广告工具
|
|
82
82
|
|
|
83
|
-
|
|
|
83
|
+
| 工具 | 说明 |
|
|
84
84
|
|---|---|
|
|
85
|
-
| `ad_data_overview` |
|
|
86
|
-
| `ad_search` |
|
|
85
|
+
| `ad_data_overview` | 查看指定视频在一段时间内的广告花费、ROAS、播放、互动、涨粉和电商表现。 |
|
|
86
|
+
| `ad_search` | 按市场、类目、落地页、花费、ROAS、播放量或投放时长筛选活跃广告。 |
|
|
87
87
|
|
|
88
|
-
###
|
|
88
|
+
### MCN 机构工具
|
|
89
89
|
|
|
90
|
-
|
|
|
90
|
+
| 工具 | 说明 |
|
|
91
91
|
|---|---|
|
|
92
|
-
| `agency_creator_analysis` |
|
|
93
|
-
| `agency_product_analysis` |
|
|
94
|
-
| `agency_product_list` |
|
|
95
|
-
| `agency_profile_overview` |
|
|
96
|
-
| `agency_rank_top` |
|
|
97
|
-
| `agency_search` |
|
|
98
|
-
| `agency_shop_analysis` |
|
|
92
|
+
| `agency_creator_analysis` | 分析 MCN 的达人结构、粉丝层级和合作达人。 |
|
|
93
|
+
| `agency_product_analysis` | 分析 MCN 推广商品的类目结构和价格带。 |
|
|
94
|
+
| `agency_product_list` | 查询 MCN 推广的商品，可按类目、价格、周期和排序筛选。 |
|
|
95
|
+
| `agency_profile_overview` | 查看 MCN 档案及近 7/28/90 天业绩概览。 |
|
|
96
|
+
| `agency_rank_top` | 获取按周或按月排行的头部 MCN 机构。 |
|
|
97
|
+
| `agency_search` | 通过机构名称或市场线索搜索 MCN。 |
|
|
98
|
+
| `agency_shop_analysis` | 分析 MCN 合作店铺及其经营表现。 |
|
|
99
99
|
|
|
100
|
-
###
|
|
100
|
+
### 达人工具
|
|
101
101
|
|
|
102
|
-
|
|
|
102
|
+
| 工具 | 说明 |
|
|
103
103
|
|---|---|
|
|
104
|
-
| `creator_cargo_summary` |
|
|
105
|
-
| `creator_data_trends` |
|
|
106
|
-
| `creator_fans_distribution` |
|
|
107
|
-
| `creator_product_list` |
|
|
108
|
-
| `creator_profile_overview` |
|
|
109
|
-
| `creator_rank_top_ecommerce` |
|
|
110
|
-
| `creator_rank_top_growth` |
|
|
111
|
-
| `creator_rank_top_potential` |
|
|
112
|
-
| `creator_search` |
|
|
113
|
-
| `creator_video_analysis` |
|
|
114
|
-
|
|
115
|
-
###
|
|
116
|
-
|
|
117
|
-
|
|
|
104
|
+
| `creator_cargo_summary` | 对比达人短视频和直播带货结构及主推类目。 |
|
|
105
|
+
| `creator_data_trends` | 跟踪达人的粉丝、互动和电商数据趋势。 |
|
|
106
|
+
| `creator_fans_distribution` | 按年龄、性别、地区和人群标签分析达人受众。 |
|
|
107
|
+
| `creator_product_list` | 查询达人带货商品及 GMV、销量、价格、佣金和店铺信息。 |
|
|
108
|
+
| `creator_profile_overview` | 查看达人档案与历史业绩快照。 |
|
|
109
|
+
| `creator_rank_top_ecommerce` | 获取头部电商达人排行。 |
|
|
110
|
+
| `creator_rank_top_growth` | 获取增长最快的达人排行。 |
|
|
111
|
+
| `creator_rank_top_potential` | 寻找具有电商潜力的达人。 |
|
|
112
|
+
| `creator_search` | 按昵称、关键词、赛道或市场搜索达人。 |
|
|
113
|
+
| `creator_video_analysis` | 分析达人的内容方向、标签、带货视频及关联商品。 |
|
|
114
|
+
|
|
115
|
+
### 商品工具
|
|
116
|
+
|
|
117
|
+
| 工具 | 说明 |
|
|
118
118
|
|---|---|
|
|
119
|
-
| `product_category_info` |
|
|
120
|
-
| `product_creator_analysis` |
|
|
121
|
-
| `product_detail_info` |
|
|
122
|
-
| `product_investment` |
|
|
123
|
-
| `product_overview` |
|
|
124
|
-
| `product_rank_new_listed` |
|
|
125
|
-
| `product_rank_top_selling` |
|
|
126
|
-
| `product_review_list` |
|
|
127
|
-
| `product_sales_trend` |
|
|
128
|
-
| `product_search` |
|
|
129
|
-
| `product_sku` |
|
|
130
|
-
| `product_video_list` |
|
|
131
|
-
|
|
132
|
-
###
|
|
133
|
-
|
|
134
|
-
|
|
|
119
|
+
| `product_category_info` | 获取 TikTok Shop 商品类目树和层级。 |
|
|
120
|
+
| `product_creator_analysis` | 分析带货该商品的达人及其贡献。 |
|
|
121
|
+
| `product_detail_info` | 获取商品、店铺、价格、评分、物流、图片和广告信息。 |
|
|
122
|
+
| `product_investment` | 分析商品广告花费、ROAS、广告 GMV 和付费流量趋势。 |
|
|
123
|
+
| `product_overview` | 分析商品渠道、生命周期、增长势头及自然和广告流量结构。 |
|
|
124
|
+
| `product_rank_new_listed` | 查找近 30 天上架的热门新品。 |
|
|
125
|
+
| `product_rank_top_selling` | 获取畅销商品排行并比较销量增长。 |
|
|
126
|
+
| `product_review_list` | 查询商品评价和买家反馈。 |
|
|
127
|
+
| `product_sales_trend` | 跟踪商品 GMV 和销量趋势。 |
|
|
128
|
+
| `product_search` | 按名称、关键词、价格、类目或市场线索搜索商品。 |
|
|
129
|
+
| `product_sku` | 分析 SKU 销售占比、库存占比和健康度。 |
|
|
130
|
+
| `product_video_list` | 查询带货该商品的视频，并比较付费和自然流量。 |
|
|
131
|
+
|
|
132
|
+
### 店铺工具
|
|
133
|
+
|
|
134
|
+
| 工具 | 说明 |
|
|
135
135
|
|---|---|
|
|
136
|
-
| `shop_base_info` |
|
|
137
|
-
| `shop_creator_analysis` |
|
|
138
|
-
| `shop_data_trends` |
|
|
139
|
-
| `shop_investment_analysis` |
|
|
140
|
-
| `shop_live_analysis` |
|
|
141
|
-
| `shop_product_analysis` |
|
|
142
|
-
| `shop_rank_top_selling` |
|
|
143
|
-
| `shop_sale_analysis` |
|
|
144
|
-
| `shop_search` |
|
|
145
|
-
| `shop_video_analysis` |
|
|
146
|
-
|
|
147
|
-
###
|
|
148
|
-
|
|
149
|
-
|
|
|
136
|
+
| `shop_base_info` | 查看店铺档案、评分、累计销售、排名和经营规模。 |
|
|
137
|
+
| `shop_creator_analysis` | 分析店铺合作达人、达人层级和带货结构。 |
|
|
138
|
+
| `shop_data_trends` | 跟踪店铺 GMV、销量、达人、直播、视频和商品趋势。 |
|
|
139
|
+
| `shop_investment_analysis` | 分析店铺广告花费、ROAS、广告 GMV 和投放素材。 |
|
|
140
|
+
| `shop_live_analysis` | 分析店铺直播表现和单场直播数据。 |
|
|
141
|
+
| `shop_product_analysis` | 分析店铺类目、价格带、商品结构和商品明细。 |
|
|
142
|
+
| `shop_rank_top_selling` | 获取市场或类目下的热销店铺排行。 |
|
|
143
|
+
| `shop_sale_analysis` | 分析店铺来自视频、直播、商品卡、达人和自营渠道的销售。 |
|
|
144
|
+
| `shop_search` | 按店铺名称、关键词或市场搜索店铺。 |
|
|
145
|
+
| `shop_video_analysis` | 分析店铺带货视频、表现和广告状态。 |
|
|
146
|
+
|
|
147
|
+
### 市场洞察工具
|
|
148
|
+
|
|
149
|
+
| 工具 | 说明 |
|
|
150
150
|
|---|---|
|
|
151
|
-
| `market_category_analysis` |
|
|
152
|
-
| `market_category_author_sales_matrix` |
|
|
153
|
-
| `market_category_ranking` |
|
|
151
|
+
| `market_category_analysis` | 分析类目规模、增长、竞争、机会、销售趋势和价格分布。 |
|
|
152
|
+
| `market_category_author_sales_matrix` | 分析不同粉丝层级达人对类目销售的贡献。 |
|
|
153
|
+
| `market_category_ranking` | 获取类目排行并分析增长和集中度。 |
|
|
154
154
|
|
|
155
|
-
###
|
|
155
|
+
### 辅助与知识库工具
|
|
156
156
|
|
|
157
|
-
|
|
|
157
|
+
| 工具 | 说明 |
|
|
158
158
|
|---|---|
|
|
159
|
-
| `fastmoss_detail_url_examples` |
|
|
160
|
-
| `live_detail_analysis` |
|
|
161
|
-
| `live_products_list` |
|
|
162
|
-
| `live_search` |
|
|
163
|
-
| `search_category_by_words` |
|
|
164
|
-
| `search_fastmoss_documents` |
|
|
165
|
-
| `video_data_trends` |
|
|
166
|
-
| `video_detail_analysis` |
|
|
167
|
-
| `video_script_info` |
|
|
168
|
-
| `video_search` |
|
|
169
|
-
|
|
159
|
+
| `fastmoss_detail_url_examples` | 获取商品、达人、店铺、视频和直播的 FastMoss 详情页链接模板。 |
|
|
160
|
+
| `live_detail_analysis` | 分析单场直播、主播、表现和类目结构。 |
|
|
161
|
+
| `live_products_list` | 查询一场直播售卖的商品及其 GMV 和销量。 |
|
|
162
|
+
| `live_search` | 按标题、主播或店铺搜索直播场次。 |
|
|
163
|
+
| `search_category_by_words` | 将自然语言商品词匹配到 TikTok Shop 类目。 |
|
|
164
|
+
| `search_fastmoss_documents` | 搜索 FastMoss 文档、规则、功能和运营指引。 |
|
|
165
|
+
| `video_data_trends` | 跟踪视频播放、点赞、评论和分享趋势。 |
|
|
166
|
+
| `video_detail_analysis` | 分析视频基础信息、播放、互动、IPM 和关联商品。 |
|
|
167
|
+
| `video_script_info` | 获取视频字幕或口播文案。 |
|
|
168
|
+
| `video_search` | 按关键词、标题或达人搜索视频。 |
|
|
170
169
|
|
|
171
170
|
这个包只负责 CLI。需要让 Agent 知道如何、何时调用 CLI 时，请单独安装 `@fastmoss/skill`。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fastmoss/cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.16",
|
|
4
4
|
"description": "FastMoss CLI for npm and npx",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"fastmoss",
|
|
@@ -29,11 +29,11 @@
|
|
|
29
29
|
"test": "node --test ./test/*.test.js"
|
|
30
30
|
},
|
|
31
31
|
"optionalDependencies": {
|
|
32
|
-
"@fastmoss/cli-darwin-amd64": "0.1.
|
|
33
|
-
"@fastmoss/cli-darwin-arm64": "0.1.
|
|
34
|
-
"@fastmoss/cli-linux-amd64": "0.1.
|
|
35
|
-
"@fastmoss/cli-linux-arm64": "0.1.
|
|
36
|
-
"@fastmoss/cli-windows-amd64": "0.1.
|
|
32
|
+
"@fastmoss/cli-darwin-amd64": "0.1.16",
|
|
33
|
+
"@fastmoss/cli-darwin-arm64": "0.1.16",
|
|
34
|
+
"@fastmoss/cli-linux-amd64": "0.1.16",
|
|
35
|
+
"@fastmoss/cli-linux-arm64": "0.1.16",
|
|
36
|
+
"@fastmoss/cli-windows-amd64": "0.1.16"
|
|
37
37
|
},
|
|
38
38
|
"engines": {
|
|
39
39
|
"node": ">=18"
|