@fastmoss/cli 0.1.6 → 0.1.14

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

@@ -1,197 +0,0 @@
-# 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

@@ -1,69 +0,0 @@
-# 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

@@ -1,230 +0,0 @@
-# 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

@@ -1,200 +0,0 @@
-# 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. |
-