# @fastmoss/cli 中文文档

规范地址：https://npmcn.com/package/%40fastmoss/cli/

版本：1\.1\.0
npm 元数据更新时间：2026-10-15T07:57:29.908Z
中文译文更新时间：2026-11-14T11:30:31.872Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fastmoss/cli
原文对照：https://npmcn.com/package/%40fastmoss/cli/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：20.8 kB，6 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-07-10T09:49:24.991Z
- 最新版本发布：2026-10-15T07:57:29.725Z
- 近 30 天下载量：2883（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

Npm 和 npx 的快摩斯 CLI

## 安装

```sh
npm install @fastmoss/cli
```

也可以使用：`pnpm add @fastmoss/cli`、`yarn add @fastmoss/cli`、`bun add @fastmoss/cli`

## README

# @fastmoss/cli

[English](https://npmcn.com/package/%40fastmoss/cli/README.md)

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

## 安装

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

### npm

只安装 CLI：

```bash
npm install -g @fastmoss/cli@latest
```

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

```bash
npx -y @fastmoss/cli@latest
```

只安装或更新 Agent Skill：

```bash
npx -y @fastmoss/skill@latest
```

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

指定 Agent 或卸载：

```bash
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

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

Windows PowerShell：

```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，也不继续下载其他文件。

## 使用

```bash
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`。

## 常见问题

### @fastmoss/cli 是什么？

Npm 和 npx 的快摩斯 CLI

### 如何安装 @fastmoss/cli？

在项目目录运行 npm install @fastmoss/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fastmoss，可以用 npx fastmoss 直接运行。

### @fastmoss/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fastmoss\_\_cli 是否存在。

### @fastmoss/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fastmoss/cli 可以商用吗？

@fastmoss/cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @fastmoss/cli 的下载量有多少？

根据 npm 官方下载统计，@fastmoss/cli 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,883 次，日均约 96 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fastmoss/cli 还在维护吗？

最新版本 1\.1\.0 发布于 2026/10/15（30 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 19 个；首次发布于 2026/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。