@fastmoss/cli

English

@fastmoss/cli 只安装 fastmoss 命令。npm 包会解析精确同版本的平台包，安装时和运行时都不会下载二进制文件。

安装

CLI 与 Agent Skill 相互独立，安装其中一个不会自动安装另一个。

npm

只安装 CLI：

npm install -g @fastmoss/cli@latest

不做全局安装，临时运行 CLI：

npx -y @fastmoss/cli@latest

只安装或更新 Agent Skill：

npx -y @fastmoss/skill@latest

Skill 命令全程非交互，可以直接发送到 Agent 聊天框由 Agent 执行。默认会把 fastmoss-cli 安装到 Codex、Claude 和通用 Agents 三个目录，并输出实际 SKILL.md 路径和当前会话加载提示。

指定 Agent 或卸载：

npx -y @fastmoss/skill@latest --agent codex
npx -y @fastmoss/skill@latest --agent claude
npx -y @fastmoss/skill@latest --agent agents
npx -y @fastmoss/skill@latest --agent all
npx -y @fastmoss/skill@latest uninstall --agent all

设置 FASTMOSS_SKILL_DIR 后只安装到一个自定义 skills 根目录。npm 安装只使用用户配置的 npm registry，不会从 GitHub 下载文件。

GitHub clone

git clone --depth 1 https://github.com/FastMoss/cli.git
cd cli
./install.sh --cli
./install.sh --skill
./install.sh --all

Windows PowerShell：

git clone --depth 1 https://github.com/FastMoss/cli.git
cd cli
.\install.ps1 -Cli
.\install.ps1 -Skill
.\install.ps1 -All

--all 和 -All 只是依次执行两个独立安装动作。clone 或下载 GitHub Release 离线包后，安装过程只读取本地文件，不调用 npm，也不继续下载其他文件。

使用

fastmoss --version
fastmoss help
fastmoss login
fastmoss tools
fastmoss call --tool <tool_name> --args '<json>' --output mcp

fastmoss login 会在真实终端中关闭回显并安全读取 API Key。旧的 fastmoss login --api-key <value> 仍兼容已有的可信自动化脚本，但不建议用于人工交互登录。

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。