@fastmoss/cli 0.1.3 → 0.1.5

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. |
+

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

@@ -0,0 +1,25 @@
+# FastMoss CLI Tool Catalog
+
+> Generated from the static FastMoss tool list. Use the category files below as the tool catalog for `fastmoss call`.
+
+## How to call tools
+
+```bash
+fastmoss call --tool <tool_name> --args '<json>' --output mcp
+```
+
+Use `fastmoss tools --search <tool_name>` only when the installed CLI and account can access live metadata. The static catalog files below are the packaged fallback and release-time reference.
+
+## Categories
+
+| Category | File | Tools | Use for |
+|---|---|---:|---|
+| Advertising Tools | [Advertising Tools](tools-advertising.md) | 2 | Advertising tools for ad creatives, ad spend, ROAS, engagement, and paid-traffic performance analysis. |
+| Creator Tools | [Creator Tools](tools-creator.md) | 10 | Creator tools for creator search, profile checks, ecommerce performance, audience fit, trends, videos, and partnership evaluation. |
+| 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. |
+| 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. |
+| Market Insight Tools | [Market Insight Tools](tools-market.md) | 3 | Market insight tools for category size, growth, competition, rankings, opportunities, and creator sales matrix analysis. |
+| Auxiliary and Knowledge Base Tools | [Auxiliary and Knowledge Base Tools](tools-auxiliary-knowledge.md) | 10 | Auxiliary and knowledge base tools for category keyword matching, FastMoss documentation, detail-page URL rules, live/video analysis, and tools outside the main business prefixes. |
+
+Read only the category file that matches the user's task before calling a tool.
+