@fastmoss/cli 0.1.13 → 0.1.16

package/README.md

@@ -76,4 +76,95 @@ fastmoss tools
 fastmoss call --tool <tool_name> --args '<json>' --output mcp
 ```
 
+## CLI Tool Catalog
+
+### Advertising Tools
+
+| Tool | Description |
+|---|---|
+| `ad_data_overview` | View a video's ad spend, ROAS, reach, engagement, followers, and commerce performance over time. |
+| `ad_search` | Find active ads by market, category, landing page, spend, ROAS, reach, or run duration. |
+
+### Agency Tools
+
+| Tool | Description |
+|---|---|
+| `agency_creator_analysis` | Analyze an agency's creator mix, follower tiers, and collaborators. |
+| `agency_product_analysis` | Analyze an agency's promoted product categories and price bands. |
+| `agency_product_list` | List products promoted by an agency with category, price, period, and ranking filters. |
+| `agency_profile_overview` | View an agency profile and recent 7/28/90-day performance. |
+| `agency_rank_top` | Rank leading MCN agencies by weekly or monthly performance. |
+| `agency_search` | Find agencies by name or market clue. |
+| `agency_shop_analysis` | Analyze an agency's collaborating shops and their performance. |
+
+### Creator Tools
+
+| Tool | Description |
+|---|---|
+| `creator_cargo_summary` | Compare a creator's video and live selling mix and promoted categories. |
+| `creator_data_trends` | Track creator follower, engagement, and commerce trends. |
+| `creator_fans_distribution` | Analyze a creator audience by age, gender, location, and segments. |
+| `creator_product_list` | List products promoted by a creator with GMV, sales, price, commission, and shop data. |
+| `creator_profile_overview` | View a creator profile and historical performance snapshot. |
+| `creator_rank_top_ecommerce` | Rank top ecommerce creators. |
+| `creator_rank_top_growth` | Rank fast-growing creators. |
+| `creator_rank_top_potential` | Find creators with ecommerce potential. |
+| `creator_search` | Find creators by nickname, keyword, niche, or market. |
+| `creator_video_analysis` | Analyze creator content direction, tags, videos, and linked products. |
+
+### Product Tools
+
+| Tool | Description |
+|---|---|
+| `product_category_info` | Get the TikTok Shop product category tree and hierarchy. |
+| `product_creator_analysis` | Analyze creators who promote a product and their contribution. |
+| `product_detail_info` | Get product, shop, price, rating, logistics, image, and ad details. |
+| `product_investment` | Analyze a product's ad spend, ROAS, ad GMV, and paid-traffic trends. |
+| `product_overview` | Analyze product channels, lifecycle, momentum, and organic versus ad mix. |
+| `product_rank_new_listed` | Find popular products listed within the last 30 days. |
+| `product_rank_top_selling` | Rank bestselling products and compare sales growth. |
+| `product_review_list` | Get product reviews and buyer feedback. |
+| `product_sales_trend` | Track product GMV and unit-sales trends. |
+| `product_search` | Find products by name, keyword, price, category, or market signal. |
+| `product_sku` | Analyze SKU sales share, inventory share, and SKU health. |
+| `product_video_list` | Find videos selling a product and compare paid versus organic traffic. |
+
+### Shop Tools
+
+| Tool | Description |
+|---|---|
+| `shop_base_info` | View a shop profile, ratings, cumulative sales, ranks, and operating scale. |
+| `shop_creator_analysis` | Analyze shop collaborators, creator tiers, and selling structure. |
+| `shop_data_trends` | Track shop GMV, sales, creator, live, video, and product trends. |
+| `shop_investment_analysis` | Analyze shop advertising spend, ROAS, ad GMV, and promoted assets. |
+| `shop_live_analysis` | Analyze shop live performance and individual live sessions. |
+| `shop_product_analysis` | Analyze shop categories, price bands, product mix, and products. |
+| `shop_rank_top_selling` | Rank top-selling shops by market or category. |
+| `shop_sale_analysis` | Analyze shop sales by video, live, product card, creator, and self-operated channels. |
+| `shop_search` | Find shops by name, keyword, or market. |
+| `shop_video_analysis` | Analyze shop selling videos, performance, and ad status. |
+
+### Market Insight Tools
+
+| Tool | Description |
+|---|---|
+| `market_category_analysis` | Analyze category size, growth, competition, opportunity, sales trends, and price distribution. |
+| `market_category_author_sales_matrix` | Analyze category sales contribution by creator follower tier. |
+| `market_category_ranking` | Rank categories and analyze growth and concentration. |
+
+### Auxiliary and Knowledge Base Tools
+
+| Tool | Description |
+|---|---|
+| `fastmoss_detail_url_examples` | Get FastMoss detail-page URL templates for products, creators, shops, videos, and lives. |
+| `live_detail_analysis` | Analyze a live session, creator, performance, and category breakdown. |
+| `live_products_list` | List products sold in a live session and their GMV and unit sales. |
+| `live_search` | Find live sessions by title, host, or shop. |
+| `search_category_by_words` | Match a natural-language product term to TikTok Shop categories. |
+| `search_fastmoss_documents` | Search FastMoss documentation, rules, features, and operational guidance. |
+| `video_data_trends` | Track a video's plays, likes, comments, and shares over time. |
+| `video_detail_analysis` | Analyze a video's basics, reach, engagement, IPM, and linked products. |
+| `video_script_info` | Get video subtitles or spoken-script text. |
+| `video_search` | Find videos by keyword, title, or creator. |
+
 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

@@ -76,4 +76,95 @@ fastmoss tools
 fastmoss call --tool <tool_name> --args '<json>' --output mcp
 ```
 
+## CLI 工具列表
+
+### 广告工具
+
+| 工具 | 说明 |
+|---|---|
+| `ad_data_overview` | 查看指定视频在一段时间内的广告花费、ROAS、播放、互动、涨粉和电商表现。 |
+| `ad_search` | 按市场、类目、落地页、花费、ROAS、播放量或投放时长筛选活跃广告。 |
+
+### MCN 机构工具
+
+| 工具 | 说明 |
+|---|---|
+| `agency_creator_analysis` | 分析 MCN 的达人结构、粉丝层级和合作达人。 |
+| `agency_product_analysis` | 分析 MCN 推广商品的类目结构和价格带。 |
+| `agency_product_list` | 查询 MCN 推广的商品，可按类目、价格、周期和排序筛选。 |
+| `agency_profile_overview` | 查看 MCN 档案及近 7/28/90 天业绩概览。 |
+| `agency_rank_top` | 获取按周或按月排行的头部 MCN 机构。 |
+| `agency_search` | 通过机构名称或市场线索搜索 MCN。 |
+| `agency_shop_analysis` | 分析 MCN 合作店铺及其经营表现。 |
+
+### 达人工具
+
+| 工具 | 说明 |
+|---|---|
+| `creator_cargo_summary` | 对比达人短视频和直播带货结构及主推类目。 |
+| `creator_data_trends` | 跟踪达人的粉丝、互动和电商数据趋势。 |
+| `creator_fans_distribution` | 按年龄、性别、地区和人群标签分析达人受众。 |
+| `creator_product_list` | 查询达人带货商品及 GMV、销量、价格、佣金和店铺信息。 |
+| `creator_profile_overview` | 查看达人档案与历史业绩快照。 |
+| `creator_rank_top_ecommerce` | 获取头部电商达人排行。 |
+| `creator_rank_top_growth` | 获取增长最快的达人排行。 |
+| `creator_rank_top_potential` | 寻找具有电商潜力的达人。 |
+| `creator_search` | 按昵称、关键词、赛道或市场搜索达人。 |
+| `creator_video_analysis` | 分析达人的内容方向、标签、带货视频及关联商品。 |
+
+### 商品工具
+
+| 工具 | 说明 |
+|---|---|
+| `product_category_info` | 获取 TikTok Shop 商品类目树和层级。 |
+| `product_creator_analysis` | 分析带货该商品的达人及其贡献。 |
+| `product_detail_info` | 获取商品、店铺、价格、评分、物流、图片和广告信息。 |
+| `product_investment` | 分析商品广告花费、ROAS、广告 GMV 和付费流量趋势。 |
+| `product_overview` | 分析商品渠道、生命周期、增长势头及自然和广告流量结构。 |
+| `product_rank_new_listed` | 查找近 30 天上架的热门新品。 |
+| `product_rank_top_selling` | 获取畅销商品排行并比较销量增长。 |
+| `product_review_list` | 查询商品评价和买家反馈。 |
+| `product_sales_trend` | 跟踪商品 GMV 和销量趋势。 |
+| `product_search` | 按名称、关键词、价格、类目或市场线索搜索商品。 |
+| `product_sku` | 分析 SKU 销售占比、库存占比和健康度。 |
+| `product_video_list` | 查询带货该商品的视频，并比较付费和自然流量。 |
+
+### 店铺工具
+
+| 工具 | 说明 |
+|---|---|
+| `shop_base_info` | 查看店铺档案、评分、累计销售、排名和经营规模。 |
+| `shop_creator_analysis` | 分析店铺合作达人、达人层级和带货结构。 |
+| `shop_data_trends` | 跟踪店铺 GMV、销量、达人、直播、视频和商品趋势。 |
+| `shop_investment_analysis` | 分析店铺广告花费、ROAS、广告 GMV 和投放素材。 |
+| `shop_live_analysis` | 分析店铺直播表现和单场直播数据。 |
+| `shop_product_analysis` | 分析店铺类目、价格带、商品结构和商品明细。 |
+| `shop_rank_top_selling` | 获取市场或类目下的热销店铺排行。 |
+| `shop_sale_analysis` | 分析店铺来自视频、直播、商品卡、达人和自营渠道的销售。 |
+| `shop_search` | 按店铺名称、关键词或市场搜索店铺。 |
+| `shop_video_analysis` | 分析店铺带货视频、表现和广告状态。 |
+
+### 市场洞察工具
+
+| 工具 | 说明 |
+|---|---|
+| `market_category_analysis` | 分析类目规模、增长、竞争、机会、销售趋势和价格分布。 |
+| `market_category_author_sales_matrix` | 分析不同粉丝层级达人对类目销售的贡献。 |
+| `market_category_ranking` | 获取类目排行并分析增长和集中度。 |
+
+### 辅助与知识库工具
+
+| 工具 | 说明 |
+|---|---|
+| `fastmoss_detail_url_examples` | 获取商品、达人、店铺、视频和直播的 FastMoss 详情页链接模板。 |
+| `live_detail_analysis` | 分析单场直播、主播、表现和类目结构。 |
+| `live_products_list` | 查询一场直播售卖的商品及其 GMV 和销量。 |
+| `live_search` | 按标题、主播或店铺搜索直播场次。 |
+| `search_category_by_words` | 将自然语言商品词匹配到 TikTok Shop 类目。 |
+| `search_fastmoss_documents` | 搜索 FastMoss 文档、规则、功能和运营指引。 |
+| `video_data_trends` | 跟踪视频播放、点赞、评论和分享趋势。 |
+| `video_detail_analysis` | 分析视频基础信息、播放、互动、IPM 和关联商品。 |
+| `video_script_info` | 获取视频字幕或口播文案。 |
+| `video_search` | 按关键词、标题或达人搜索视频。 |
+
 这个包只负责 CLI。需要让 Agent 知道如何、何时调用 CLI 时，请单独安装 `@fastmoss/skill`。

package/package.json

@@ -1,7 +1,19 @@
 {
   "name": "@fastmoss/cli",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "description": "FastMoss CLI for npm and npx",
+  "keywords": [
+    "fastmoss",
+    "tiktok-shop",
+    "ecommerce-research",
+    "product-research",
+    "creator-analytics",
+    "shop-analytics",
+    "advertising-analytics",
+    "market-intelligence",
+    "mcp",
+    "ai-agent"
+  ],
   "license": "UNLICENSED",
   "private": false,
   "bin": {
@@ -17,11 +29,11 @@
     "test": "node --test ./test/*.test.js"
   },
   "optionalDependencies": {
-    "@fastmoss/cli-darwin-amd64": "0.1.13",
-    "@fastmoss/cli-darwin-arm64": "0.1.13",
-    "@fastmoss/cli-linux-amd64": "0.1.13",
-    "@fastmoss/cli-linux-arm64": "0.1.13",
-    "@fastmoss/cli-windows-amd64": "0.1.13"
+    "@fastmoss/cli-darwin-amd64": "0.1.16",
+    "@fastmoss/cli-darwin-arm64": "0.1.16",
+    "@fastmoss/cli-linux-amd64": "0.1.16",
+    "@fastmoss/cli-linux-arm64": "0.1.16",
+    "@fastmoss/cli-windows-amd64": "0.1.16"
   },
   "engines": {
     "node": ">=18"