@fastmoss/cli 0.1.4 → 0.1.6

package/skills/fastmoss-cli/references/tools-creator.md

@@ -0,0 +1,197 @@
+# Creator Tools
+
+> Creator tools for creator search, profile checks, ecommerce performance, audience fit, trends, videos, and partnership evaluation.
+
+## Tool summary
+
+| Tool | Description |
+|---|---|
+| creator_cargo_summary | Use when the user wants a creator video-vs-live selling split and main promoted categories. |
+| creator_data_trends | Use when the user asks about creator follower, engagement, or commerce trends. Select field_type; returns daily serie... |
+| creator_fans_distribution | Use when the user wants to check whether a creator audience matches a target market. Returns age, gender, location, a... |
+| creator_product_list | Use when the user wants a creator showcase product list. Returns product GMV, units sold, category, price, commission... |
+| creator_profile_overview | Use when the user wants a creator snapshot or partnership check. Returns profile and performance_overview; GMV/rankin... |
+| creator_rank_top_ecommerce | Use when the user wants top ecommerce creators. Returns creator and ranking_metrics; date_value is returned as YYYY-W... |
+| creator_rank_top_growth | Use when the user wants fast-growing creators. Returns creator and growth_metrics; date_value is returned as YYYY-Www... |
+| creator_rank_top_potential | Use when the user wants creators with ecommerce potential. Returns creator, potential_metrics, and audience_summary;... |
+| creator_search | Use when the user has no UID and provides a nickname, keyword, niche, or region. Returns creator, commerce_summary, a... |
+| creator_video_analysis | Use when the user wants creator content direction, tags, and selling videos. Returns video_tag_summary and video_list... |
+
+## Tool details
+
+### creator_cargo_summary
+
+Use when the user wants a creator video-vs-live selling split and main promoted categories.
+
+Example:
+
+```bash
+fastmoss call --tool creator_cargo_summary --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### creator_data_trends
+
+Use when the user asks about creator follower, engagement, or commerce trends. Select field_type; returns daily series and period totals.
+
+Example:
+
+```bash
+fastmoss call --tool creator_data_trends --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### creator_fans_distribution
+
+Use when the user wants to check whether a creator audience matches a target market. Returns age, gender, location, and top segments.
+
+Example:
+
+```bash
+fastmoss call --tool creator_fans_distribution --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### creator_product_list
+
+Use when the user wants a creator showcase product list. Returns product GMV, units sold, category, price, commission, shop info, and time_range_days.
+
+Example:
+
+```bash
+fastmoss call --tool creator_product_list --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+| orderby | array | no | Sort options. Only the first sort rule takes effect. Fields: units_sold, gmv, commission_rate_percent. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### creator_profile_overview
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool creator_profile_overview --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### creator_rank_top_ecommerce
+
+Use when the user wants top ecommerce creators. Returns creator and ranking_metrics; date_value is returned as YYYY-Www for weekly rankings.
+
+Example:
+
+```bash
+fastmoss call --tool creator_rank_top_ecommerce --args '{"filter":{},"orderby":[],"page":1}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### creator_rank_top_growth
+
+Use when the user wants fast-growing creators. Returns creator and growth_metrics; date_value is returned as YYYY-Www for weekly rankings.
+
+Example:
+
+```bash
+fastmoss call --tool creator_rank_top_growth --args '{"filter":{},"orderby":[],"page":1}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### creator_rank_top_potential
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool creator_rank_top_potential --args '{"filter":{},"orderby":[],"page":1}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### creator_search
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool creator_search --args '{"filter":{},"keywords":"value","orderby":[]}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| keywords | string | no | Search keywords: product, shop, creator, video, live, or category terms. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### creator_video_analysis
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool creator_video_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+

package/skills/fastmoss-cli/references/tools-market.md

@@ -0,0 +1,69 @@
+# Market Insight Tools
+
+> Market insight tools for category size, growth, competition, rankings, opportunities, and creator sales matrix analysis.
+
+## Tool summary
+
+| Tool | Description |
+|---|---|
+| market_category_analysis | Use when the user wants category size, growth, competition, or opportunity. analysis_type basic_metrics returns categ... |
+| market_category_author_sales_matrix | Use when the user wants category sales contribution by creator follower_tier. Returns creator_count, category_gmv, gm... |
+| market_category_ranking | Use when the user wants category ranking, growth, or concentration. Returns ranking_scope and ranked_categories; no c... |
+
+## Tool details
+
+### market_category_analysis
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool market_category_analysis --args '{"filter":{},"analysis_type":"basic_metrics"}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| analysis_type | string | yes | Analysis type parameter. |
+| filter | object | yes | Filter parameters. |
+| lang | string | no | Language. Default EN_US, optional ZH_CN. |
+
+### market_category_author_sales_matrix
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool market_category_author_sales_matrix --args '{"filter":{},"lang":"value"}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| lang | string | no | Language. Default EN_US, optional ZH_CN. |
+
+### market_category_ranking
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool market_category_ranking --args '{"filter":{},"lang":"value","orderby":[]}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| lang | string | no | Language. Default EN_US, optional ZH_CN. |
+| orderby | array | no | Sort options. Only the first sort rule takes effect. Use ranking fields such as category_units_sold. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+

package/skills/fastmoss-cli/references/tools-product.md

@@ -0,0 +1,230 @@
+# Product Tools
+
+> Product tools for product search, details, sales trends, creator mix, videos, SKUs, reviews, and ad investment analysis.
+
+## Tool summary
+
+| Tool | Description |
+|---|---|
+| product_category_info | Use when the user needs the product category tree or category levels. Prefer search_category_by_words for natural-lan... |
+| product_creator_analysis | Use when the user wants who sells a product or the creator structure. Returns creator_summary with follower_tier_dist... |
+| product_detail_info | Use when the user wants product basics, shop, price, rating, logistics, images, or ad status. Returns product and sho... |
+| product_investment | Use when the user asks about product ads, spend, ROAS, or daily paid-traffic changes. Returns ad_performance_summary... |
+| product_overview | Use when the user wants product channel attribution, lifecycle/momentum, or ad-vs-organic structure. Returns period_s... |
+| product_rank_new_listed | Use when the user wants recently listed hot products. Returns FastMoss new-product ranking, first_3d_gmv/units_sold,... |
+| product_rank_top_selling | Use when the user wants bestsellers or top products. Returns period_gmv/units_sold, total_gmv/units_sold, and units_s... |
+| product_review_list | Use when the user wants product reviews or buyer feedback. Returns review list and count; supports time_range_days an... |
+| product_sales_trend | Use when the user wants a product GMV/units trend or traction check. Returns period_summary and daily_trend with peri... |
+| product_search | Use when the user has no product_id and provides a name, keyword, price band, category, bestseller clue, or new-produ... |
+| product_sku | Use when the user wants SKU sales share, inventory share, or SKU health. Returns SKU-level sales and inventory shares. |
+| product_video_list | Use when the user wants videos selling a product, high-play videos, or paid-vs-organic video traffic. Filter with is_... |
+
+## Tool details
+
+### product_category_info
+
+Use when the user needs the product category tree or category levels. Prefer search_category_by_words for natural-language category terms.
+
+Example:
+
+```bash
+fastmoss call --tool product_category_info --args '{}' --output mcp
+```
+
+Parameters: none documented.
+
+### product_creator_analysis
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_creator_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### product_detail_info
+
+Use when the user wants product basics, shop, price, rating, logistics, images, or ad status. Returns product and shop; detail_url points to TikTok.
+
+Example:
+
+```bash
+fastmoss call --tool product_detail_info --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### product_investment
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_investment --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### product_overview
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_overview --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### product_rank_new_listed
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_rank_new_listed --args '{"filter":{},"orderby":[],"page":1}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### product_rank_top_selling
+
+Use when the user wants bestsellers or top products. Returns period_gmv/units_sold, total_gmv/units_sold, and units_sold_growth_rate_percent.
+
+Example:
+
+```bash
+fastmoss call --tool product_rank_top_selling --args '{"filter":{},"orderby":[],"page":1}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### product_review_list
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_review_list --args '{"filter":{},"orderby":[],"page":1}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### product_sales_trend
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_sales_trend --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+
+### product_search
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_search --args '{"filter":{},"keywords":"value","orderby":[]}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| keywords | string | no | Search keywords: product, shop, creator, video, live, or category terms. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### product_sku
+
+Use when the user wants SKU sales share, inventory share, or SKU health. Returns SKU-level sales and inventory shares.
+
+Example:
+
+```bash
+fastmoss call --tool product_sku --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### product_video_list
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool product_video_list --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+

package/skills/fastmoss-cli/references/tools-shop.md

@@ -0,0 +1,200 @@
+# Shop Tools
+
+> Shop tools for shop search, profile checks, sales, products, creators, livestreams, short videos, and ad investment analysis.
+
+## Tool summary
+
+| Tool | Description |
+|---|---|
+| shop_base_info | Use when the user wants a shop snapshot, store type, rating, or profile. Returns cumulative GMV/units, ranks, age, pr... |
+| shop_creator_analysis | Use when the user wants shop collaborators, creator tiers, or video-vs-live selling structure. Returns creator list a... |
+| shop_data_trends | Use when the user wants recent shop GMV, units, creator, live, video, or active-product trends. Returns daily trends. |
+| shop_investment_analysis | Use when the user asks about shop ads, spend, ROAS, ad GMV, or promoted assets. Returns ad estimates and daily changes. |
+| shop_live_analysis | Use when the user wants shop live performance, shop-live vs affiliate-live structure, or live sessions. |
+| shop_product_analysis | Use when the user wants shop categories, price bands, product mix, or product details. Returns distributions and prod... |
+| shop_rank_top_selling | Use when the user wants top shops in a market or category. Returns shop ranking and ecommerce metrics. |
+| shop_sale_analysis | Use when the user wants shop sales by short video, live, product card, creator, or self-operated channels. Returns ch... |
+| shop_search | Use when the user has no seller_id and provides a shop name, keyword, or region. Returns matching shops. |
+| shop_video_analysis | Use when the user wants shop selling videos, video performance, or ad status. |
+
+## Tool details
+
+### shop_base_info
+
+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.
+
+Example:
+
+```bash
+fastmoss call --tool shop_base_info --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### shop_creator_analysis
+
+Use when the user wants shop collaborators, creator tiers, or video-vs-live selling structure. Returns creator list and distributions.
+
+Example:
+
+```bash
+fastmoss call --tool shop_creator_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### shop_data_trends
+
+Use when the user wants recent shop GMV, units, creator, live, video, or active-product trends. Returns daily trends.
+
+Example:
+
+```bash
+fastmoss call --tool shop_data_trends --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### shop_investment_analysis
+
+Use when the user asks about shop ads, spend, ROAS, ad GMV, or promoted assets. Returns ad estimates and daily changes.
+
+Example:
+
+```bash
+fastmoss call --tool shop_investment_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### shop_live_analysis
+
+Use when the user wants shop live performance, shop-live vs affiliate-live structure, or live sessions.
+
+Example:
+
+```bash
+fastmoss call --tool shop_live_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### shop_product_analysis
+
+Use when the user wants shop categories, price bands, product mix, or product details. Returns distributions and product list.
+
+Example:
+
+```bash
+fastmoss call --tool shop_product_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### shop_rank_top_selling
+
+Use when the user wants top shops in a market or category. Returns shop ranking and ecommerce metrics.
+
+Example:
+
+```bash
+fastmoss call --tool shop_rank_top_selling --args '{"filter":{},"orderby":[],"page":1}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### shop_sale_analysis
+
+Use when the user wants shop sales by short video, live, product card, creator, or self-operated channels. Returns channel_distribution and content_distribution.
+
+Example:
+
+```bash
+fastmoss call --tool shop_sale_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+
+### shop_search
+
+Use when the user has no seller_id and provides a shop name, keyword, or region. Returns matching shops.
+
+Example:
+
+```bash
+fastmoss call --tool shop_search --args '{"filter":{},"keywords":"value","orderby":[]}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | no | Filter parameters. |
+| keywords | string | no | Search keywords: product, shop, creator, video, live, or category terms. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+
+### shop_video_analysis
+
+Use when the user wants shop selling videos, video performance, or ad status.
+
+Example:
+
+```bash
+fastmoss call --tool shop_video_analysis --args '{"filter":{}}' --output mcp
+```
+
+Parameters:
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| filter | object | yes | Filter parameters. |
+| orderby | array | no | Sort options. |
+| page | integer | no | Page number. Default 1, max 10. |
+| pagesize | integer | no | Page size. Default 10, max 10. |
+