Fastmoss Rpa Skills

FastMoss 数据抓取技能（统一版）

**一个命令，搞定 7 大榜单的 TikTok 小店数据抓取、筛选、分析与品类大盘。**

---

这是什么？

[FastMoss](https://www.fastmoss.com) 是一个看 **TikTok 电商（TikTok Shop）** 数据的网站。 这个技能让你用一行命令，把网站上 7 大榜单的数据**自动抓下来存成表格（CSV）**，还能顺便**生成一份带洞察的分析报告（Markdown）**。

以前这是 7 个分开的技能，现在合并成 **1 个**，命令统一、好记、好维护。

Browser-RPA + 数据分析工具集，覆盖 [fastmoss.com](https://www.fastmoss.com) (TikTok Shop 数据分析平台) 全部 7 个核心模块。基于 [BrowserSkill](https://github.com/Tencent/BrowserSkill) 驱动用户真实浏览器（复用登录态），把 FastMoss 的榜单/趋势/市场数据落成 CSV，并自动生成 Markdown 分析报告。

---

项目特点

• 真实浏览器复用登录态 — 通过 BrowserSkill 驱动用户已经登录的 Chrome/Edge，无需扫码、无需 token、无需 captcha 破解。
• 7 个 FastMoss 模块全覆盖 — 商品/达人/店铺/直播/视频&素材/广告引擎/品类大盘，每个模块独立 skill，互不干扰。
• CSV + Markdown 双输出 — 原始数据进 data/，聚合报告生成到 analysis.md 或自定义路径，Excel 友好（UTF-8 BOM）。
• Schema 自动适配 — 6 个 DOM-scraping skill 动态读取 ，无论 FastMoss 改字段都不需要改代码。
• API-first 优先 — fastmoss-market 是 API skill，直接调用 FastMoss JSON 接口（通过页面上下文 fetch()），无分页、无 SPA 等待、无 selector 维护。
• 多市场对比内置 — 所有 ranking skill 都支持 --country 美国,印度尼西亚,泰国,马来西亚 一键多市场抓取并自动切分。

它能抓什么？（7 大榜单）

榜单 (--section)	能看什么（子榜单）	举个栗子
products 商品榜	新品 / 销量 / 热推商品	美国最近上新的爆品
creators 达人榜	涨粉 / 带货 / 蓝V / 热门 / 黑马	印尼涨粉最快的带货号
shops 店铺榜	销量 / 热推店铺	泰国销量 Top 店铺
ads 广告趋势	标签 / 关键词 / 品类	某品类正在投的广告关键词
creatives 素材榜	视频 / 音乐 / 标签	近期跑量的视频素材
livestreams 直播榜	TT 直播 / 直播爆品 / 直播带货达人	直播带货 Top 达人
market 品类大盘	行业格局 / 市场总览 / 日销趋势	美妆行业各国分布

---

开始之前（只需做一次）

1. 安装好 BrowserSkill（bsk） 并装好浏览器插件。
2. 用 Chrome / Edge 登录 fastmoss.com（数据是靠你自己的登录态抓的，所以必须登录）。
3. 命令行执行 bsk status，看到下面这行、且数字 ≥ 1 就 OK：

   browsers connected: 1

如果看不到 `browsers connected`，先打开浏览器、确认已登录 fastmoss.com，再试一次。

---

怎么用？四条命令

所有命令都在技能的 `scripts/` 目录里运行（下文用 `python` 指代运行环境）。 把 `` 换成你想存文件的路径即可，父文件夹会自动创建。

① 抓取 `scrape` —— 把榜单数据存成 CSV

# 抓商品榜（前 5 页），商品榜不需要写 --ranking
python fastmoss_rpa.py scrape --section products --pages 5 --out out/prod