SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场fastmoss-rpa

fastmoss-rpa

数据与分析

查看项目

更新于 10-29 12:16

技能介绍

用途

fastmoss-rpa 是一个统一版 FastMoss（fastmoss.com）TikTok Shop RPA 技能，覆盖七个榜单：products（商品榜）、creators（达人榜）、shops（店铺榜）、ads（广告榜）、creatives（创意榜）、livestreams（直播榜）和 market（市场 API）。它把此前七个姊妹技能合并为单一入口，旧目录保留作备份。

主要能力

  • scrape：抓取单个榜单，支持指定页数，输出 CSV。products 为固定结构、单页；其余榜单需指定 --ranking（如 creators 的 fans、commerceTop、blue-v、popular、potentialTop 等）。
  • filter：按筛选维度抓取。products 每次运行支持 country / category / shop_type 之一，按标签分别输出 CSV 并合并；动态榜单支持 --country，creators 还支持 --time（如周榜）。
  • analyze：将多个 CSV 汇总生成多维 Markdown 报告，按 --section 分派到七种报告引擎，也可用 --filtered 合并多筛选 CSV。
  • market：调用 FastMoss JSON API，支持类目分布（distribution）、市场概览（base）、每日销售时序（sales-chart）及筛选词表导出（filter-info）。

使用方式

前提：已安装并连接 BrowserSkill（bsk），Chrome/Edge 中装有 BrowserSkill 扩展，且已登录 fastmoss.com，用 bsk status 确认 browsers connected: N（N ≥ 1）。无本地 HTTP 守护进程，由 bsk 驱动真实浏览器复用登录会话（cookies + origin），这也是 market API 调用可用的原因。

命令均在技能 scripts/ 目录下运行（或将该目录加入 PYTHONPATH），示例：

python fastmoss_rpa.py scrape --section products --pages 5 --out <out>/products.csv
python fastmoss_rpa.py filter --section creators --ranking fans --country 美国,印度尼西亚,泰国,马来西亚 --pages 3 --out <out>/fans_by_country.csv
python fastmoss_rpa.py analyze creators --fans <out>/fans.csv --commerce <out>/commerce.csv --blue-v <out>/blue-v.csv --popular <out>/popular.csv --horse <out>/horse.csv --out-md <report>/creators_report.md
python fastmoss_rpa.py market distribution --region US,ID,TH,MY --time month --out <out>/categories_by_region.csv

架构：fastmoss_rpa.py 为 CLI（scrape / filter / analyze / market），core.py 为通用分页引擎（固定 + 动态解析模式），market_api.py 负责 JSON API 抓取，analyze.py 含七个报告引擎，sections.py 存放 URL、解析器、字段与筛选维度配置，bridge_browserskill.py 负责传输调用。references/ 下有 API 契约说明与七份报告模板。

适用场景

适合需要批量采集 TikTok Shop 榜单数据（商品、达人、店铺、广告、创意、直播）并按国家、类目、时间等维度对比分析的用户，以及需要基于 FastMoss 类目分布 API 做多地区市场分析并产出 Markdown 报告的场景。

限制与注意事项

  • 依赖 BrowserSkill 与已登录会话；启动前需确认浏览器连接正常。
  • 不要通过 @e 快照引用点击，导航后会失效；内置点击使用文本标签的 evaluate JS。
  • Bash heredoc 与 JS 正则组合会因反斜杠层被吞掉而出错，优先用 .split('\n')。
  • SPA 水合延迟：导航后至少等 5 秒，页间至少 3.5 秒，过快会导致 0 行（可用 --nav-sleep / --page-sleep 调整）。
  • Windows 上用 encoding='utf-8-sig' 读取生成的 CSV。
  • 第一页顶部可能有空占位行，解析器会丢弃 key 字段为空的行。
  • 国家标签使用中文词汇（共 16 个市场），market 使用 region 代码（US ID GB VN TH MY PH ES MX DE FR IT BR JP SG SA）。
  • 具体运行环境与 shell 细节见 references/environment.md；CSV 字段与 API 字段见文档说明。
  • 关于收费、价格、平台支持范围等未在资料中提供的信息，暂未提供。